星露谷物语消息 - 手机短信与彩信 (核心)

星露谷消息 - 短信/彩信框架 (核心)

v1.0.1 - 手机界面 + 引擎。故事来自JSON内容包。

简单来说： 一款内置真实短信/彩信应用的游戏手机（支持会话、联系人、彩信和图库）。 再加上一个轻量的对话框架（场景介绍、选择、触发及自然节奏）， 并且提供一个实用的快捷操作，能在几秒钟内找到NPC。

这个模组的功能（以及不包含的功能）

这个文件是核心部分。 它提供了手机界面和引擎。 它本身不包含故事内容。 要接收NPC对话，请至少安装一个JSON内容包。 推荐的入门包： 原版初次接触（内容包）

主要支柱

1) 手机（短信/彩信）

• 带有对话线程的收件箱（未读标记，最近排序）
• 在线程内整洁阅读（滚动、消息气泡）
• 类手机导航（信息/联系人/图库）

2) MMS画廊

• 帖子内的MMS图片（图片+说明）
• 画廊应用：缩略图 → 全屏视图 → 下一张/上一张
• 可选过滤器（取决于资源包元数据）

3) 故事场景引擎（这是它超越"纯文本对话"的地方）

• 神秘联络人：初始为匿名，在适当时机揭示联络人身份
• 多选回复：角色扮演中的1/2/3选项及其变体
• 触发 + 投递队列：消息以自然节奏到达（不会出现洪水式发送）

4) 仅支持JSON的内容包

• 故事内容无需 C#：对话、触发器、选项、国际化……均以 JSON 格式处理
• 社区友好：创作者可以发布自己的资源包
• 已通过i18n令牌准备好翻译

快速安装

• 安装SMAPI
• 将此模组放入：Stardew Valley/Mods/
• 安装至少一个内容包（推荐使用上述内容包）
• 启动游戏 - 游戏过程中会自然地收到消息

功能演示（GIF动图）

（即将推出 - 占位符。）

• 手机导航（收件箱 → 对话）

• 快速定位（你在哪里？）

• GIF 3: 自然到达示例（例如睡觉后）

• 线程内的MMS

• GIF 5： 画廊导航（缩略图 → 全视图 → 上一张/下一张）

• GIF 6： 多选回复

• GIF 7: 神秘联系人（匿名介绍 → 揭露）

要求/兼容性

• 星露谷物语 1.6+
• SMAPI 4.0+
• 多人游戏：所有人都应安装本核心。内容包应保持一致以确保内容同步。

面向内容创作者

想要创建自己的包吗？

• 仅使用JSON的工作流程（无需C#）
• 用于简易翻译的国际化令牌
• 查看文档标签获取模式、示例和最佳实践

更新日志

1.0.0 - 首次公开发布：

• 消息界面(线程+未读)
• MMS + 画廊
• 递送队列（反洪水机制）
• 触发器
• 神秘联系人的介绍（匿名 → 揭露）
• 快速定位
• 确定性内容包优先级

1.0.1 - 多人游戏改进：

• 将状态移至每个玩家的本地JSON存储（不再覆盖主机数据）
• QuickWhere：修复了多人游戏的可靠性

1.0.2 - 存档和用户界面改进：

• UI**：** 新增F9键（默认）循环切换HUD按钮位置（防止与其他UI模组重叠）+ 新消息到达时的可选聊天通知
• 持久化**：**升级了JSON存档系统，采用快照+WAL（预写式日志），以实现更安全、更可靠的数据存储。

1.0.3 - 新增与改进：

• 联系人之间的对话链接系统（同一包内）
• 收件箱排序现在是确定性的：
  • 未读优先
  • 然后阅读
  • 在每个组内，最新的排在前面

1.0.4 - 新增和改进：

• 自定义联系人名称现在可以通过 DisplayNameKey 通过国际化实现翻译。
• 新增根据《星露谷物语》实际每日运气值的 DailyLuck / MinDailyLuck 触发条件。
• 在对话中为未读的传入消息添加了视觉高亮显示。
• 离开线程时对话才会被标记为已读，而非在打开时立即标记。
• 打开一个对话不再将其他对话中的未读消息标记为已读。

制作人员名单

• 作者： Jybee

注： 我设计了功能集和整体方向；AI在开发过程中协助了草稿撰写、格式整理和迭代优化。