Touhou Maid: Affection

An affection and bond expansion for Touhou Little Maid.

Latest Release

1.7.2 focuses on custom voice packs and AI-assisted Morning Kiss:

• Per-feature datapack voice pools for Morning Kiss and Emergency Rescue.
• Static Morning Kiss dialogue packs with {maid} and {player} placeholders.
• Optional AI-generated Morning Kiss dialogue and TTS pre-generation through TLM AI sites.
• TMA MiMo adapter sites for TLM AI chat and TTS.
• A new targeted-maid kiss key action for crosshair-based kissing.

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:

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 And MiMo

Morning Kiss can optionally use TLM AI sites to pre-generate dialogue and TTS audio. Runtime behavior is configured in config/touhou_maid_affection-common.toml, while datapacks stay responsible for static text and pre-recorded OGG files.

TMA also registers MiMo-compatible chat and TTS site types for TLM's AI settings UI. The adapter supplies provider defaults only; 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.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