cn_xc-RandomValueMod icon

RandomValueMod

随机化贵重物品价格,增加游戏变数和重玩价值。可配置黑白名单、现金袋保护等。

By cn_xc
Last updated a day ago
Total downloads 106
Total rating 1 
Categories Mods Valuables Client-side Server-side
Dependency string cn_xc-RandomValueMod-1.4.5
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100
nickklmao-REPOConfig-1.2.3 icon
nickklmao-REPOConfig

Edit mod configs in-game!

Preferred version: 1.2.3

README

RandomValueMod 🎮

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

灵感来源

一个为《REPO》游戏设计的模组,可在你第一次抓取贵重物品时,随机化其价格,增加游戏的变数和重玩价值!

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


🚀 重要版本变更

v1.4.0:移除重量随机化功能 ⚖️

在 v1.4.0 版本中,我们做出了一个重要的架构调整:移除了重量随机化功能。这是基于以下原因:

  1. 技术稳定性优先

    • 重量修改涉及复杂的物理引擎和预设系统,容易引发不可预测的运行时错误
    • 重量相关的反射代码在多版本游戏更新中频繁出现兼容性问题
    • 网络同步中重量数据的稳定性难以保证
  2. 专注核心体验

    • 价格随机化是玩家更关注的游戏机制
    • 简化代码结构,提升模组整体稳定性
    • 减少配置选项的复杂性,让用户更易理解和配置
  3. 维护性考虑

    • 重量相关代码占据了大量维护时间
    • 每次游戏更新都可能需要重新适配物理引擎修改
    • 删除重量功能后,模组将更轻量、更稳定

当前模组仅保留价格随机化功能,这仍然是模组的核心价值所在。如果你需要重量随机化,建议使用专门的物理修改模组。

📄 关于旧版本 (v1.3.9)

注意:此前在Thunderstore上发布的 v1.3.9 版本 是一个同时包含重量和价格随机化的旧版模组。

  • 旧版链接: RandomWeightAndValueMod v1.3.9
  • 当前状态: 该软件包已被标记为已弃用 (This package has been marked as deprecated)。建议所有用户迁移至本页面提供的最新版本。

v1.4.0 开始,本模组已移除重量随机化功能,专注于提供更稳定、性能更好的价格随机化体验。


✨ 功能特点

  • 抓取时随机化:物品在被玩家抓取时才触发价格随机化,提供真正的"惊喜"体验
  • 高度可配置:价格的随机变化范围可自由调节(0.1倍 - 10.0倍)
  • 一次生效:每个物品只在第一次被抓取时修改,避免重复随机化
  • 黑白名单系统:通过关键词精确控制哪些物品被随机化
  • 现金袋保护:默认不随机化提取点奖励的现金袋(可通过配置开关控制)
  • 多人游戏同步:完整的网络同步功能,支持主机与客户端双向同步
  • 多人游戏优化:RPC重试机制、客户端请求跟踪、定期清理过期请求
  • 高性能设计:仅补丁关键抓取方法,避免游戏卡顿
  • 详细日志:可配置的详细日志输出,便于调试和问题排查
  • 兼容性优化:解决与REPOConfig的依赖问题,与其他主流模组兼容

📥 安装方法

自动安装(推荐)

  1. 安装 Thunderstore Mod Managerr2modman
  2. 在应用内搜索 RandomValueMod 并点击安装

手动安装

  1. 确保已安装 BepInEx 5REPOConfig 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)
调试设置 详细日志输出 输出每个物品修改前后的具体数值 (默认: false)
强制刷新UI 尝试强制刷新UI显示 (默认: true)

🎮 使用指南

单人游戏

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

多人游戏

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

网络同步功能已在 v1.4.4 版本中优化,但尚未经过多人游戏环境下的全面测试。如果您在多人游戏中遇到同步问题,请:

  • 确保所有玩家使用相同版本模组
  • 尝试关闭网络同步功能进行排查
  • 开启网络调试日志查看具体同步过程
  1. 网络同步功能默认启用,确保所有玩家都安装相同版本的模组
  2. 主机随机化物品后,结果会自动同步给所有客户端玩家
  3. 客户端抓取物品时,会请求主机同步随机化结果
  4. 可在设置中关闭网络同步,各客户端将独立计算随机化结果

配置示例

  1. 轻度随机化:价格倍率 0.9-1.5(适合新手)
  2. 疯狂模式:价格倍率 0.1-10.0(高风险高回报)
  3. 稳定模式:价格倍率 0.5-2.0(平衡体验)

🔧 故障排除

常见问题

Q:模组没有生效 A:检查以下内容:

  1. 确认BepInEx正确加载(游戏启动时有BepInEx控制台)
  2. 确认REPOConfig已安装
  3. 在游戏设置中确认模组已启用

Q:为什么有些物品没有随机化? A:

  1. 检查该物品是否在黑名单中
  2. 现金袋默认受保护,可在设置中关闭此选项
  3. 每个物品仅首次抓取时随机化,重新进入关卡会重置

Q:会和修改器或其他模组冲突吗? A:通常情况下不会。如遇到问题,请尝试调整配置或暂时禁用其他模组进行排查。

Q:如何查看模组是否正常工作? A:在配置中将"启用详细日志"设为true,然后在游戏控制台中查看抓取物品时的修改日志。

Q:多人游戏同步失败怎么办? A:

  1. 检查所有玩家是否都安装了此模组
  2. 确保网络同步设置已启用
  3. 开启网络调试日志查看具体同步过程

Q:为什么移除了重量随机化功能? A:重量随机化涉及复杂的物理引擎修改,在多版本更新中频繁出现问题。为了模组的长期稳定性和维护性,我们决定专注于价格随机化这一核心功能。如果你需要重量修改,建议使用专门的物理修改模组。

Q:多人游戏测试过吗? A:v1.4.4版本的网络同步代码已经过优化,包含重试机制和客户端请求跟踪,但尚未在真实多人游戏环境中进行全面测试。我们建议在多人游戏中使用时开启网络调试日志,以便排查可能的同步问题。


说明文件由DeepSeekAI辅助生成