Touhou Maid: Affection

Touhou Maid: Affection

为 Touhou Little Maid 带来亲密互动、羁绊成长与长久陪伴。

中文

概览

Touhou Maid: Affection 是面向 Touhou Little Maid (TLM) 的好感度与羁绊陪伴扩展模组。

通过亲密互动表达爱意，亲吻可提升好感度，随着关系加深，还能解锁专属羁绊系统。羁绊能力包括舒适的膝枕、专属早安吻、致命危险时的紧急救援，以及贴心的随机礼物。该模组还整合了 TLM 原生 AI 聊天与 TTS 语音系统，并全面支持数据包自定义对话和语音台词。

核心机制

亲吻互动

• 按键操作：将准星对准女仆并按下亲吻键。骑着鞍携带女仆时，使用专用的携带女仆亲吻键即可直接互动。
• 视觉与音效反馈：每次亲吻都会出现爱心粒子效果、俏皮音效，并短暂拉近镜头。
• 好感度成长：亲吻会稳步提升女仆的好感度。好感度越高，亲吻冷却时间越短。
• 女仆的祈祷：短时间内连续亲吻，可使玩家和女仆获得“女仆的祈祷”生命恢复效果。

羁绊系统

女仆好感度达到 3 级（最高）后，她的物品栏界面顶部将解锁羁绊标签页。
玩家可以消耗 P 点（物品栏中的 PowerPoint 物品）来解锁独特的羁绊能力：

| 羁绊能力 | 描述 |
| :— | :— |
| 膝枕 | 坐下或躺下休息，共享温馨时光。支持调整位置偏移、锁定镜头，以及 YSM 自定义动画。 |
| 早安吻 | 醒来时定时触发早晨问候。女仆会走近送上早安吻，并播放自定义台词和语音。 |
| 紧急救援 | 受到致命伤害时，已建立羁绊的女仆会冲上前为你挡下攻击，并通过专属救援台词为你恢复应急生命值。 |
| 随机礼物 | 已建立羁绊的女仆会随着时间收集并送上贴心礼物，进度可直接在界面中查看。 |

AI 早安吻与双语语音系统

早安吻可使用 Touhou Little Maid 中配置的 AI 聊天和 TTS 服务商，在后台预先生成早晨问候语。

• 双语组合：显示文本与语音语言完全独立，支持英文文本搭配日语语音等组合。
• 自动匹配：默认使用 auto，文本语言与 Minecraft 语言一致，语音则沿用女仆的 TLM AI 语音设置。
• 统一管理：直接使用你已有的 TLM AI 服务商和 API 密钥，无需重复配置。

使用方法

按键绑定

在 选项 → 控制 → 按键绑定中配置以下按键：

• 指定目标亲吻：亲吻准星所指向的女仆。
• 亲吻携带的女仆：骑着鞍携带女仆时亲吻她。
• 膝枕：触发膝枕休息姿势。
• 锁定视角：膝枕期间锁定镜头角度。

游戏内设置面板

点击面板标题栏中 羁绊能力旁边的齿轮图标，即可打开设置：

• 状态：监控内容分为 Random Gift 和 AI Morning Kiss。在礼物分区选择女仆；AI 开关、语言和缓存统计则作为子分区显示。
• 功能：切换羁绊能力、调整 AI 缓存策略，并选择礼物池、准备间隔和队列上限。
• 语音：切换显示语言和语音语言、实时编辑早安吻提示词模板，或直接跳转到 TLM 的 AI 服务提供方设置。
• 音量：实时调整亲吻音效、早安吻语音、救援台词和语音试听的音量滑块。

如果升级后的存档只能选到少量礼物，请关闭 功能 → 礼物准备 → 仅标签礼物池，即可选择更广泛的礼物池。现有配置会保留已保存的选择。
状态选项卡会显示服务器快照；使用 刷新来更新。礼物准备完成后，礼物能否送达还取决于距离和冷却时间。将鼠标悬停在内容行上并滚动，即可查看较长的物品列表。

管理员命令

所有数据和设置均由服务器权威验证。拥有操作员权限（权限等级 2）的用户可通过 /tma:

/tma morning_kiss status                       # View morning kiss status and AI cache stats
/tma morning_kiss clear_ai_cache [all|maid...]  # Clear generated dialogue and voice cache
/tma rescue on|off|toggle                      # Enable or disable emergency rescue server-wide
/tma bond prune [days]                         # Clean up bond data for maids inactive over N days (default: 90)

自定义数据包语音

通过数据包扩展对话池和 .ogg语音台词：

• 数据包路径：data/touhou_maid_affection/morning_kiss/ 和 emergency_rescue/
• 可直接使用的示例包：examples/TMA-Custom-Voice-Pack
• 详细教程：早安吻相关配置说明.md
• 整合包作者指南（中文）：PACK_AUTHORING.md — 礼物白名单/黑名单、整合包格式、配置时机、语音和重载限制。

重要说明

• 服务器权威：好感度增长、冷却时间、视线检查和能力激活均由服务器完整验证。单人游戏和多人游戏服务器的行为完全一致。
• 音量衰减：游戏内音量滑块控制客户端的音量衰减（0.0代表静音，1.0代表最大音量）。如需提高输出音量，请调高主音量/系统音量。
• 权限：在专用服务器上，全局开关、语言规则和提示词模板仅限操作员设置。非操作员玩家只能以只读模式查看设置面板。
• 数据持久化：女仆羁绊数据会在女仆死亡、区块卸载或跨维度传送后安全保留。使用 /tma bond prune清除废弃数据。

其他与兼容性

模组集成

• Touhou Little Maid (TLM)：必需的核心依赖（基于 1.5.3-forge+mc1.20.1 构建）。
• MaidFileManager：在 .maid 文件迁移期间，无缝保留羁绊等级、已解锁能力和语音设置。
• Epic Fight：兼容 [史诗战斗：车万女仆]桥接模组和 Epic Fight - Avalon；羁绊选项卡会自动避免与 GUI 选项卡冲突。
• Yes Steve Model (YSM)：支持膝枕期间的自定义动画同步。
• Tweakerge / Tweakeroo：与自由视角模式完全兼容，不会导致玩家姿势冲突。

安装

1. 安装 Minecraft 1.20.1 和 Forge 47.4.x。
2. 安装适用于 Forge 1.20.1 的 Touhou Little Maid（1.5.0+）。
3. 将 touhou-maid-affection-1.7.5.2.jar 放入你的 .minecraft/mods 文件夹。
4. 启动游戏。

开发者与架构文档

• PROJECT_ARCHITECTURE.md：架构概览与模块边界。
• CHANGELOG.md：完整版本历史。
• 早安吻相关配置说明.md：数据包对话、语音和 AI 指南。
• TESTING.md：测试套件与回归测试流程。

许可证

本项目采用 MIT 许可证 开源。