随机贵重物品的价格 🎮

注：本模组网络同步代码和说明文件由 DeepSeek AI 辅助生成

灵感来源：

• 随机化的想法最初来源于 RandomWeightMod
• 配置同步功能基于 AdvancedREPO.Config 实现

一个为《REPO》游戏设计的独立模组，专注于在第一次抓取贵重物品时随机化其价格，增加游戏的变数和重玩价值！

作者: dyxc666
版本: v1.5.1
最后更新: 2026年2月23日

---

📢 关于旧版本

重要：本模组是全新发布的独立模组，与先前同样由我发布的 RandomWeightAndValueMod 无关。

• 旧版链接: RandomWeightAndValueMod v1.3.9（已弃用）
• 弃用原因: 旧版同时包含重量与价格随机化，因重量修改涉及复杂的物理引擎，维护成本高且易引发兼容性问题。
• 迁移建议: 所有旧版用户请完全卸载旧模组，并使用此全新模组以获得更稳定、更专注的价格随机化体验。

---

✨ 功能特点

• 🎲 抓取时随机化：物品在被玩家抓取时才触发价格随机化，提供真正的“惊喜”体验，每个物品仅生效一次。
• ⚙️ 高度可配置：价格随机变化范围可自由调节（0.1倍～10.0倍），满足不同难度需求。
• 🛡️ 黑白名单系统：通过关键词精确控制哪些物品被随机化，支持黑/白名单模式。
• 💰 现金袋保护：默认不随机化提取点奖励的现金袋，可通过配置开关启用。
• 🌐 主机强制统一配置：所有玩家的配置（倍率、黑白名单等）由主机自动同步，确保多人游戏中体验完全一致。
• 🚀 零网络开销：基于“确定性随机”算法，每个客户端独立计算相同价格，无需传输价格数值。
• 📋 详细日志：可配置的详细日志输出，便于调试和问题排查。

---

📥 安装方法

自动安装（推荐）

1. 安装 Thunderstore Mod Manager 或 r2modman。
2. 在应用内搜索 “随机贵重物品的价格” 并点击安装。
3. 安装程序会自动处理所有依赖项（包括 AdvancedREPO.Config）。

手动安装

1. 确保已安装 BepInEx 5、REPOConfig 1.2.3+ 和 AdvancedREPO.Config 1.0.2+。
2. 下载最新版本的模组压缩包。
3. 将其解压到《REPO》的游戏根目录（即包含 BepInEx 文件夹的目录）。

---

⚙️ 配置说明

所有设置均可通过 REPOConfig 图形界面 调整：

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

主要配置项说明

分类	配置项	说明与默认值
基础设置	随机化物品价格	是否随机化贵重物品的价格 (默认: true)
价格设置	最小价格倍率	价格的最小倍率 (默认: 0.8，即原价的80%)
	最大价格倍率	价格的最大倍率 (默认: 2.5，即原价的250%)
黑白名单	启用黑名单模式	启用黑名单，匹配的物品将不被随机化 (默认: true)
	黑名单关键词	逗号分隔的关键词列表，留空表示无黑名单 (默认: 空)
	启用白名单模式	启用白名单，只有匹配白名单的物品才会被随机化 (默认: false)
	白名单关键词	逗号分隔的关键词列表，留空表示所有物品 (默认: 空)
特殊排除规则	现金袋随机化	如果为true，则现金袋也会被随机化 (默认: false)
	排除高价物品	不随机化价格超过阈值的物品 (默认: false)
	高价物品阈值	价格超过此值的物品不随机化 (默认: 50000)
调试设置	详细日志输出	输出每个物品修改前后的具体数值 (默认: false)
	强制刷新UI	尝试强制刷新UI显示 (默认: true)

注意：网络相关配置（如“启用网络同步”、“网络超时”）已移除，因为配置同步由 AdvancedREPO.Config 自动处理，无需手动设置。

---

🎮 使用指南

单人游戏

1. 安装模组后启动游戏。
2. 进入任意关卡。
3. 抓取贵重物品时会自动随机化其价格，并在控制台显示提示。
4. 可在游戏内设置菜单中随时调整配置。

多人游戏

⚠️ 重要提示：主机强制统一配置（v1.5.1）

v1.5.1 版本修复了配置构建时的空引用错误，并完善了配置同步机制：

• ✅ 主机修改配置：所有更改会自动通过 RPC 同步给所有客户端。
• ✅ 客户端无需额外设置：客户端的配置会跟随主机更新，无需手动修改。
• ✅ 确定性随机：由于配置统一，每个客户端独立计算的价格完全相同，无需传输价格值，零网络延迟。

1. 所有玩家必须安装相同版本的模组（包括 AdvancedREPO.Config 前置）。
2. 主机启动游戏后，其配置即为全房间的统一配置。
3. 客户端在游戏中无法修改同步的配置项（修改后会被主机的值覆盖），确保一致性。
4. 抓取物品时，每个客户端独立计算价格，结果自然一致。

配置示例

• 轻度随机化：价格倍率 0.9 – 1.5（适合新手）
• 疯狂模式：价格倍率 0.1 – 10.0（高风险高回报）
• 稳定模式：价格倍率 0.5 – 2.0（平衡体验）

---

🔧 故障排除

常见问题

Q：模组没有生效？
A：请按顺序检查：

1. 游戏启动时是否有BepInEx控制台窗口？
2. 是否安装了所有依赖（REPOConfig、AdvancedREPO.Config）？
3. 在REPOConfig菜单中是否已启用“随机化物品价格”？

Q：为什么有些物品没有随机化？
A：可能原因：

• 该物品名称匹配了黑名单关键词。
• 该物品是现金袋，且未开启“现金袋随机化”。
• 该物品已被抓取过（每个物品仅生效一次），重新进入关卡会重置。

Q：多人游戏中配置没有同步？
A：请尝试以下步骤：

1. 确认所有玩家安装了 AdvancedREPO.Config（版本 ≥ 1.0.2）。
2. 主机修改配置后，等待几秒观察客户端是否变化。
3. 检查控制台是否有 AdvancedREPO.Config 的同步日志（需开启该模组的调试日志）。
4. 如果仍不同步，可能是网络问题，尝试重新加入游戏。

Q：这个模组和之前的 RandomWeightAndValueMod 是什么关系？
A：这是一个完全独立的全新模组，专注于价格随机化，不再包含重量修改功能。旧版模组因技术原因已弃用，强烈建议所有玩家使用此新版。旧版链接：RandomWeightAndValueMod v1.3.9（已标记弃用）。

Q：v1.5.1 主要改进了什么？
A：修复了配置构建时的空引用异常（需指定配置文件），确保模组在启动时正常加载。配置同步功能已完全稳定，推荐所有玩家更新。

---

📜 更新日志摘要

版本	重点内容
v1.5.1	修复空引用错误：为每个配置项添加 .File() 调用，确保配置正确构建
v1.5.0	修复访问错误：移除多余 Sync.ApplyLocal() 调用
v1.4.9	重构配置同步：改用 AdvancedREPO.Config，主机统一配置
v1.4.8	增强网络同步：预加载组件、超时回退
v1.4.0	初始版本发布，专注价格随机化

完整更新日志请参阅随模组附带的 CHANGELOG.md 文件。

---

说明文件由DeepSeekAI辅助生成，如有问题欢迎反馈。