Touhou Maid: Affection
No reviews yet
Add kisses to the Touhou Little Maid, inspired by https://modrinth.com/mod/kiss-a-friend
Includes quality of life improvements and small tweaks to enhance and customize gameplay.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
Modrinth
Compatibility
Supported Environments
Must be installed on both the client and the server.
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
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/*.oggMorning 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.1with NeoForge21.1.x. - Install Touhou Little Maid
1.5.1+. - Put
touhou-maid-affection-1.7.2.jarinto yourmodsfolder. - Launch the game.
Build From Source
git clone https://github.com/yabo083/Touhou-Maid-Affection.git
cd Touhou-Maid-Affection
./gradlew buildOutput jar:
build/libs/touhou-maid-affection-<version>.jarMaintenance 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
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|offand/tma morning_kiss tts on|off(runtime toggle), and expanded/tma morning_kiss clear_ai_cache(maid/pool/entry/voice granularity). - Config:
aiDialogueCacheConsumeOnUse(defaultfalse) controls whether cached entries are consumed or peeked.aiDialogueLanguagenow defaults totlmto 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
- Install Minecraft
1.21.1with NeoForge21.1.x. - Install Touhou Little Maid
1.5.1+. - Put
touhou-maid-affection-1.7.2.2.jarinto yourmodsfolder. - 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
Screenshots
Gallery
-
thumb.jpg thumb.jpg
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources