Touhou Maid: Affection

An affection and bond expansion for Touhou Little Maid.

---

Latest Release

1.7.2.2 brings AI cache persistence, expanded management commands, and smarter language defaults:

• Cache persistence: AI-generated dialogue and TTS audio are now saved to world/generated_morning_kiss/ and survive server restarts.
• New commands: /tma morning_kiss status (runtime overview), /tma morning_kiss cache (per-maid stats), /tma morning_kiss ai on|off and /tma morning_kiss tts on|off (runtime toggle), and expanded /tma morning_kiss clear_ai_cache (maid/pool/entry/voice granularity).
• Config: aiDialogueCacheConsumeOnUse (default false) controls whether cached entries are consumed or peeked. aiDialogueLanguage now defaults to tlm to follow per-maid TLM language preferences.
• Language resolution: Text generation and TTS voice language now resolve independently based on chat vs. TTS source language.

Full release history lives in CHANGELOG.md.

Features

Kiss Interaction

Sneak with an empty hand and right-click your maid to kiss her. 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.

When CarryOn is installed, the right-click condition changes to avoid interaction conflicts. A dedicated keybind also 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.

The server remains authoritative for unlocks, costs, distance checks, cooldowns, and ability execution. The client UI is a display and configuration surface.

Custom Dialogue And Voices

Version 1.7.2+ adds datapack-driven voice pools:

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. See 早安吻文本修改教程.md and the ready-to-zip sample pack in examples/TMA-Custom-Voice-Pack.

AI Hub

Morning Kiss can optionally use TLM AI sites to pre-generate dialogue and TTS audio. Runtime behavior, prompts, and the aiDialogueLanguage language setting are configured in config/touhou_maid_affection-common.toml, while datapacks stay responsible for static text and pre-recorded OGG files. After changing language or prompt settings, admins can run /tma morning_kiss clear_ai_cache to clear generated cache for the current server session so later scans regenerate it.

TMA also registers AI Hub chat and TTS site presets for TLM's AI settings UI. The current provider implementation is MiMo-compatible, but the in-game entry is named around TMA AI behavior so future chat, TTS, and STT-facing features can share the same doorway. User API keys and enabled site state remain managed by Touhou Little Maid.

Compatibility

• Touhou Little Maid: required dependency.
• Yes Steve Model: optional action playback and action discovery.
• CarryOn: optional right-click conflict avoidance.
• TLM GUI and sound packs: soft integration where available, silent fallback where absent.

Installation

1. Install Minecraft 1.21.1 with NeoForge 21.1.x.
2. Install Touhou Little Maid 1.5.1+.
3. Put touhou-maid-affection-1.7.2.2.jar into your mods folder.
4. Launch the game.

Build From Source

git clone https://github.com/yabo083/Touhou-Maid-Affection.git
cd Touhou-Maid-Affection
./gradlew build

Output jar:

build/libs/touhou-maid-affection-<version>.jar

Maintenance Docs

• PROJECT_ARCHITECTURE.md: architecture boundaries and module responsibilities.
• CHANGELOG.md: user-facing release history.
• 早安吻文本修改教程.md: datapack text, voice, and AI setup guide.
• TESTING.md: test scope and regression commands.
• DEPLOYMENT.md: release constraints and pre-release checklist.

License

MIT License