
农场编年史开发者资源 - SMAPI的日历与调度架构
面向开发者的架构与参考包,用于为Stardew Valley SMAPI模组构建日历、日程安排、预测和iCalendar导出系统。
查看大图FarmChronicle 开发者资源
FarmChronicle 是一个面向开发者的参考项目,探索如何为围绕 SMAPI 构建的《星露谷物语》模组结构化日历、规划、调度和预测系统。此包面向模组开发者和对日期运算、事件聚合、重复任务、作物截止日期逻辑、导出格式及相关架构进行研究的技术型用户。
重要
这是一个开发者资源和架构参考。它目前并非作为可安装的游戏模组分发。随附的源代码在准备此包的环境中尚未在本地《星露谷物语》+ SMAPI 运行时中编译或验证。不包含 DLL。
包含内容
- 日历/日期架构和星露谷季节/年份运算
- 作物截止日期算法设计
- 事件提供程序架构和重复任务设计
- iCalendar/ICS 导出架构
- 多人游戏同步设计说明
- 缓存、性能、测试策略、SMAPI 集成、安全和隐私指南
- C# 实现示例和现有测试源文件
下载文件
FarmChronicle 开发者参考项目的源代码架构、技术文档、示例和测试源代码。此包不是可安装的游戏模组,不包含已编译的 DLL。
涵盖主题
星露谷日期运算: 四个 28 天季节的规范化绝对日表示、比较和确定性排序、季节转换,以及冬季 28 日滚动到下一年的春季 1 日。
作物截止日期逻辑: 基于生长阶段、再生长、季节边界和多季节作物的预设配置计算。该资源解释了假设以及缺失的实时游戏数据适配器;它不声称已验证的游戏内预测。
事件提供程序架构: 生日、节日、任务、作物、委托和机器预测的独立提供程序概念。源代码目前仅连接玩家提醒;其他提供程序是设计示例,并非活跃集成。
iCalendar 导出: 转义、确定性 UID、UTF-8 行折叠、日期转换、事件去重和离线导出设计,互操作性工作仍有待记录。
多人游戏设计: 版本化消息、共享规划状态、主机权威、畸形消息拒绝,以及个人任务与共享任务。源代码仅包含已验证的消息模型;多人游戏传输和同步尚未实现。
验证状态
- 静态项目结构:已检查
- JSON 结构:已检查
- 项目 XML 结构:已检查
- 翻译键一致性:已检查
- 编译:未验证
- 自动化 .NET 测试执行:未执行
- SMAPI 运行时:未验证
- 游戏内测试:未验证
这些限制已说明,以免该资源被误认为是已完成的游戏发布版本。
目标受众
在构建 SMAPI 实用工具、试验基于日期的游戏系统、设计任务或时间线界面、实现重复事件、研究日历导出,或将游戏集成与可测试的领域逻辑分离时有用。
许可证
随附的源代码采用包中包含的 MIT 许可证授权。在将任何部分集成到另一个项目之前,请先查阅该许可证。不包含官方《星露谷物语》或 SMAPI 源代码。
关于作者
FarmChronicle 是一个实验性日历系统架构项目,由 Karen Cohen 维护。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。