肮脏金钱系统

《GTA V》脏钱与普通钱分离系统 MOD 使用指南
【核心介绍】
本 MOD 为游戏新增「脏钱」独立账户系统，自动区分非法所得（如抢劫、拾取尸体现金）与合法收入（如房产收益），支持存储、支付选择与多角色独立存档。
【安装指南】
1. 下载本 MOD 的 「DirtyMoney.dll」、「DirtyMoney.pdb」 及 「DirtyMoney」文件夹；
2. 将全部文件复制至游戏脚本目录：游戏根目录 /scripts（路径示例：`Grand Theft Auto V/scripts`）；
3. 安装前，必须同步安装以下前置依赖：
• 「ScriptHookV」
• 「ScriptHookVDotNet」
• 「LemonUI」
• .NET Framework 4.8 和 Visual C++ 2015 运行库（缺一不可）。
【功能详情】
✅ 已优化：
• 自动识别并归类「尸体拾取现金」「24/7 抢劫所得」「Groupe6 突袭钱包」为脏钱；
• 支持创建多位置「脏钱存储点」（行李箱／钱袋／墓碑／泥土等），可存取、删除；
• 按 Tab 查看当前脏钱余额，按 K 打开脏钱管理菜单；
• 多角色独立存档（Franklin / Michael / Trevor / MPMALE / MPFEMALE / OTHER）；
• 金钱数值自动添加千位分隔符（如 `$1.234.567`）。
❌ 未修改：
• 房产相关收益（如「Pitchers」酒吧、「Weed Shop」大麻店、「Tivoli Cinema」影院）始终视为普通钱，不触发转换提示；
• 被逮捕保释金、医院治疗费、弹药店购枪购弹、所有房产购置费用——禁止使用脏钱支付。
✨ 额外调整：
• 提供 `Option.ini` 配置文件，可开关以下功能：
– `pay_dirty`：启用／禁用「支付时询问脏钱选项」；
– `select_money_destination`：启用／禁用「收款时询问归属类型」；
– `vanilla_to_dirty`：启用／禁用「自动将拾取现金转为脏钱」；
• 死亡或被捕时，随身携带的脏钱将全部丢失（普通钱不受影响）；
• 支持与「Los Santos Dealerships」「Fleeca Bank Heists」等主流经济类 MOD 兼容（通过公共函数调用）。
【使用要求】
• 游戏版本：GTA V 单机模式（Story Mode 或 Online 切换兼容）；
• 必须安装「血与酒」以外的全部官方扩展包（本 MOD 不依赖 DLC，但需完整基础版）；
• 系统环境：Windows 10/11，已安装 .NET Framework 4.8 与 Visual C++ 2015 运行库。
【兼容性说明】
• 兼容范围：所有通过标准金钱 API 增减金额的 MOD（如房产、任务、商店类）；
• 不兼容模组：
• 修改底层金钱存储结构或覆盖 `网址链接` 属性的非标脚本（无补丁）；
• 与本 MOD 同时监听金钱变更且未调用公共接口的冲突脚本（如自定义洗钱器未适配）；
• 兼容补丁：暂未推出；如需深度集成，请参考 Rentry 指南（[ 网址链接
【注意事项】
• `DirtyMoney.xml` 文件结构在 v0.4.8 版本更新，旧存档需手动迁移 “ 与 “ 标签内容至新格式；
• 当前版本中，被逮捕产生的医疗费用仍可能误用脏钱支付（已知问题，后续修复）；
• 使用「角色交换」类 MOD 时，首次切换后请按 K 打开菜单，点击「角色检查」按钮以刷新状态；
• 所有配置均位于 /scripts/DirtyMoney/Option.ini，修改后无需重启游戏，部分功能需重进菜单生效。
【更新日志】
• 2024 年 4 月 10 日 v0.5.0
– 优化支付逻辑：仅当脏钱 ≥ 支付金额且身上有脏钱时，才触发支付选择；
– 增加金钱值 > 0 校验，避免异常崩溃。
• 2024 年 3 月 22 日 v0.4.9b
– 新增 `auto_convert=TRUE` 选项：除房产收益外，所有收入默认转为脏钱；
– 互联网购买（如网站下单）不再触发脏钱支付询问；
– 修复脏钱数量未保存导致的崩溃问题。
• 2024 年 2 月 15 日 v0.4.8
– 重构角色识别机制，支持 Franklin / Michael / Trevor / MPMALE / MPFEMALE / OTHER 六类独立存档；
– 移除临时兼容选项，统一通过模型哈希匹配角色；
– `DirtyMoney.xml` 结构变更，迁移指引见【注意事项】。
• 2023 年 12 月 5 日 v0.4.6
– 修复死亡／被捕后脏钱未清空问题；
– 明确限定医疗、房产、弹药支出仅允许使用普通钱。
• 2023 年 10 月 18 日 v0.4.5
– 升级至「ScriptHookVDotNet 3」；
– 补充 .NET 4.8 与 Visual C++ 2015 为强制依赖项。