对话扩展按钮

《星露谷物语》主动式对话扩展 MOD 使用指南

【核心介绍】
为 NPC 日常对话添加「主动提问」功能：玩家按下热键即可触发自定义问答对话，按好感等级（1–4 级）自动匹配不同内容，每日可配置触发次数。

【安装指南】

1. 下载本 MOD 文件（含 `ContentPatcher` 兼容的 `Dialogue.json` 示例与 `config.json`），来源为 Nexus Mods；
2. 将解压后的文件夹整体复制至游戏根目录 `/mods` 文件夹内；
3. 必须先安装前置依赖：「Content Patcher」v1.29+ 与 「SMAPI」v4.0+；
4. 若使用 SVE（Stardew Valley Expanded），无需额外操作——`Dialogue.json` 已预置 SVE 角色支持；
5. 安装后启动游戏前，请确保 `config.json` 中的键名未被修改（尤其是 `npcName_Finish`、`npcName_Fail`、`npcName_Question1`–`npcName_Question4`），否则模组无法读取对话。

【功能详情】
✅ 已优化：

• 新增热键触发机制（默认 `F1`，可在 `config.json` 修改）；
• 按好感等级分四阶段自动调用对应对话（例：六心触发 `npcName_Question2`）；
• 每日每 NPC 最多触发 2 次（次数可配置）；
• 支持问答分支逻辑（`Question` 类型对话自动启用选项跳转）；
• 内置 `config.json` 可配置项：好感等级阈值、热键、每日最大触发次数；
  ❌ 未修改：
• 原版日常/婚后/事件对话逻辑（本 MOD 不覆盖或替代 ContentPatcher 原有对话修改）；
• NPC 好感增长机制、角色行为、UI 界面等非对话交互部分；
  ✨ 额外调整：
• `Dialogue.json` 同时包含原版角色与「SVE」角色预设条目，开箱即用；
• 新增日志输出开关（`config.json` 中 `EnableLogging` 控制）；
• 多人模式兼容性已验证（服务端与客户端均需安装本 MOD 及相同配置）。

【使用要求】

• 必须安装：「SMAPI」v4.0+、「Content Patcher」v1.29+；
• 推荐安装：「Stardew Valley Expanded」（非必需，但启用后可直接使用 SVE 角色扩展）；
• 游戏版本：星露谷物语 v1.6+（暂未测试 v1.7，建议保持 SMAPI 与 CP 版本同步更新）。

【兼容性说明】

• 兼容范围：所有基于 ContentPatcher 的对话类模组（如「Marriage Dialogue Overhaul」「Seasonal Dialogue」）；
• 不兼容模组：修改 `Dialogue.json` 加载逻辑或劫持 `GameLocation.NPCs` 交互流程的模组（例：「NPC Dialogue Framework」旧版）；
• 兼容补丁：暂未推出（当前无已知冲突需补丁修复）。

【注意事项】

• `Dialogue.json` 中的 `npcName_` 开头键名（共 6 个）不可重命名，否则模组无法识别对应对话；
• 每日触发次数按 NPC 单独计算（如对艾利欧特触发 2 次后，对莱纳斯仍可触发 2 次）；
• 首次触发 `Question` 对话后，若选择分支选项，后续对话将沿该路径继续，不重新判定好感等级；
• 若玩家未达任一好感等级阈值（如全 NPC 好感均 <1 心），将统一触发 `npcName_Fail`；
• 多人模式下，仅房主配置生效，其他玩家需使用完全相同的 `config.json`。

【更新日志】
2024 年 4 月 12 日 v0.0.2

• 新增日志输出开关（`EnableLogging`）；
• 实现每日每 NPC 对话次数限制及可配置功能；
• 完成多人模式基础兼容验证。