一句话定位:它是《星露谷物语》的数据契约程序集,负责把散落在游戏内容包里的原始数据,翻译成程序能够识别的强类型对象。
数据建模该程序集在 GameData 命名空间下定义了大量数据模型,覆盖作物、鱼类、NPC、武器、工具、大件物品、邮件、烹饪配方、任务、商店库存等游戏元素。每个模型都以字段与属性的形式,精确描述了对应数据的结构与类型。
反序列化游戏的内容管线从 Content/Data 目录读取 XNB 或 JSON 资源,再依据这些模型完成反序列化,生成运行时使用的对象实例。
模组接口SMAPI、Content Patcher 等模组框架均引用该程序集,以实现类型安全的字段读取、写入与内容补丁定位,避免直接操作字符串键值带来的解析风险。
启动阶段:运行时在解析程序集引用时失败,抛出 FileNotFoundException 或 TypeLoadException,游戏可能黑屏、闪退或卡在加载界面。
内容层:地图、物品、NPC 等数据无法完成实例化,出现物品图标空白、对话异常、事件无法触发等表现。
模组层:依赖该程序集的模组会在加载时链式报错,SMAPI 控制台出现大量红色异常日志,甚至导致存档无法读取。
恢复建议:通过平台校验游戏文件完整性,或从同版本客户端中还原该 DLL,切勿混用版本不一致的文件。