RandomWeightAndValueMod 🎮

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

⚠️ 开发状态与限制说明

当前版本为初始发布，尚未经过广泛的兼容性与稳定性测试。
暂不支持多人同步：在联机时，只有进行修改的客户端（通常是主机）会生效，其他玩家可能看到不一致的效果。主要推荐用于单人游戏。

✨ 功能特点

双属性随机：同时改变物品的物理重量和经济价值，让每次拾取都充满惊喜。
高度可配置：重量和价格的随机变化范围均可自由调节，打造你想要的游戏体验。
一次生效：每个物品只在第一次被抓取时修改，确保单局游戏内的逻辑一致性。
智能调整：高价物品的价格波动更小，低价物品波动更大，保持游戏平衡与合理性。
黑白名单系统：精确控制哪些物品被随机化，哪些物品保持原样。
预设共享修复：自动检测并修复PhysAttribute预设共享问题，确保每个物品独立修改。
现金袋保护：默认不随机化提取点奖励的现金袋，保持结算金额的成就感（可配置开关）。

📥 安装方法

自动安装（推荐）

安装 Thunderstore Mod Manager 或 r2modman。
在应用内搜索 RandomWeightAndValueMod 并点击安装，其依赖项（BepInEx， REPOConfig）将自动安装。

手动安装

确保已安装 BepInEx 5 和 REPOConfig。
从本页面下载 RandomWeightAndValueMod.zip。
将其解压到《REPO》的游戏根目录（即包含 BepInEx 文件夹的目录）。

⚙️ 配置说明

所有设置均可通过以下两种方式调整：

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

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

确保已安装 REPOConfig 模组。
进入游戏，打开 REPOConfig 主菜单（默认快捷键可在其模组页面查询）。
在左侧列表中找到并点击 "随机贵重物品的价格及重量"。
右侧将显示所有可调节项，修改后通常立即生效。

主要配置项说明：

分类	配置项	说明与默认值
通用设置	`EnableWeightRandomization`	启用重量随机化 (默认: `true`)
	`EnableValueRandomization`	启用价格随机化 (默认: `true`)
重量设置	`MinWeight`	最小重量倍率 (默认: `0.5`，即原重的50%)
	`MaxWeight`	最大重量倍率 (默认: `3.0`，即原重的300%)
价格设置	`MinValueMultiplier`	价格最小倍率 (默认: `0.8`，即原价的80%)
	`MaxValueMultiplier`	价格最大倍率 (默认: `2.5`，即原价的250%)
黑白名单	`启用黑名单模式`	启用黑名单 (默认: `true`，匹配的物品将不被随机化)
	`黑名单关键词`	黑名单关键词 (默认: 空，用户自行添加，如: `surplus,cash,money`)
	`启用白名单模式`	启用白名单 (默认: `false`，只有匹配白名单的物品才会被随机化)
	`白名单关键词`	白名单关键词 (默认: 空，用户自行添加)
特殊排除	`现金袋随机化开关`	现金袋随机化开关 (默认: `false`，`true`=随机化现金袋，`false`=不随机化现金袋)
	`排除高额物品`	排除高额物品 (默认: `false`，不随机化价格超过阈值的物品)
	`高额物品阈值`	高额物品阈值 (默认: `50000`，价格超过此值的物品不随机化)
高级设置	`启用预设共享检测`	启用预设共享检测 (默认: `true`，检测并修复`PhysAttribute`预设共享问题)
	`预设共享阈值`	预设共享阈值 (默认: `3`，当预设被超过此数量的物品共享时才创建副本)
调试设置	`启用详细日志`	在控制台输出每个物品修改的详细日志 (默认: `true`)
	`强制刷新UI`	尝试在修改后刷新物品的UI显示 (默认: `true`)

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

关闭游戏。
导航至 游戏根目录/BepInEx/config/。
用文本编辑器打开 RandomWeightAndValueMod.cfg。
修改对应配置项等号（=）后的数值并保存。
重新启动游戏使更改生效。

📜 更新日志

版本 v1.2.1 - 2026年1月31日

文档更新：修改说明文件### 版本 v1.2.0 - 2026年2月1日
新增：添加现金袋随机化开关配置，用户可选择是否随机化提取点奖励
优化：黑白名单系统关键词默认留空，提供更大的灵活性
简化：移除高级设置中与通用设置重复的配置选项
修复：完善预设共享检测的性能优化

版本 v1.1.0 - 2026年1月31日

新增：完整的黑白名单系统，支持关键词匹配
改进：增强预设共享检测和修复机制
新增：更多调试日志选项，便于问题排查
优化：性能改进，减少不必要的运行时检查

版本 v1.0.1 - 2026年1月31日

移除：移除了用于内部调试的"侦察模式"选项，简化了配置菜单。
修复：解决了在某些情况下物品重量修改后 Rigidbody 未同步更新的问题。
优化：改进了日志输出，使其在默认情况下更简洁。
文档：修改并完善了说明文件，使其描述更准确。

版本 v1.0.0 - 2026年1月30日

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

❓ 常见问题

Q：这个模组支持多人游戏吗？ A：当前版本不提供完整的多人游戏同步。在联机时，修改效果可能仅对主机生效。建议在单人游戏中使用以获得完整体验。

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

Q：会和修改器或其他模组冲突吗？ A：通常情况下不会。本模组仅修改物品的基础属性，不涉及游戏核心逻辑，与大多数模组兼容。如遇到问题，请尝试在配置中调整范围或暂时禁用其他模组进行排查。

Q：为什么有些物品的重量修改不生效？ A：这可能是因为物品使用了共享的PhysAttribute预设。模组已经内置了预设共享检测和修复机制，如果问题仍然存在，请开启详细日志模式查看具体原因。

Q：如何查看模组是否正常工作？ A：在配置文件中将启用详细日志设为true，然后在游戏控制台中查看拾取物品时的修改日志。

Q：我想排除某个特定的贵重物品，应该怎么做？ A：将该物品名称中的关键词添加到黑名单中。例如，要排除"Golden Statue"，可以添加golden或statue到黑名单。

🙏 灵感来源与致谢

本模组最初的重量随机化想法来源于 N0w4h 的 RandomWeightMod，感谢其提供的灵感与基础。
本模组在其核心概念上进行了 独立开发与功能扩展，主要新增了完整的贵重物品价格随机化系统，旨在创造一个更具变化和策略深度的游戏体验。

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