车万女仆附属：爱恋

Touhou Maid: Affection

Touhou Little Maid 的好感度与羁绊扩展。


---

最新版本

1.7.2 聚焦于自定义语音包与 AI 辅助早安吻：

• 为早安吻与紧急救援提供按功能划分的数据包语音池。
• 支持带 {maid} 与 {player} 占位符的静态早安吻对话包。
• 可通过 TLM AI 站点选择性地进行 AI 生成早安吻对话及 TTS 预生成。
• 为 TLM AI 聊天与 TTS 提供 TMA MiMo 适配器站点。
• 新增针对准心所指女仆的定向亲吻按键操作，可实现基于准心的亲吻。

完整版本历史见 CHANGELOG.md。

功能

亲吻交互

空手潜行并右键点击你的女仆即可亲吻她。亲吻会增加好感度，播放随机亲吻音效，生成爱心粒子，并触发短暂的近距离镜头效果。反复亲吻可触发自定义的女仆祈祷效果。

安装 CarryOn 后，右键条件会发生变化，以避免交互冲突。此外还提供专用按键，支持亲吻被公主抱的女仆。

定向亲吻按键

控制选项中包含定向亲吻操作。当你的准心指向范围内的己方女仆时，客户端仅发送实体 ID；服务端会重新检查归属权、距离、视线、冷却时间及常规亲吻规则，然后再执行交互。

羁绊系统

高好感度的女仆可成为羁绊伴侣。羁绊能力目前包括：

能力	用途
膝枕	与你的女仆一同休息，支持可配置的坐姿/躺姿姿势以及可选的 YSM 动作。
早安吻	通过计划或手动触发清晨问候，包含亲吻、对话及语音播放。
紧急救援	让羁绊女仆提供每日救援机会及救援语音台词。
随机礼物	让羁绊女仆随时间累积并赠送小礼物。

服务端始终对解锁条件、消耗、距离检查、冷却时间及能力执行具有权威性。客户端 UI 仅为展示与配置界面。

自定义对话与语音

版本 1.7.2 新增数据包驱动的语音池：

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

早安吻数据包可定义静态对话池、亲吻音效行为及 OGG 语音文件。紧急救援数据包可定义救援 OGG 语音文件及回退音效事件。参见 早安吻文本修改教程.md 以及 examples/TMA-Custom-Voice-Pack 中可直接打包的示例包。

AI 与 MiMo

早安吻可选择使用 TLM AI 站点来预生成对话与 TTS 音频。运行时行为在 config/touhou_maid_affection-common.toml 中配置，而数据包仍负责静态文本与预录制的 OGG 文件。

TMA 还为 TLM 的 AI 设置界面注册了 MiMo 兼容的聊天与 TTS 站点类型。该适配器仅提供提供商默认值；用户 API 密钥及站点启用状态仍由 Touhou Little Maid 管理。

兼容性

• Touhou Little Maid：必需依赖。
• Yes Steve Model：可选的动作播放与动作发现。
• CarryOn：可选的右键冲突规避。
• TLM GUI 与音效包：可用时进行软集成，缺失时静默回退。

安装

1. 安装 Minecraft 1.21.1 及 NeoForge 21.1.x。
2. 安装 Touhou Little Maid 1.5.1+。
3. 将 touhou-maid-affection-1.7.2.jar 放入你的 mods 文件夹。
4. 启动游戏。

从源码构建

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

输出的 jar：

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

维护文档

• PROJECT_ARCHITECTURE.md：架构边界与模块职责。
• CHANGELOG.md：面向用户的版本历史。
• 早安吻文本修改教程.md：数据包文本、语音及 AI 设置指南。
• TESTING.md：测试范围与回归命令。
• DEPLOYMENT.md：发布约束与发布前检查清单。

许可证

MIT 许可证