Description

Kiss your maid!

Touhou Maid: Affection

An affection and bond expansion for Touhou Little Maid on Forge 1.20.1.

--- ## Latest Release `1.7.3.0` incorporates high-value player feedback and hardens interaction defaults: - **Controllable gifts**: Random Gift now uses the curated item-tag pool by default. Legacy broad-pool mode excludes only immersion-breaking technical/admin items, and explicit tag entries can override that default policy. - **Dedicated kiss keys**: The conflicting sneak-right-click entry is removed; targeted and carried-maid kiss keys remain available. - **Bilingual AI Morning Kiss**: Display dialogue and generated TTS speech can use different languages, such as Chinese text with Japanese audio. - **Modded health support**: Emergency Rescue can optionally trigger from a percentage of maximum health. - **Clearer unlocking**: The bond UI explains that P Point items must be present in the player inventory and shows blocked-click feedback. Full release history lives in [CHANGELOG.md](CHANGELOG.md). ## Features ### Kiss Interaction Bind the targeted kiss action in Controls and aim at an owned maid to kiss her. Princess-carried maids also have a dedicated kiss action. Kisses grant favorability, play random kiss sounds, spawn heart particles, and use a short close-up camera effect. Repeated kisses can trigger the custom Maid's Prayer effect. Sneak-right-click kissing has been removed so TLM's sit/stand interaction remains untouched. Sound volumes can be tuned in `config/touhou_maid_affection-common.toml`: `cooldown.kissSoundVolume` controls kiss sound events, `morningKissBehavior.voiceVolume` controls Morning Kiss voices, `emergencyRescueBehavior.volume` controls Emergency Rescue voices and fallback sounds, and `voicePreview.volume` controls bond-page voice previews. All four range from `0.0` to `1.0` and only attenuate — `0.0` mutes and `1.0` keeps the original loudness; use Minecraft or system volume for louder playback. When CarryOn is installed, a dedicated keybind supports kissing a princess-carried maid. ### Targeted Kiss Key Controls include a targeted kiss action. When your crosshair points at an owned maid within range, the client sends only the entity id; the server re-checks ownership, distance, line of sight, cooldown, and normal kiss rules before applying the interaction. ### Bond System High-affection maids can become bonded companions. Bond abilities currently include: | Ability | Purpose | |---|---| | Lap Pillow | Rest with your maid using configurable sit/lie poses and optional YSM actions. | | Morning Kiss | Schedule or manually call a morning greeting with kisses, dialogue, and voice playback. | | Emergency Rescue | Let bonded maids contribute daily rescue chances and rescue voice lines. | | Random Gift | Let bonded maids accumulate and deliver small gifts over time. | For modpacks with increased maximum health, enable `emergencyRescueBehavior.usePercentageThreshold=true`; the default 20% value equals the legacy 4-point threshold at vanilla health. Percentage mode remains off by default to preserve existing server configuration behavior. Random Gift uses the curated `touhou_maid_affection:bond_random_gift_pool` item tag by default. Datapacks can extend that tag or add exclusions through `touhou_maid_affection:bond_random_gift_blacklist`; set `bondCosts.randomGiftBehavior.curatedPoolOnly=false` only if you want the legacy broad registry sampling mode. The server remains authoritative for unlocks, costs, distance checks, cooldowns, and ability execution. The client UI is a display and configuration surface. Since `1.7.5.0` the bond page has a **Settings** button in its top-right corner (the slot the old AI Hub button used): the panel opens as a standalone window with four tabs — **Status** (read-only port of `/tma morning_kiss status` plus per-maid cache rows with a clear action), **Features** (feature switches plus the AI cache policy: per-pool target, scan interval, consume-on-use), **Voice** (text/voice language, the editable dialogue prompt) and **Volume** (four sliders). Switches and languages are server-authoritative, so on a dedicated server only operators may change them (everyone else is read-only); the volumes are client-side and apply as soon as you drag them. ### Custom Dialogue And Voices Datapack-driven voice pools use this layout: ```text data/touhou_maid_affection/morning_kiss/profile.json data/touhou_maid_affection/morning_kiss/voices/*.ogg data/touhou_maid_affection/emergency_rescue/profile.json data/touhou_maid_affection/emergency_rescue/voices/*.ogg ``` Morning Kiss datapacks can define static dialogue pools, kiss sound behavior, and OGG voice files. Emergency Rescue datapacks define rescue OGG voice files and a fallback sound event. The voice-pool pages can preview selected voices before saving. See [早安吻相关配置说明.md](早安吻相关配置说明.md) and the ready-to-zip sample pack in [examples/TMA-Custom-Voice-Pack](examples/TMA-Custom-Voice-Pack). ### AI Morning Kiss can optionally use TLM AI sites to pre-generate dialogue and TTS audio. `displayLanguage` controls the text language (data-pack dialogue and generated dialogue) while `voiceLanguage` controls the spoken language (data-pack voices and generated TTS). Both accept an arbitrary locale code rather than a hard-coded Chinese/Japanese pair; `auto` follows the game language for text and the maid's Touhou Little Maid AI language settings for voice. When the two differ, TMA translates the generated lines in one ordered batch before requesting TTS, supporting combinations such as Chinese/Japanese, English/Korean, French/German, or others. These settings live in `config/touhou_maid_affection-common.toml`. Changing the language no longer requires a manual cache clear: cache reads and target checks filter by the current languages, so the cache re-warms for the new language automatically (old-language entries are kept and can be cleared with `/tma morning_kiss clear_ai_cache`); only prompt changes need that command. TMA does not register its own chat/TTS providers: every LLM and TTS request (including Morning Kiss) goes through Touhou Little Maid's own AI sites, so user API keys, models, voices, and enabled state stay managed by Touhou Little Maid. AI **sites** (URL, key, model, voice) stay in Touhou Little Maid's own AI settings — the Voice tab has a single button that opens it — while the Morning Kiss dialogue prompt is editable directly in TMA's panel. ### Compatibility - Touhou Little Maid: required dependency, built against `1.5.2-forge+mc1.20.1`. - Yes Steve Model: optional action playback and action discovery. - CarryOn: optional right-click conflict avoidance. - TLM GUI, AI sites, and sound packs: soft integration where available, silent fallback where absent. ## Installation 1. Install Minecraft `1.20.1` with Forge `47.4.x`. 2. Install Touhou Little Maid for Forge 1.20.1. 3. Put `touhou-maid-affection-1.7.3.0.jar` into your `mods` folder. 4. Launch the game. ## Build From Source ```bash git clone https://github.com/yabo083/Touhou-Maid-Affection.git cd Touhou-Maid-Affection ./gradlew build ``` Output jar: ```text build/libs/touhou-maid-affection-.jar ``` ## Maintenance Docs - [PROJECT_ARCHITECTURE.md](PROJECT_ARCHITECTURE.md): architecture boundaries and module responsibilities. - [CHANGELOG.md](CHANGELOG.md): user-facing release history. - [早安吻相关配置说明.md](早安吻相关配置说明.md): datapack text, voice, and AI setup guide. - [TESTING.md](TESTING.md): test scope and regression commands. - [DEPLOYMENT.md](DEPLOYMENT.md): release constraints and pre-release checklist. ## License [MIT License](LICENSE)