Touhou Maid: Affection

Bymiyakko_de
Mods

Add kisses to the Touhou Little Maid, inspired by https://modrinth.com/mod/kiss-a-friend

Description

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:

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

Install Minecraft 1.21.1 with NeoForge 21.1.x.
Install Touhou Little Maid 1.5.1+.
Put touhou-maid-affection-1.7.2.jar into your mods folder.
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