随机贵重物品的价格 🎮

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

灵感来源：

• 随机化的想法最初来源于 RandomWeightMod
• 网络同步功能参考自 Walkie Talkies 模组

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

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

---

📢 关于旧版本

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

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

---

✨ 功能特点

• 🎲 抓取时随机化：物品在被玩家抓取时才触发价格随机化，提供真正的“惊喜”体验，每个物品仅生效一次。
• ⚙️ 高度可配置：价格随机变化范围可自由调节（0.1倍～10.0倍），满足不同难度需求。
• 🛡️ 黑白名单系统：通过关键词精确控制哪些物品被随机化，支持黑/白名单模式。
• 💰 现金袋保护：默认不随机化提取点奖励的现金袋，可通过配置开关启用。
• 🌐 多人游戏同步：完整的网络同步功能，支持主机与客户端双向同步（v1.4.8 增强版）。
• ⏱️ 网络超时回退：客户端等待服务器响应超时后自动应用本地计算的价格，避免卡死。
• 🚀 高性能设计：仅补丁关键的抓取方法，极小性能开销，无游戏卡顿。
• 📋 详细日志：可配置的详细日志输出，便于调试和问题排查。

---

📥 安装方法

自动安装（推荐）

1. 安装 Thunderstore Mod Manager 或 r2modman。
2. 在应用内搜索 “随机贵重物品的价格” 并点击安装。

手动安装

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

---

⚙️ 配置说明

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

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

主要配置项说明

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

---

🎮 使用指南

单人游戏

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

多人游戏

⚠️ 重要提示：多人游戏同步优化（v1.4.8）

v1.4.8 版本大幅增强了网络同步的稳定性：

• ✅ 网络组件预加载：物品生成时立即注册PhotonView，避免组件缺失。
• ✅ 客户端超时回退：默认等待2秒，若未收到主机响应，自动使用本地计算的价格，保证游戏流畅。
• ✅ 详细调试日志：开启“网络调试日志”可查看完整的RPC交互过程。

1. 所有玩家必须安装相同版本的模组（建议使用最新版v1.4.8）。
2. 网络同步功能默认启用。
3. 主机随机化物品后，价格会自动同步给所有客户端。
4. 客户端抓取物品时，会向主机请求同步；若网络延迟或丢包，超时后客户端将自动回退到本地计算的价格，并正常显示。

配置示例

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

---

🔧 故障排除

常见问题

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

1. 游戏启动时是否有BepInEx控制台窗口？
2. 是否安装了REPOConfig并确保其版本 ≥ 1.2.3？
3. 在REPOConfig菜单中是否已启用“随机化物品价格”？

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

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

Q：多人游戏同步失败怎么办？
A：请尝试以下步骤：

1. 确认所有玩家使用完全相同的模组版本（版本号必须一致）。
2. 在模组设置中开启“网络调试日志”，观察控制台输出。
3. 如果频繁超时，可适当增加“网络超时”值（如 3.0 秒）。
4. 若仍无法同步，可暂时关闭“启用网络同步”，此时各玩家独立随机化（价格可能不同）。

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

Q：v1.4.8 主要改进了什么？
A：针对多人游戏同步问题，增加了网络组件预加载和客户端超时回退机制，大幅提升同步成功率与游戏流畅度。这是目前最稳定的版本，强烈推荐所有玩家更新。

---

📜 更新日志摘要

版本	重点内容
v1.4.8	增强网络同步：预加载组件、超时回退、更详细的调试日志
v1.4.6	修复RPC参数错误，多人游戏同步基础功能可用
v1.4.2	核心机制改为“抓取时随机化”
v1.4.0	初始版本发布，专注价格随机化

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

---

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