摩尔赫金钱模组

《星露谷物语》金钱上限突破 MOD 使用指南

【核心介绍】
突破原版 21 亿 金钱上限限制，让游戏内金币数量基本无上限；同时支持自定义数字分隔符（默认为逗号）与分组位数（默认为3位）。

【安装指南】

1. 确保已安装最新版 「SMAPI」（必装前置，缺一不可）；
2. 下载本 MOD 文件（通常为 `.zip`），解压后将文件夹整体放入游戏根目录 `/mods` 文件夹；
3. 若需使用配置功能，建议同步安装 「通用模组配置菜单」（非强制，但强烈推荐）；
4. 启动游戏前请确认 SMAPI 日志无报错，MOD 即可生效。

【功能详情】
✅ 已优化：玩家持有的总金币以字符串形式存储，理论上限达 9,223,372,036,854,775,807（Int64 最大值），实际使用中无感知限制；
✅ 已优化：支持在设置中启用/禁用千位分隔符，并自定义分隔符字符（如逗号、空格）及分组位数（如每 3 位或每 4 位）；
❌ 未修改：商品售价、购买/出售价格等系统内数值仍使用 Int32 类型，上限仍为约 21 亿；
✨ 额外调整：提供 SMAPI API 接口，供其他 MOD 调用实现超大额金钱操作。

【使用要求】

• 必须安装 「SMAPI」（版本 ≥ 4.0）；
• 游戏本体需为 《星露谷物语》官方正式版（v1.6+ 推荐）；
• 无需额外运行库或 .NET 版本升级（SMAPI 已内置适配）。

【兼容性说明】

• 兼容范围：所有不直接重写金钱存储逻辑的常规 MOD（如装饰类、UI 类、农具类）；
• 不兼容模组：直接修改 `Farmer.cash` 字段或覆盖金钱存储方式的 MOD（例如早期硬编码 Int32 金钱补丁）；
• 暂未推出专用兼容补丁。

【注意事项】

• 本 MOD 仅扩展玩家持有金币的显示与存储上限，不影响交易界面、价格标签、商店结算等系统内 Int32 数值场景；
• 如需在脚本或其它 MOD 中处理超大金额，请使用提供的 SMAPI API 方法；
• 分隔符设置需重启游戏或重新加载存档后生效；
• 极端情况下（如手动输入超长数字串），可能触发内存占用升高，属预期行为，不影响正常游戏。

【更新日志】

• 2023 年 10 月 15 日 新增对「通用模组配置菜单」v4.0+ 的完整支持，配置项可视化；
• 2023 年 5 月 3 日 开放 `AddMoolah()` 与 `GetTotalMoolah()` API，支持任意整数类型传参（≤21 亿位数）；
• 2022 年 12 月 1 日 首发版本，实现 Int64 级金钱存储与基础分隔符功能。