RandomWeightAndValueMod 🎮

一个为《REPO》游戏设计的模组，可在你第一次抓取贵重物品时，随机化其重量和价格，大幅增加游戏的变数和重玩价值！

⚠️ 开发状态说明 当前模组版本为初始发布，尚未经过广泛的兼容性与稳定性测试。在复杂的模组环境下可能会遇到意外问题。

最重要的限制：当前版本没有实现多人游戏同步。在联机时，只有主机（或修改者）看到的重量和价格变化会生效，其他客户端将无法看到一致的修改效果。此模组目前主要推荐用于单人游戏。

✨ 功能特点

• 双属性随机：同时改变物品的重量和售价。
• 高度可配置：所有随机范围均可通过游戏内配置菜单精细调节。
• 一次生效：每个物品只在第一次被抓取时修改，确保单局游戏内的一致性。

📥 安装方法

自动安装（推荐）

1. 确保已安装 Thunderstore Mod Manager 或 r2modman。
2. 在应用内搜索 RandomWeightAndValueMod 并点击安装，依赖的 REPOConfig 会自动安装。

手动安装

1. 确保已安装 BepInEx 5 和 REPOLib。
2. 强烈建议同时安装 REPOConfig 以获得图形化配置界面。
3. 下载本模组的 RandomWeightAndValueMod.zip 文件。
4. 将其解压到你的游戏根目录（即包含 BepInEx 文件夹的目录）。

⚙️ 配置说明

本模组的所有设置均可调整，推荐以下两种方式：

方式一：使用 REPOConfig 图形界面 (推荐)

这是最方便的方法，可以在游戏内实时调整并看到效果。

1. 确保已安装 REPOConfig 模组。
2. 进入游戏。
3. 打开 REPOConfig 主菜单。
4. 在左侧列表中找到并点击 “随机贵重物品的价格及重量”。
5. 右侧将显示所有可调节的配置项，修改后会立即生效。

主要配置项说明：

• 通用设置
  • EnableWeightRandomization - 启用重量随机化（默认：开启）
  • EnableValueRandomization - 启用价格随机化（默认：开启）
• 重量设置
  • MinWeight - 最小重量倍率（默认：0.5，即原重的50%）
  • MaxWeight - 最大重量倍率（默认：3.0，即原重的300%）
• 价格设置
  • MinValueMultiplier - 价格最小倍率（默认：0.8，即原价的80%）
  • MaxValueMultiplier - 价格最大倍率（默认：2.5，即原价的250%）
• 调试设置（通常无需改动）
  • 启用侦察模式 - 输出详细的重量系统侦察报告到控制台。
  • 启用详细日志 - 输出每个物品修改前后的具体数值到控制台。
  • 强制刷新UI - 尝试在修改后刷新物品的UI显示。

方式二：手动编辑配置文件

如果你不想安装 REPOConfig，也可以直接编辑配置文件。

1. 关闭游戏。
2. 导航到游戏目录下的：BepInEx/config/
3. 用文本编辑器（如记事本）打开 RandomWeightAndValueMod.cfg 文件。
4. 找到对应的配置项，修改等号（=）后面的数值。
5. 保存文件，重新启动游戏使更改生效。

❓ 常见问题

Q：这个模组支持多人游戏吗？ A：当前版本不支持完整的多人游戏同步。在联机游戏中，只有进行修改的客户端（通常是主机）会正确应用重量和价格的变化，其他玩家看到的可能仍是原始数值或出现不一致的情况。我们推荐在单人游戏中使用此模组。

Q：会影响游戏存档吗？ A：不会直接破坏存档。但建议在启用模组后开始新游戏，以获得最佳体验。

Q：和修改器（Cheat）模组冲突吗？ A：通常不会。本模组只修改物品的基础属性，不涉及游戏核心逻辑。

本说明文档由 DeepSeek AI 辅助生成。

📜 更新日志

v1.3.9 (最新版本)

• 更新：更新文档说明

v1.3.8

• 更新：更新文档说明, 增加单独的更新日志

v1.3.7

• 更新：更新文档说明，增加未来规划

v1.3.6

• 重构：移除所有重量和价格的默认值设置，完全尊重游戏原始数据
• 改进：重量获取逻辑，只在游戏本身设置了重量值时才进行随机化
• 优化：物品跟踪机制，减少重复随机化的可能性
• 新增：当物品重量或价格为0时的跳过逻辑和警告日志

v1.3.5

• 修复：重量随机化中的NaN计算问题
• 修复：单机模式下的网络警告问题
• 改进：重复修改防护机制
• 优化：配置验证和错误处理
• 新增：日志工具类和更详细的调试信息

v1.3.4

• 恢复：完整的网络同步功能，包含RPC广播机制
• 改进：增强错误处理和日志系统
• 更新：优化配置项说明和默认值

v1.3.3

• 修复：模组加载时的依赖检测问题
• 修复：移除重复集合定义，避免逻辑冲突
• 改进：统一网络状态检查方法
• 清理：删除未使用的导入和冗余代码

v1.3.2

• 新增：完整的网络同步功能框架
• 优化：代码结构，提高编译稳定性
• 改进：配置项说明和默认值
• 更新：更新文档说明

v1.3.1

• 修复：程序集引用问题，确保稳定编译
• 改进：日志系统和错误处理
• 优化：配置界面显示

v1.3.0

• 重构：代码架构，提高了稳定性
• 新增：网络同步框架（实验性）
• 改进：预设共享检测机制

v1.2.2

• 更新：更新文档说明

v1.2.0

• 新增：现金袋随机化开关配置
• 优化：黑白名单系统关键词默认留空
• 简化：高级设置配置选项

v1.1.0

• 新增：完整的黑白名单系统，支持关键词匹配
• 改进：预设共享检测和修复机制
• 新增：更多调试日志选项

v1.0.0

• 初始版本发布
• 实现：抓取时随机化贵重物品重量和价格的核心功能