📘 README.md markdown

随机贵重物品的价格

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

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

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

📢 加入讨论

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

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

📖 概述

一个为《REPO》游戏设计的独立模组，专注于在第一次抓取贵重物品时随机化其价格，增加游戏的变数和重玩价值！主机配置自动同步给所有客户端，确保多人游戏中体验完全一致。

v1.7.1 新增：抖音群聊 & 新手声明
现在你可以通过抖音群与作者和其他玩家交流反馈，作者也坦诚自己是代码新手，欢迎大家共同进步。

v1.7.0 新增：公开 API
其他模组开发者可以订阅价格随机化事件，或主动查询物品的原始/随机价格，方便实现扩展功能（如网络同步、视觉反馈、数据分析等）。

✨ 功能特点

• 🎲 抓取时随机化：物品在被玩家抓取时才触发价格随机化，每个物品仅生效一次。
• ⚙️ 高度可配置：价格随机变化范围可自由调节（0.1倍～10.0倍）。
• 🛡️ 黑白名单系统：通过关键词精确控制哪些物品被随机化。
• 💰 现金袋保护：默认不随机化提取点奖励的现金袋（可配置）。
• 🌐 主机强制统一配置：所有玩家的配置（倍率、黑白名单等）由主机自动同步。
• 🚀 零网络开销：基于“确定性随机”算法，每个客户端独立计算相同价格，无需传输价格值。
• 📋 详细日志：可配置的详细日志输出，便于调试。
• 🔌 公开 API：供其他模组监听价格变化事件。

📥 安装方法

自动安装（推荐）

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

手动安装

1. 安装 BepInEx 5（版本 5.4.2100 或更高）。
2. 确保已安装依赖：AdvancedREPO.Config 1.0.2+。
3. 将本模组的 RandomValueMod.dll 放入 BepInEx/plugins/ 文件夹。
4. 启动游戏一次以生成配置文件，然后关闭游戏。

⚙️ 配置说明

启动一次游戏后，配置文件位于：
BepInEx/config/RandomValuablePrice/RandomValuablePrice.cfg

注意：本模组已移除对 REPOConfig 的依赖，所有配置均通过独立的配置文件进行。如需修改，请直接编辑上述文件。

🔌 公开 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);
🎮 使用方法
单人游戏
安装模组后启动游戏。

进入任意关卡。

抓取贵重物品时会自动随机化其价格，并显示提示。

多人游戏
主机安装并配置模组，其配置会自动同步给所有客户端。

客户端无需安装模组（但安装后也可获得配置同步）。

所有玩家独立计算价格，结果一致（无需网络传输价格值）。

❓ 常见问题
问：为什么我的配置项不在 REPOConfig 里显示？
答：本模组已移除对 REPOConfig 的依赖，配置项存储在独立配置文件中，请直接编辑 BepInEx/config/RandomValuablePrice/RandomValuablePrice.cfg。

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

问：v1.7.1 兼容之前的版本吗？
答：完全兼容，v1.7.1 仅调整了文档位置并添加了新手声明，未改动任何功能代码。

问：这个模组支持多人游戏吗？
答：理论上支持，但由于开发环境限制，本模组未经多人环境充分测试。如果你在多人游戏中遇到问题，欢迎反馈，但无法保证完美兼容。

🙏 致谢
AdvancedREPO.Config 模组（作者：PotatoePet）提供的配置同步框架

AI 辅助来自 DeepSeek

如有问题，请在模组页面反馈或加入抖音群讨论。

text

更新日志

[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

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