Communities

R.E.P.O.RandomValueMod1.5.9

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

2 months ago

Downloads

5.3K

Size

126KB

Dependency string

cn_xc-RandomValueMod-1.5.9

Download

Details Required (3)Versions

随机贵重物品的价格 🎮

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

灵感来源：

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

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

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

📢 关于旧版本

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

旧版链接: RandomWeightAndValueMod v1.3.9（已弃用）

弃用原因: 旧版同时包含重量与价格随机化，因重量修改涉及复杂的物理引擎，维护成本高且易引发兼容性问题。

迁移建议: 所有旧版用户请完全卸载旧模组，并使用此全新模组以获得更稳定、更专注的价格随机化体验。

✨ 功能特点

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

📥 安装方法

自动安装（推荐）

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

手动安装

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

⚙️ 配置说明

重要提醒：为什么不能用 REPOConfig 修改？

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

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

如何修改配置？

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

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

配置项列表及说明

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

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

🎮 使用指南

单人游戏

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

多人游戏

✅ v1.5.9 修复版

主机修改配置：主机编辑配置文件并保存后，所有更改会自动通过 RPC 同步给所有客户端。

客户端无需额外设置：客户端的配置会跟随主机更新，请勿修改客户端配置文件，否则会被主机的值覆盖。

确定性随机：由于配置统一，每个客户端独立计算的价格完全相同，无需传输价格值，零网络延迟。

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

配置示例

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

🔧 故障排除

常见问题

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

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

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

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

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

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

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

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

Q：v1.5.9 主要改进了什么？
A：本次为日志显示修正：

修复了提示信息中倍率总是显示为1.0的错误，现在倍率会正确显示价格变化倍数。
功能与 v1.5.8 完全一致，仅修正显示问题。

📜 更新日志摘要

版本	重点内容
v1.5.9	修复：日志中倍率显示错误（总是1.0），现在正确显示
v1.5.8	修复价格随机化未生效问题（回退反射，增加调试日志）
v1.5.7	性能优化：尝试使用 `FieldRef`（发现兼容性问题）
v1.5.6	调整默认倍率为 `0.5-2.0`（稳定模式），更新文档
v1.5.5	增加调试日志，打印当前配置倍率及随机化乘数
v1.5.4	修复范围验证错误；完善文档说明配置方式
v1.5.3	修复范围验证错误（尝试使用 `.Acceptable()` 未完全解决）
v1.5.2	更新文档说明
v1.5.1	修复空引用错误：为每个配置项添加 `.File()` 调用
v1.5.0	修复访问错误：移除多余 `Sync.ApplyLocal()` 调用

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

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