markdown

随机贵重物品的价格

作者: dyxc666
版本: v1.9.0
最后更新: 2026年3月22日
注：本模组代码由 DeepSeek AI 辅助生成

⚠️ 重要提示：多人游戏测试状态

本模组主要针对单人游戏环境开发和测试，核心机制（抓取时价格随机化）理论上可在多人游戏中工作，但未经充分多人环境测试。如果你在多人游戏中遇到问题（如同步失败、配置不生效等），欢迎在模组页面反馈，但请注意目前无法保证完美兼容。

📢 加入讨论

我是代码新手，欢迎大佬们指点！
有任何问题、建议或想交流模组心得，欢迎加入我的抖音群：

🔗 抖音群链接：https://v.douyin.com/group/132508564374
（复制链接到浏览器打开或直接在抖音中搜索群号）

📖 概述

一个为《REPO》游戏设计的独立模组，专注于在第一次抓取贵重物品时随机化其价格，增加游戏的变数和重玩价值！配置采用 BepInEx 原生系统，可通过 REPOConfig 在游戏内直接编辑，无需手动修改文件。

v1.9.0 更新：

• 🧩 核心随机算法、配置模型和规则判断已提取为独立库 RandomValueLib，简化主模组代码，方便其他模组集成。
• 🛠️ 主模组仅保留 Harmony 补丁、网络同步、配置绑定和 UI 逻辑。
• 🔗 新增依赖 cn_xc-RandomValueLib，安装时将自动下载。

v1.8.3 及之前版本：

• 🎮 多人游戏同步：主机配置强制统一，所有玩家价格一致，支持中途加入。
• 🎲 局间随机种子：每局价格风格不同，避免重复感。
• 📄 推荐搭配模组清单（100+ 款）。
• 🎲 抓取时随机化、黑白名单、现金袋保护、详细日志、REPOConfig 支持。

✨ 功能特点

• 抓取时触发：价格在玩家抓取物品瞬间随机，与游戏内其他修改不冲突。
• 确定性随机：基于物品实例 ID 生成随机数，同一物品每次游戏价格固定（联机时各客户端独立计算）。
• 黑白名单：通过关键词灵活控制哪些物品被排除或仅哪些物品生效。
• 现金袋独立开关：保护重要的现金袋不被意外随机化。
• 性能优化：使用缓存确保每个物品只随机一次，不影响游戏性能。
• 完全独立：不再依赖任何外部配置同步库，配置由 BepInEx 原生管理。
• 多人同步：所有玩家共享主机配置，基于确定性随机算法独立计算，价格完全一致。新玩家中途加入时会自动同步。
• 局间变化：每局使用不同随机种子，让同一物品在不同关卡中价格范围波动，增强重复可玩性。
• 兼容性：可与大量新增贵重物品模组、新关卡模组及特殊机制模组一同使用（详见下方列表）。本模组与 Empress Currency 同时使用互不影响。

📥 安装方法

自动安装（推荐）

1. 安装 Thunderstore Mod Manager 或 r2modman。
2. 搜索 随机贵重物品的价格 作者 dyxc666 并安装。
3. 启动游戏一次以生成配置文件，然后关闭游戏。

手动安装

1. 安装 BepInEx 5（版本 5.4.2100 或更高）。
2. 将本模组的 RandomValueMod.dll 放入 BepInEx/plugins/ 文件夹。
3. 确保依赖库 RandomValueLib 也已安装（模组管理器会自动处理）。
4. （可选但推荐）安装 REPOConfig，以便在游戏中直接修改配置。
5. 启动游戏，配置会自动生成。

多人游戏注意事项

• 所有玩家必须安装相同版本的模组。
• 主机的配置（倍率、黑白名单等）将强制同步给所有客户端，客户端无需手动调整。
• 如果遇到不同步问题，请检查网络连接并确保所有玩家模组版本一致。

⚙️ 配置说明

启动一次游戏后，配置文件位于：
BepInEx/config/RandomValueMod.cfg
（如果安装了 REPOConfig，可在游戏主菜单中直接编辑）

注意：本模组不再依赖任何外部配置同步库，所有配置由 BepInEx 原生管理。

🧩 推荐搭配的模组（用户收集整理）

以下模组可能与 RandomValueMod 兼容，部分模组的特殊物品效果不受价格随机化影响，但两者机制可共存。按主题分类排列。

🧱 LEGO 系列

🏰 任天堂 / 经典 IP 系列

🎮 游戏联动系列（其他游戏）

🧸 动漫 / 虚拟角色系列

🎬 影视 / 迷因系列

🧩 原创 / 综合杂物系列

⚡ 特殊机制 / 功能类

🏰 关卡类（附带新物品，物品价格仍被随机化）

🔌 公开 API (供其他模组开发者使用)

其他模组可以通过引用此模组的 DLL 或使用反射来访问以下 API：

命名空间

using RandomValuablePrice;
事件
csharp
public static event Action<ValuableObject, float, float> OnItemRandomized
触发时机：当贵重物品被成功随机化后触发。

参数：

ValuableObject vo：被随机化的物品对象。

float oldPrice：随机前的原价。

float newPrice：随机后的新价。

方法
csharp
public static float GetItemPrice(ValuableObject vo)
描述：获取指定贵重物品的当前价格。

返回值：物品当前价格（dollarValueCurrent 字段的值）。

使用示例
csharp
// 订阅价格随机化事件
RandomValueAPI.OnItemRandomized += (vo, oldPrice, newPrice) => {
    Debug.Log($"物品 {vo.name} 价格从 {oldPrice} 变为 {newPrice}");
};

// 主动查询价格
float price = RandomValueAPI.GetItemPrice(someValuable);
🎮 使用方法
单人游戏
安装模组后启动游戏。

进入任意关卡。

抓取贵重物品时，价格会被随机化，可在日志中查看（需开启详细日志）。

多人游戏
主机安装并配置模组，配置需手动同步给客户端（因为本版本不再自动同步）。

客户端也需安装相同模组，并手动设置与主机相同的配置，以确保价格计算一致。

所有玩家独立计算价格，结果一致（基于确定性随机算法）。

❓ 常见问题
问：为什么抓取后价格没有变化？
答：请检查配置文件是否已正确生成，并确认 随机化物品价格 为 true。同时确保抓取的物品是贵重物品（有 ValuableObject 组件）。如果仍无效，可开启 详细日志输出 查看日志中是否有价格修改记录。

问：游戏内漂浮价格显示的还是原价，但日志显示已修改？
答：这可能是因为游戏 UI 缓存未立即刷新。实际提取物品时，获得的金额将是修改后的价格（以日志为准）。你可以通过提取物品来验证。

问：这个模组和其他价格修改模组冲突吗？
答：如果其他模组也在抓取时修改价格，可能会相互覆盖。建议只保留一个价格模组。

问：如何在自己的模组中使用 API？
答：在您的模组项目中添加对本模组 DLL 的引用，然后使用 RandomValueAPI 类即可。

问：这个模组支持多人游戏吗？
答：支持基本机制，但配置需手动同步。由于未经过充分多人测试，如果遇到问题欢迎反馈。

问：多人游戏中如何确保价格一致？
答：主机在关卡开始时广播配置和随机种子，每个客户端基于相同种子和物品 ID 独立计算价格，因此结果必然相同。此过程无需传输价格值，性能优异。

问：与 Empress Currency 一起使用会有冲突吗？
答：不会。本模组修改的是底层美元数值，Empress Currency 只改变显示方式，两者可同时使用。

🙏 致谢
感谢所有在调试过程中提供帮助的社区朋友。

感谢 REPOConfig 作者提供的便捷配置 UI。

感谢所有推荐模组的作者，他们的创作为玩家带来更丰富的游戏体验。

AI 辅助来自 DeepSeek。

更新日志

[2.0.8] - 2026-05-25

适配repo 0.4.4。

[2.0.7] - 2026-05-23

适配repo 0.4.3。

###[2.0.6]

• 更新：更新文档说明。

[2.0.5] - 2026-05-02

回退

• 回退 WZC_UI 联动功能，因该模组日志刷屏，无法获取有效调试信息。
• 功能恢复至 v2.0.4。

说明

• WZC_UI 反射联动技术验证（v2.0.6）已完成，方案可行。
• 因联动模组自身问题，该功能暂时搁置，待其修复后重新评估。

[2.0.4] - 2026-05-02

新增

• 单机日志中显示玩家名字，方便确认模组是否生效。

[2.0.3] - 2026-05-02

新增

• 详细日志中输出抓取物品的玩家名字。

优化

• 日志中的物品名称去除 "Valuable " 前缀和 "(Clone)" 后缀。

[2.0.2] - 2026-05-02

修复

• 修复单机模式下无法触发价格随机的问题。

新增

• 单机模式下使用 InstanceID 替代 ViewID，避免去重冲突。
• OnJoinedRoom 时自动清空缓存。

[2.0.1] - 2026-05-02

文档

• README 添加 QQ 群信息。

[2.0.0] - 2026-04-17

🚀 重大更新：网络同步彻底重写

• 全新的房主权威同步模式
  • 移除旧版 NetSync 组件，不再干扰房间初始化。
  • 价格由房主统一计算并通过 RPC 广播，确保所有客户端一致。
  • 配置通过 Photon 房间自定义属性同步，新玩家自动获取。
• 新玩家中途加入自动同步
  • 房主会向新加入的玩家补发所有已修改物品的价格。
• 详细日志输出
  • 开启 详细日志 后，控制台会显示物品名称、原价、新价、倍率。
• 稳定性提升
  • 修复旧版本导致联机房间卡死的问题。
  • 修复客户端与房主价格不一致的问题。
  • 延迟初始化 RPC 中继，避免主菜单阶段报错。

v1.9.1 (发布修正)

• 发布: 补传版本，实际代码与 v1.9.0 完全相同。之前忘了上传，现在同步。

v1.9.0 (核心库重构)

• 重构：将核心随机算法、配置模型和规则判断提取为独立库 RandomValueLib，简化主模组代码。
• 优化：主模组现在只负责 Harmony 补丁、网络同步、配置绑定和 UI 相关逻辑。
• 依赖：新增对 cn_xc-RandomValueLib-1.0.0 的依赖。
• 兼容性：完全兼容 v1.8.3 所有功能，运行逻辑不变。

v1.8.3 (代码优化与修复)

• 优化：调整网络组件初始化时机，避免在非必要情况下过早创建 PhotonView。
• 修复：解决某些情况下因网络组件未就绪导致的潜在 RPC 调用问题。
• 兼容性：完全兼容 v1.8.2，功能逻辑不变。

v1.8.2 (多人同步 + 局间随机种子)

• 核心新增：多人游戏支持！所有玩家的价格随机化结果一致，配置由主机强制统一。
• 局间变化：每局开始时会根据关卡种子混入随机计算，同一物品在不同关卡中价格倍率不同，增加重复可玩性。
• 同步机制：
  • 主机在关卡开始时通过 RPC 广播配置（倍率、黑白名单等）和种子。
  • 客户端收到后覆盖本地配置，确保计算一致性。
  • 新玩家中途加入时会自动收到当前配置和种子。
• 性能优化：沿用确定性随机算法，无需传输价格值，零网络开销。
• 兼容性：完全兼容 v1.8.1 的单人模式；多人游戏需所有玩家安装此模组。

v1.8.1 (文档更新)

• 文档：在 README 中新增“推荐搭配的模组”章节，列出用户收集整理的可一起使用的 100+ 款模组，并按主题分类。
• 兼容性：在功能特点中明确说明与 Empress Currency 同时使用互不影响。

v1.8.0 (最终稳定版 - 独立重构)

• 核心基线：基于 v1.7.0 的稳定架构，彻底移除所有外部依赖（AdvancedREPO.Config 及其 Reloaded 版本）。
• 抓取时机：回归 抓取时随机化，采用验证成功的补丁签名 GrabStarted(PhysGrabber player)，确保价格稳定生效。
• 配置系统：改用 BepInEx 原生配置，支持 REPOConfig 游戏内编辑，无需额外库。
• 性能优化：保留反射缓存机制，加入 modifiedItemIDs 确保每个物品只随机一次。
• 代码精简：吸收 v1.7.x 实验分支的经验，选择最简洁稳定的方案。

v1.7.x (实验分支 - 未公开发布)

这一系列版本记录了从 v1.7.0 到 v1.8.0 之间的技术探索，均未公开发布：

• v1.7.3：尝试公共化访问字段，因 DLL 兼容性问题放弃。
• v1.7.4：回退到反射，继续使用 AdvancedREPO.Config Reloaded。
• v1.7.5：尝试将配置同步代码内嵌到模组中。
• v1.7.6：尝试生成时随机化（Awake），被游戏覆盖。
• v1.7.7：尝试生成时随机化延迟帧（Start），效果不稳定。
• v1.7.8：回归抓取时随机化，修正补丁签名，验证成功。
• v1.7.9：优化抓取逻辑，为最终版做准备。

v1.7.2 (文档调整)

• 新增：将抖音群链接提前至 README 靠前位置，并添加“我是代码新手”声明。
• 文档：优化文档结构，提高可读性。
• 兼容性：完全兼容 v1.7.1，未改动任何功能代码。

v1.7.1 (文档调整)

• 更新：更新文档说明，仅文档调整，功能代码与 v1.7.0 完全相同。

v1.7.0 (新增公开 API)

• 新增：公开 API RandomValueAPI，包含 OnItemRandomized 事件和 GetItemPrice 方法。
• 优化：内部代码整理，原有功能完全不变。
• 兼容性：完全兼容 v1.6.3 的所有功能。

v1.6.3

• 移除：不再依赖 REPOConfig，配置同步仅通过 AdvancedREPO.Config 实现。
• 恢复：基于 v1.5.9 稳定版本，确保所有核心功能正常运作。
• 优化：简化依赖列表，降低玩家安装门槛。

v1.6.2 (内部测试版)

• 移除：移除对 REPOConfig 的依赖（未公开发布，仅内部测试）。

v1.6.1 (内部测试版)

• 调整：对颜色反馈代码进行优化（未公开发布，仅内部测试）。

v1.6.0 (内部测试版)

• 新增：价格颜色反馈功能（未公开发布，仅内部测试）。

v1.5.9

• 修复：修正了提示信息中倍率计算错误的问题。
• 优化：代码中传递原价给日志函数，确保计算准确。

v1.5.8

• 修复：将价格字段读写方式从 FieldRef 回退为传统反射，确保修改成功。
• 增强：在价格修改前后添加详细日志输出。

v1.5.7

• 性能优化：尝试使用 FieldRef 代替反射（发现兼容性问题，v1.5.8 已回退）。
• 代码精简：添加辅助方法 CreateBoolConfig 和 CreateFloatConfig。

v1.5.6

• 调整：将默认最小倍率从 0.8 改为 0.5，默认最大倍率从 2.5 改为 2.0。

v1.5.5

• 增强：模组启动时打印当前倍率值，便于确认配置加载。
• 调试：在价格计算函数中添加日志输出（仅在详细日志开启时显示）。

v1.5.4

• 修复：将所有布尔配置项的验证方式从 .Acceptable() 改为 .Range(false, true)。

v1.5.3

• 修复：为所有布尔配置项添加 .Acceptable(new bool[] { true, false }) 尝试解决范围验证错误。

v1.5.2

• 更新：更新文档说明。

v1.5.1

• 修复：在 CreateConfigEntries 中为每个配置项添加 .File("RandomValueMod.cfg") 调用，解决空引用异常。

v1.5.0

• 修复：移除了不可访问的 Sync.ApplyLocal() 调用，解决编译错误。
• 完善：确保配置同步机制正常工作，所有配置项由 AdvancedREPO.Config 自动管理。
• 版本：提升主版本号至 1.5.0，标志着配置同步架构的成熟稳定。

v1.4.9

• 重大重构：将配置系统迁移至 AdvancedREPO.Config，实现主机强制统一配置。
• 移除：所有手动编写的价格同步网络代码（RPC、超时回退等）。
• 优化：基于“确定性随机”算法，客户端独立计算相同价格，零延迟。

v1.4.8

• 增强：网络同步组件在物品生成时立即添加，确保 PhotonView 及时注册。
• 新增：客户端网络请求超时机制，默认 2 秒后回退到本地计算。

v1.4.7

• 更新：更新文档说明。

v1.4.6

• 修复：修复了 Photon RPC 参数错误，解决多人游戏同步问题。

v1.4.5

• 文档更新：更新 README，添加指向旧版（v1.3.9，含重量随机化）的链接。
• 状态声明：明确声明旧版软件包已被标记为已弃用。

v1.4.4

• 多人游戏优化：改进网络同步机制，添加客户端请求跟踪和重试机制。
• 性能优化：网络请求清理机制，定期清理过期请求。

v1.4.3

• 重大优化：大幅减少 Harmony 补丁数量，只补丁关键的抓取相关方法。
• 性能修复：解决了游戏卡顿问题。

v1.4.2

• 功能重构：将随机化时机从物品生成时改为抓取时。
• 新增功能：抓取时触发价格随机化。

v1.4.1

• 修复：添加详细调试日志，帮助排查抓取物品无反应的问题。

v1.4.0

• 重构：移除所有重量随机化相关代码，专注于价格随机化。
• 说明：重量修改易引发兼容性问题，故删除。

v1.3.13

• 修复：静态类中的 Logger 调用错误，解决编译错误。

v1.3.12

• 改进：网络同步代码，修复了双向同步的逻辑问题。

v1.3.11

• 改进：网络同步组件的双向网络同步机制。

v1.3.10

• 修复：主机与客户端单向同步问题，实现双向网络同步。

v1.3.9

• 更新：更新文档说明。

v1.3.8

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

v1.3.7

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

v1.3.6

• 重构：移除所有重量和价格的默认值设置，完全尊重游戏原始数据。

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

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