随机贵重物品的价格 🎮

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

灵感来源：

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

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

作者: dyxc666
版本: v1.5.6
最后更新: 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 修改？

本模组从 v1.5.0 开始改用 AdvancedREPO.Config 框架来实现主机配置的自动同步。该框架创建的配置项（ConfigField）是独立实现的，为了支持网络同步，它绕过了 BepInEx 的标准配置系统。

• REPOConfig 只能识别通过 BepInEx 标准 Config.Bind 创建的配置项，因此本模组的配置不会出现在 REPOConfig 的图形界面中。
• 这是设计上的取舍：为了获得“主机强制统一配置”和“零网络开销”的优势，暂时牺牲了 REPOConfig 的兼容性。

如何修改配置？

所有配置项都存储在独立的配置文件中，您需要直接编辑文件：

1. 打开游戏根目录下的 BepInEx/config/RandomValuablePrice/ 文件夹。
2. 找到 RandomValuablePrice.cfg 文件，用记事本或任何文本编辑器打开。
3. 修改对应的值（例如 最小价格倍率、黑白名单关键词 等），保存文件。
4. 如果是主机，修改后配置会自动同步给所有客户端；如果是客户端，配置文件会被主机的值覆盖，无需手动修改。

配置项列表及说明

注意：默认配置为 稳定模式（倍率 0.5 – 2.0），平衡游戏体验。您可以根据喜好调整。

🎮 使用指南

单人游戏

1. 安装模组后启动游戏。
2. 进入任意关卡。
3. 抓取贵重物品时会自动随机化其价格，并在控制台显示提示。
4. 按照上文的“配置说明”修改配置文件以调整设置。

多人游戏

✅ v1.5.6 稳定版

• 主机修改配置：主机编辑配置文件并保存后，所有更改会自动通过 RPC 同步给所有客户端。
• 客户端无需额外设置：客户端的配置会跟随主机更新，请勿修改客户端配置文件，否则会被主机的值覆盖。
• 确定性随机：由于配置统一，每个客户端独立计算的价格完全相同，无需传输价格值，零网络延迟。

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

配置示例

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

🔧 故障排除

常见问题

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

1. 游戏启动时是否有BepInEx控制台窗口？
2. 是否安装了所有依赖（REPOConfig、AdvancedREPO.Config）？
3. 在 BepInEx/config/RandomValuablePrice/RandomValuablePrice.cfg 中确认配置是否正确。

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

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

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

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

Q：为什么不能用 REPOConfig 修改配置？
A：本模组从 v1.5.0 开始使用 AdvancedREPO.Config 实现主机强制统一配置，该框架创建的配置项不兼容 REPOConfig。请按照上文的“配置说明”手动编辑配置文件。

Q：如果我想用回 REPOConfig 修改配置，该怎么办？
A：您可以考虑回退到旧版本（如 v1.4.8），但那样会失去主机统一配置的特性（每个玩家独立配置，随机价格可能不一致）。请根据您的需求选择合适版本。

Q：v1.5.6 主要改进了什么？
A：将默认倍率调整为 0.5 – 2.0（稳定模式），平衡游戏体验，并在文档中明确说明。同时保留了 v1.5.5 增加的调试日志，便于问题排查。

📜 更新日志摘要

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

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