沉浸式节日对话

《星露谷物语》沉浸式节日对话 MOD 使用指南

【核心介绍】
为全部婚姻候选人新增超 600 条节日专属对话，内容基于玩家与角色的当前关系状态（友好 / 约会 / 订婚 / 结婚 / 离婚），显著提升节日互动真实感与代入感。

【安装指南】

1. 必须先安装：最新版「SMAPI」与「Content Patcher」；
2. 下载本 MOD 后，将其完整文件夹解压至游戏根目录 `/mods` 文件夹；
3. 启动游戏时务必通过 SMAPI 运行（双击 `StardewModdingAPI.exe` 或使用启动器）；
   ✅ 缺一不可：未安装「SMAPI」或「Content Patcher」将导致 MOD 完全不生效。

【功能详情】
✅ 已优化：

• 全部 12 名婚姻候选人（山姆、亚历克斯、哈维、玛鲁、莉亚、塞巴斯蒂安、埃利奥特、佩妮、沙恩、艾米丽、海莉、阿比盖尔）的节日对话；
• 对话逻辑严格匹配关系阶段（如订婚仅在订婚当日触发，离婚后与前配偶在集市相遇有专属回应）；
  ❌ 未修改：
• 非婚姻候选人（如皮埃尔、乔迪、刘易斯镇长等）的节日对话；
• 角色家人、朋友的节日互动；
• 肖像、服装、节日场景美术资源；
  ✨ 额外调整：
• 修复多处原始对话中的拼写、语法及条件判定错误（如佩妮“友好”状态触发异常）；
• 优化对话加载稳定性，避免因条件冲突导致对话缺失。

【使用要求】

• 游戏版本：需运行于《星露谷物语》v1.5 或更高版本；
• 必备工具：已安装「SMAPI」v4.0+ 与「Content Patcher」v1.29+；
• 无额外硬件/配置要求。

【兼容性说明】

• 兼容范围：支持所有官方内容扩展（含「姜岛」DLC），与多数非对话类 MOD 无冲突；
• 不兼容模组：
• 「Farmerjack 的节日对话扩展」：二者修改相同节日事件文件，Content Patcher 按文件夹名称字母顺序加载，后加载者覆盖前者；
• 其他直接修改 `/Data/Events.json` 或节日相关 `.xnb` 文件的对话类 MOD；
• 兼容补丁：暂未推出专用兼容补丁；如需共存，可手动重命名文件夹（例：将本 MOD 文件夹改为 `z_IFD_ImmersiveFestivalDialogue` 以确保最后加载）。

【注意事项】

• 订婚状态对话仅在订婚当日 6:00–23:59 间触发，且需在该时段内向对方赠送「订婚项链」才可解锁全部分支；
• 离婚后与前配偶在「星之果实集市」偶遇时的对话为单次触发，不会重复播放；
• 当前版本暂未适配多语言本地化，对话默认显示英文（后续更新将加入翻译支持）；
• 若启用多个 Content Patcher 类对话 MOD，请检查 `/mods` 内文件夹命名顺序，避免意外覆盖。

【更新日志】

• 2018 年 10 月 4 日：版本 1.0.1 — 修复拼写、语法及部分对话条件代码错误；
• 2018 年 8 月 19 日：版本 1.0.0 — 正式发布；新增大量对话，修正婚姻角色对话逻辑错误；
• 2018 年 8 月 17 日：版本 0.12.0 — 新增海莉节日对话；
• 2018 年 8 月 17 日：版本 0.11.0 — 新增艾米丽节日对话；
• 2018 年 8 月 14 日：版本 0.10.1 — 修复佩妮“友好”状态对话触发异常；
• 2018 年 8 月 14 日：版本 0.10.0 — 新增沙恩节日对话；
• 2018 年 8 月 13 日：版本 0.9.0 — 新增埃利奥特节日对话；
• 2018 年 8 月 13 日：版本 0.8.0 — 新增佩妮节日对话，修复通用条件判定问题；
• 2018 年 8 月 9 日：版本 0.7.0 — 新增阿比盖尔节日对话；
• 2018 年 8 月 9 日：版本 0.6.0 — 新增亚历克斯节日对话；
• 2018 年 8 月 8 日：版本 0.5.1 — 修复肖像显示错误，清理冗余文件；
• 2018 年 8 月 8 日：版本 0.5.0 — 新增莉亚节日对话，修复小范围逻辑问题；
• 2018 年 8 月 7 日：版本 0.4.0 — 新增塞巴斯蒂安节日对话，修复山姆集市对话；
• 2018 年 8 月 5 日：版本 0.3.0 — 新增哈维节日对话，修复基础错误；
• 2018 年 8 月 4 日：版本 0.2.0 — 新增玛鲁节日对话；
• 2018 年 8 月 4 日：版本 0.1.0 — 新增山姆节日对话，测试版首发。