高级战利品框架

【标题】
《星露谷物语》宝箱功能扩展框架 MOD 使用指南

【核心介绍】
本 MOD 是一个纯技术框架，不提供任何直接游戏内容；专为支持「野外宝箱」「扩展宝箱」「钓鱼宝箱扩展」等依赖型宝箱模组而设计，本身不改变游戏行为。

【安装指南】

1. 必须先安装「SMAPI」（下载地址），并确保其正常运行；
2. 将本框架文件解压后，完整粘贴至游戏根目录 /mods 文件夹（路径：`StardewValley/mods/`）；
3. 本 MOD 不能单独启用——需与以下任一依赖模组同时安装且同级加载（缺一不可）：
   ✅ 「野外宝箱」（Nexus 页面）
   ✅ 「扩展宝箱」（Nexus 页面）
   ✅ 「钓鱼宝箱扩展」（Nexus 页面）

【功能详情】
✅ 已优化：为宝箱类模组提供统一、稳定的宝箱生成与配置接口；
❌ 未修改：不添加新宝箱、不调整掉落物、不更改UI或音效；
✨ 额外调整：内置 Harmony 补丁机制，支持安全注入；兼容「模组更新器」，可自动检测框架更新。

【使用要求】

• 必备：已安装并正确配置 「SMAPI」v4.0+；
• 推荐：使用 Windows/macOS/Linux 官方支持平台（Linux 用户需确保 Mono 环境正常）；
• 无需额外扩展包或 DLC。

【兼容性说明】

• 兼容范围：所有基于 SMAPI v4+ 开发、明确声明依赖本框架的宝箱模组；
• 不兼容模组：任何自行修改 `Object.cs` 或 `Chest.cs` 核心逻辑的模组（如非标准宝箱重写类模组）；
• 兼容补丁：暂未推出针对冲突模组的专用兼容补丁。

【注意事项】

• 若仅安装本框架而未安装任一支持的宝箱模组，游戏启动后不会出现任何效果，且无报错提示；
• 框架更新（如 1.6 版）仅影响依赖它的宝箱模组行为，不改变已有存档兼容性；
• GitHub 仓库（aedenthorn/StardewValleyMods）仅面向开发者，普通玩家无需操作代码。

【更新日志】

• 2024 年 X 月 X 日 新增 1.6 版本，优化 Harmony 补丁稳定性，感谢贡献者 mouahrara；
• 2023 年 X 月 X 日 起正式支持「模组更新器」自动更新机制。