cn_xc-RandomValueMod icon

RandomValueMod

抓取时随机化贵重物品价格。支持黑白名单、现金袋保护、详细日志。配置采用 BepInEx 原生系统,支持 REPOConfig 游戏内编辑。

By cn_xc
Last updated 3 days ago
Total downloads 3069
Total rating 1 
Categories Mods Valuables Client-side Server-side
Dependency string cn_xc-RandomValueMod-1.8.3
Dependants 2 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

📄 README.md markdown

随机贵重物品的价格

作者: dyxc666
版本: v1.8.3
最后更新: 2026年3月15日
注:本模组代码由 DeepSeek AI 辅助生成,经过多轮调试最终稳定。


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

本模组主要针对单人游戏环境开发和测试,核心机制(抓取时价格随机化)理论上可在多人游戏中工作,但未经充分多人环境测试。如果你在多人游戏中遇到问题(如同步失败、配置不生效等),欢迎在模组页面反馈,但请注意目前无法保证完美兼容。


📢 加入讨论

我是代码新手,欢迎大佬们指点!
有任何问题、建议或想交流模组心得,欢迎加入我的抖音群:

🔗 抖音群链接https://v.douyin.com/group/132508564374
(复制链接到浏览器打开或直接在抖音中搜索群号)


📖 概述

一个为《REPO》游戏设计的独立模组,专注于在第一次抓取贵重物品时随机化其价格,增加游戏的变数和重玩价值!配置采用 BepInEx 原生系统,可通过 REPOConfig 在游戏内直接编辑,无需手动修改文件。

v1.8.3 更新

  • 🛠️ 代码优化与修复,提升稳定性。

v1.8.2 新增

  • 🎮 多人游戏同步:主机配置强制统一,所有玩家价格一致,支持中途加入。
  • 🎲 局间随机种子:每局价格风格不同,避免重复感。

v1.8.1 更新

  • 📄 新增“推荐搭配的模组”章节,列出用户收集整理的可一起使用的 100+ 款模组,并按主题分类。

v1.8.0 最终特性

  • 🎲 抓取时随机化:物品在被玩家抓取时才触发价格随机化,每个物品仅生效一次。
  • ⚙️ 高度可配置:价格随机变化范围可自由调节(0.1倍~10.0倍)。
  • 🛡️ 黑白名单系统:通过关键词精确控制哪些物品被随机化。
  • 💰 现金袋保护:默认不随机化提取点奖励的现金袋(可配置)。
  • 📋 详细日志:可配置的详细日志输出,便于调试。
  • 🧩 REPOConfig 支持:可在游戏主菜单中直接修改配置(需安装 REPOConfig)。

✨ 功能特点

  • 抓取时触发:价格在玩家抓取物品瞬间随机,与游戏内其他修改不冲突。
  • 确定性随机:基于物品实例 ID 生成随机数,同一物品每次游戏价格固定(联机时各客户端独立计算)。
  • 黑白名单:通过关键词灵活控制哪些物品被排除或仅哪些物品生效。
  • 现金袋独立开关:保护重要的现金袋不被意外随机化。
  • 性能优化:使用缓存确保每个物品只随机一次,不影响游戏性能。
  • 完全独立:不再依赖任何外部配置同步库,配置由 BepInEx 原生管理。
  • 多人同步:所有玩家共享主机配置,基于确定性随机算法独立计算,价格完全一致。新玩家中途加入时会自动同步。
  • 局间变化:每局使用不同随机种子,让同一物品在不同关卡中价格范围波动,增强重复可玩性。
  • 兼容性:可与大量新增贵重物品模组、新关卡模组及特殊机制模组一同使用(详见下方列表)。本模组与 Empress Currency 同时使用互不影响。

📥 安装方法

自动安装(推荐)

  1. 安装 Thunderstore Mod Managerr2modman
  2. 搜索 随机贵重物品的价格 作者 dyxc666 并安装。
  3. 启动游戏一次以生成配置文件,然后关闭游戏。

手动安装

  1. 安装 BepInEx 5(版本 5.4.2100 或更高)。
  2. 将本模组的 RandomValueMod.dll 放入 BepInEx/plugins/ 文件夹。
  3. (可选但推荐)安装 REPOConfig,以便在游戏中直接修改配置。
  4. 启动游戏,配置会自动生成。

多人游戏注意事项

  • 所有玩家必须安装相同版本的模组。
  • 主机的配置(倍率、黑白名单等)将强制同步给所有客户端,客户端无需手动调整。
  • 如果遇到不同步问题,请检查网络连接并确保所有玩家模组版本一致。

⚙️ 配置说明

启动一次游戏后,配置文件位于:
BepInEx/config/RandomValueMod.cfg
(如果安装了 REPOConfig,可在游戏主菜单中直接编辑)

配置项 说明 默认值
随机化物品价格 是否随机化贵重物品的价格 true
最小价格倍率 价格的最小倍率(0.1–5.0) 0.5
最大价格倍率 价格的最大倍率(0.5–10.0) 2.0
启用黑名单模式 启用黑名单,匹配的物品将不被随机化 true
黑名单关键词 逗号分隔的关键词列表(如 keycard,computer
启用白名单模式 启用白名单,只有匹配白名单的物品才会被随机化 false
白名单关键词 逗号分隔的关键词列表
排除高价物品 不随机化价格超过阈值的物品 false
高价物品阈值 价格超过此值的物品不随机化 50000
现金袋随机化 如果为true,则现金袋也会被随机化 false
详细日志输出 输出每个物品修改前后的具体数值 false

注意:本模组不再依赖任何外部配置同步库,所有配置由 BepInEx 原生管理。


🧩 推荐搭配的模组(用户收集整理)

以下模组可能与 RandomValueMod 兼容,部分模组的特殊物品效果不受价格随机化影响,但两者机制可共存。按主题分类排列。

🧱 LEGO 系列

模组名称 作者 简要描述
LEGO DarthVader Kazzy 添加乐高达斯·维达人偶作为贵重物品(带光剑)。
LEGOBatman Kazzy 添加乐高蝙蝠侠人偶作为贵重物品。
LEGOHomerSimpson Kazzy 添加乐高荷马·辛普森人偶作为贵重物品。
LEGOSpiderMan Kazzy 添加乐高蜘蛛侠人偶作为贵重物品。
LEGOSkeleton Kazzy 添加乐高骷髅人偶作为贵重物品。
LEGODinoValuables Zehs 添加乐高恐龙作为贵重物品(梁龙、双脊龙、暴龙、沧龙等)。

🏰 任天堂 / 经典 IP 系列

模组名称 作者 简要描述
ZeldaValuables MinamiIzumiVT 添加约 56 个《塞尔达传说》系列主题物品,如卢比、三角力量等。
WindysOOTValuables Wind_Caller 添加16个《塞尔达传说:时之笛》主题物品,部分带互动功能。
Pokeball Valuables Disciple 添加各种精灵球主题的贵重物品。
PokemonValuables Foop 添加 18 种宝可梦作为贵重物品。
MINE EnterTheBoi 添加大量《我的世界》方块作为贵重物品,包括岩石、混凝土、矿石等。
MinecraftMod Meliodin Minecraft主题贵重物品扩展模组(已适配怪物更新,待添加新内容)。
MinecraftStrongholdLevel AriIcedT 添加《Minecraft》要塞主题新地图(早期测试版)。
Minecraft Cave Rogue 添加《Minecraft》洞穴主题新关卡,含28个模块和20个新贵重物品。
Peachs Castle Level Mod Skydorm 添加《超级马里奥》桃子城堡主题新关卡,含21个房间和47个新贵重物品,带机关。
FNAF1Valuables Unbe 添加《FNAF初代》主题物品,如弗雷迪麦克风、邦尼吉他、黄金弗雷迪(有互动)等。
FNAF2Valuables Unbe 添加《FNAF2》主题物品,如玩具玩偶、备用骨架、废弃摄像机系统等,部分有互动。
FNAFLevel OrtonLongGaming 添加《FNAF》主题大型新地图,含新房间和贵重物品。
KHValuables DaniKH 添加11个《王国之心》系列主题贵重物品(Wayfinder、冰激凌等)。
StarTrekValuables Gongo 添加30多种《星际迷航》主题收藏品,部分带自定义音效。
PortalCore Valuables Omniscye 添加3个《传送门》核心角色作为可互动贵重物品,带近2000行语音和特殊效果。

🎮 游戏联动系列(其他游戏)

模组名称 作者 简要描述
LethalCompanyValuables Zehs 将《致命公司》中的30种废品作为贵重物品加入游戏。
Lethal Plushies Spoopylocal 将《Lethal Company》怪物做成毛绒玩具作为贵重物品。
AbioticFactorValuables Nikki 添加《异星工厂》的35个贵重物品和5个商店物品。
Satisfactory Valuables Bene 添加30+种《幸福工厂》主题工业材料,如 Mercer Sphere、各种锭等。
HSRItems revsolo 添加20多种《崩坏:星穹铁道》主题物品,部分带自定义音效。
HSRCatCakes revsolo 添加92种《崩坏:星穹铁道》主题猫蛋糕,部分带有互动音效。
HSRChimeras revsolo 添加14种《崩坏:星穹铁道》主题奇美拉,部分带互动音效。
MODPACK ZZZ Valuables La_Camotiza 添加38个《绝区零》女性角色作为可收集贵重物品。
Unique Potions Yuckers 添加7种具有特殊效果(反重力、加价、治疗等)的贵重药水。
REPOing Valuables Rangerbb275 添加25个新贵重物品,其中6个带自定义功能(如爆炸)。
Wesleys Valuables Magic_Wesley 添加大量风格贴近原版的贵重物品。
Wesleys Manufacturer of Style Magic_Wesley 受Crocs委托制作,添加新关卡及28种带增益效果的鞋子。
Jake and Livs Retro Smashpack Jake_n_Liv 添加超过200个来自经典游戏的怀旧收藏品。
SteampunkItems s1ckboy 添加6个蒸汽朋克风格的贵重物品,部分有独特互动(如时间操控)。
Sea of Thieves ZARP 添加《盗贼之海》中的多种物品作为贵重物品,如朗姆酒瓶、骷髅、宝箱等。
TheFinalsValuables huxsTF 添加《The Finals》主题物品(Cashout Station、Cashbox、Ospuze Can)。
Valorant Valuables SadTocino 添加《Valorant》主题贵重物品(特工钥匙扣、玩具刀、炸弹等)。
Mo Valuables SadTocino 添加《Valorant》主题及工具类贵重物品(CD、螺丝刀、硬盘、军靴等)。
Splatoon Valuables VentiVR 添加《斯普拉遁》系列收藏品(Moai、Clam、Gold Record、Power Egg等)。
Transformers Devastation Valuables Kaiserissimus 添加34个《变形金刚:毁灭》角色动作人偶作为贵重物品。
SpongeBobValuables SargentNeo 添加《海绵宝宝》主题贵重物品(金铲子、派大星的袜子、闪闪发光物、小裤裤等)。
The Stanley Parable Ultra Deluxe Level John_Epic_Team 基于《史丹利的寓言》的大型主题关卡,含67个房间和30个新贵重物品。
RunescapeValuables ProfessorPlum 添加《Runescape》主题物品(符文、武器、雕像等)作为贵重物品和武器。
MinecraftBlocks wipsmh 添加《Minecraft》方块作为贵重物品。
ApertureScienceEnrichmentValuables TripleABattery 添加《传送门》主题物品(炮塔、立方体、蛋糕等)。
HalfLifeProps FurranyStudio 添加《半条命》主题的杂物、物品和武器。
ShittyValuables Nesu 添加来自Minecraft、Undertale、Homestuck等作品的粉丝向趣味物品(熔岩鸡、灵魂、Sburb)。
WafflesValuables WaffleGM 添加多种游戏联动物品(马里奥、塞尔达、东方Project等),部分带音频。
LobCorpEGO SCARLE 添加《脑叶公司》E.G.O主题贵重物品(WIP),包含魔法子弹、Enkephalin盒等。

🧸 动漫 / 虚拟角色系列

模组名称 作者 简要描述
Fumos Pekodayo 添加40多种《东方Project》Fumo玩偶及约20个其他游戏杂项,部分带语音。
Miku Plushie Valuable merchdraws 添加初音未来毛绒玩具作为贵重物品。
Valuable Kasane Teto La_Camotiza 添加重音Teto作为单个贵重物品。
Valuable Akita Neru La_Camotiza 添加亚北音留作为单个贵重物品。
NeuroPlushie cutellurium 添加“Neuro Wizard”毛绒玩具作为贵重物品,带音频。
NeuroEvilVedalPlushies ItsEmul 添加Neuro-sama主题毛绒玩具、新物品、武器、音频和装饰品,含高价值Evil Neuro玩偶。
Chiikawa Valuables Mewy 添加Chiikawa、Usagi、Hachiware三个角色作为贵重物品,带简单音效。
ChiikawaValuables Dumbapple 添加Chiikawa系列角色及周边作为贵重物品(含熊袋、狩猎棒)。
AlanBeckerPack FriendGroupA 添加《Alan Becker》动画系列主题物品及装饰品。
NemesisPlushiesMod nemeshisu 添加多个带有独特行为的毛绒玩具(会说话的Teto、播放音乐的Akita Neru、可切换摄像头的Terminal等),含26个《Project Sekai》角色。
Chatblins FelineEntity 添加43个DyaRikku吉祥物“Chatblins”作为贵重物品。

🎬 影视 / 迷因系列

模组名称 作者 简要描述
Maxwell EverSkiesVR 添加单个名为Maxwell的收藏品,有简单互动。
Oiia Cat Valuable GarStudios 添加网络迷因“Oiia Cat”作为单个贵重物品。
OIA Valuable Omniscye 添加单个特殊贵重物品(会旋转、发光、召唤幽灵猫的猫)。
CharlieStatueValuable Unbe 添加Charlie Morningstar雕像作为贵重物品,优化模型和碰撞。
ILoveILoveMOD Sossic 添加REPO社区著名迷因作为贵重物品。
Gang Pikmin_Link 添加以作者朋友群内部梗为主题的至少10个物品(Carl、Metroid、Omniman、Zelda、Fortnite等)。
TheGrove TheKrowbar 添加以作者朋友群内部梗为主题的定制化贵重物品(渡渡鸟、Dr. Pupper等)。
AntsValuables 8BitAnt 添加21个朋友间内部梗主题的贵重物品(按大小分类:砖块、Gary、罐头、钱鱼、柱子等)。
Braindead Valuables MangoTheGuy 添加20个“为脑死亡人士设计”的贵重物品。

🧩 原创 / 综合杂物系列

模组名称 作者 简要描述
AllTheValuables yeah_ig 添加25个风格多样的新贵重物品,如Body Pillow、Furry系列等。
SillyValuables Sangrento 添加250+个搞笑风格的贵重物品和武器,部分带特效和音效。
SillyWardrobe Sangrento 添加少量新贵重物品及武器,如蓝鸡、水枪、激光剑等。
BensJunk Bengimi 超大型杂物扩展,包含大量游戏、迷因和原创设计的收藏品,部分带音频。
WILDCARD REPO deB 添加大量原创设计物品,如Chaos Emeralds、Chiikawa朋友系列等。
Rogue Valuables Rogue 添加13个风格贴近原版的新物品,如街机、微波炉(有互动)、大提琴等。
FunnyItems Ako 添加各种有趣好玩的收藏品。
CordobaArgentinaValuables Randal 添加26个阿根廷文化主题物品及数把武器。
JustOtakus Valuables JustOtaku 添加大量自定义新贵重物品,部分带有独特功能。
HallowsValuables HallowsMods 添加来自各种游戏和媒体的贵重物品。
Rosays Valuables Rosayy 添加30多种设计独特的贵重物品,部分带互动效果(如控制反转、吸引敌人、生成黑洞)。
SkysValuables skywx_dev 添加9个贵重物品(如宝石、打字机、特大号叉子),打字机可互动。
Roblox Classic Valuables kekprod 添加21个经典Roblox主题贵重物品,部分带音效或自定义行为,含火箭发射器物品。
DoorsItems mrbarrier 添加Roblox游戏《 Doors》中的贵重物品,如电视、雕像、毛绒玩具。
DecapitatedMonsters ZARP 将游戏中斩首的怪物头颅作为贵重物品,目前包含8种头颅,部分带音效。
GloobMod DaGloobie 添加动画Gloob生物作为贵重物品,被抓取或重击时会发出声音。
Toilet Paper Valuables AtomicStudio 添加卫生纸作为贵重物品。
Food Valubles Pack AlexKuz 添加15种食物类贵重物品,如蛋糕、烤鸡、披萨等。
FoodMod TheMedic 添加35种食物主题的贵重物品。
MedievalMod TheMedic 添加中世纪主题的贵重物品。
More Valuables Xiomai 添加风格贴近原版的多个新贵重物品。
MOAR Valuables JJCraftz 计划添加至少35个新贵重物品(目前未完成),部分带特殊效果。
ZMVLsBlursedValuables ZMVL 添加14个“Blursed”风格的新贵重物品。
CosyValuables Wexop 添加可爱舒适的贵重物品(咖啡熊、水族箱、迪斯科球等),迪斯科球可播放音乐。
Vanilla Variants VOIDBORN 为原版物品添加变种(高脚杯、戒指、铀玻璃、王冠、花瓶等)。
DesolateCustomValuables DesolateWasteInc 实验性模组,目前添加7个自定义贵重物品(木管、袋子、水烟壶等)。
StackUpValuablePack Dafini 为Stack Up慈善组织制作的贵重物品包。
MetalSonicValuable NEVAR 添加金属索尼克作为贵重物品,带特殊物理和耐久度。
Limon Valuable SamiTB 添加Limon角色作为贵重物品,有几率在被摧毁时爆炸。
patisewstuff patisew 添加大量来自不同媒体(主要是Roblox)的贵重物品。
TaylorsValuables legotaylor 添加来自《我的世界》《星露谷物语》《传送门》《斯坦利的寓言》等作品的贵重物品。
VicksyPlushExtra Lykai 添加3个小毛绒和1个大毛绒玩具,来自Vicksy的直播。
VicksyPlush Lykai 添加单个Vicksy毛绒玩具作为贵重物品。
PlushieMod Marms 添加5种毛绒玩具,部分带特殊效果(缩小、变大、更耐用)。
NyamNyam Seal Plush zyxterus 添加单个名为NyamNyam的海豹毛绒玩具。
MogzPlushie Marlin 添加带有Mogzxi语音的毛绒玩具作为贵重物品。
Dogs Kazzy 添加18种不同品种的狗作为贵重物品。
HeckatValuables Heckat 添加多个自定义贵重物品。
CO Valuables Rcm 添加《Clair Obscur: Expedition 33》主题的2个贵重物品。
sigmabreadvaluables sigmabread 计划添加多个新贵重物品,目前已完成一个大型贵重物品。
DalePlushies RudyFloofMods 添加7个中等毛绒和1个巨大麦克斯韦猫作为贵重物品。
Horror Valuables LeviMods 添加少量恐怖主题贵重物品。
SossicValuables Sossic 添加单个新贵重物品(Ghostango)。
OctolarValuables Zehs 添加Octolar(Thorlar)作为单个贵重物品。
ManorPlus AstreaFox 为庄园地图增加10个新贵重物品。
HorrorExpansion AstreaFox 在所有地图增加50个恐怖主题新贵重物品。
SwiftbroomPlus AstreaFox 为Swiftbroom学院地图增加22个新贵重物品。
MuseumPlus AstreaFox 为博物馆地图增加50个新贵重物品,包括绘画、古埃及雕像等。
TogMod DenZ_Dev 添加《Throne of Glass》系列8本书作为贵重物品。
WaterBottles Bocon 添加多种水瓶作为贵重物品(普通水瓶、5加仑水瓶、饮水机等)。
PanasonicBluRayValuable SoupNBread 将松下蓝光播放器作为新贵重物品添加到McJannek Station。
FalloutScrap Edsel_Dah_rat 添加《辐射:新维加斯》中的各种废土垃圾作为贵重物品。
ArisJunkDrawer AriIcedT 作者自制的多种模型杂物,如Blahaj、计算器、鱼缸(带旋转效果)等。
ValuableCans AriIcedT 添加多种易拉罐饮料作为低价值新贵重物品。
Tokucade Valuables Caigan 添加玩具、毛绒玩具和各种有趣的小物件,来自“Tokucade”设定。
LBP Valuables sourbabyraysbbq 添加《小小大星球》主题收藏品,带自定义音效和着色器。
WarhammerValuables zacyquack 添加数十种《战锤40K》主题模型作为贵重物品,涵盖帝国、混沌、异形阵营。
McDonaldsValuables Lluciocc 添加麦当劳主题物品,包括贵重物品(可乐、汉堡等)和功能性物品(巨无霸等)。
ItalianBrainrotValuables GofioLabs 添加16种意大利网络迷因文化主题的贵重物品。
JustDave2sValuables JustDave2 添加58个按大小分类的新贵重物品,来源多样(Roblox、Subnautica等)。
PEAKValuables ItsEmul 添加超过55个基于游戏“PEAK”的新贵重物品及配套装饰品,未来计划增加武器和功能。
RecycleDoors XiaohaiMod 打破的门会变成可拾取的贵重物品,价值可配置,与你的随机化完美叠加。
LegalizeNuclearBombs BLOKBUSTR 添加一个高度可配置的核弹头贵重物品,有独特的爆炸机制和伤害设置。
RDD Valuables DragonModders 添加30多个来自动漫、游戏和网络迷因的新贵重物品,部分带自定义效果。
Egyptian Valaubles GarStudios 添加古埃及主题的贵重物品(石棺、古卷、金条、金圣甲虫)。
LeosValuables leo_team 添加多种新贵重物品(Gromit Mug、Mouthwash、Roboty、各种毛绒等),未来可能增加商店物品。
BeerCaseValueble Ezekiel0 添加一箱啤酒作为贵重物品。
Anvils Mod GarStudios 添加铁砧作为贵重物品(铁砧、金砧、小铁砧)及武器“棍上砧”。

⚡ 特殊机制 / 功能类

模组名称 作者 简要描述
REPOPresents dig 添加7种礼物盒,打破后可开出更好物品或触发事件,本身属于贵重物品。
Majoras Mask Omniscye 添加梅祖拉面具作为贵重物品,抓取后会触发全队随机事件(传送、死亡、升级等)。

🏰 关卡类(附带新物品,物品价格仍被随机化)

模组名称 作者 简要描述
TheFacility grey5525 添加40个新房间及9个新贵重物品。
Backrooms Rogue 添加“后室”主题新地图。
FNAFLevel OrtonLongGaming 添加《FNAF》主题大型新地图,含新房间和贵重物品。
Burpleson Base Level compraventa_de_facebook 军事主题关卡,融合《半条命》《传送门》等元素,含41个新房间及临时武器。
Wesleys Manufacturer of Style Magic_Wesley 受Crocs委托制作,添加新关卡及28种带增益效果的鞋子。
WitherholdKeep DirtyGames Minecraft风格地下城关卡,含21+模块及自定义物品。
Peachs Castle Level Mod Skydorm 添加《超级马里奥》桃子城堡主题新关卡,含21个房间和47个新贵重物品,带机关。
WinterCabin grey5525 2025冬季Mod Jam作品,添加冬季小屋主题关卡,含自定义音乐和贵重物品(如礼物)。
The Stanley Parable Ultra Deluxe Level John_Epic_Team 基于《史丹利的寓言》的大型主题关卡,含67个房间和30个新贵重物品。
Minecraft Cave Rogue 添加《Minecraft》洞穴主题新关卡,含28个模块和20个新贵重物品。
MinecraftStrongholdLevel AriIcedT 添加《Minecraft》要塞主题新地图(早期测试版)。

🔌 公开 API (供其他模组开发者使用)

其他模组可以通过引用此模组的 DLL 或使用反射来访问以下 API:

命名空间

using RandomValuablePrice;
事件
csharp
public static event Action<ValuableObject, float, float> OnItemRandomized
触发时机:当贵重物品被成功随机化后触发。

参数:

ValuableObject vo:被随机化的物品对象。

float oldPrice:随机前的原价。

float newPrice:随机后的新价。

方法
csharp
public static float GetItemPrice(ValuableObject vo)
描述:获取指定贵重物品的当前价格。

返回值:物品当前价格(dollarValueCurrent 字段的值)。

使用示例
csharp
// 订阅价格随机化事件
RandomValueAPI.OnItemRandomized += (vo, oldPrice, newPrice) => {
    Debug.Log($"物品 {vo.name} 价格从 {oldPrice} 变为 {newPrice}");
};

// 主动查询价格
float price = RandomValueAPI.GetItemPrice(someValuable);
🎮 使用方法
单人游戏
安装模组后启动游戏。

进入任意关卡。

抓取贵重物品时,价格会被随机化,可在日志中查看(需开启详细日志)。

多人游戏
主机安装并配置模组,配置需手动同步给客户端(因为本版本不再自动同步)。

客户端也需安装相同模组,并手动设置与主机相同的配置,以确保价格计算一致。

所有玩家独立计算价格,结果一致(基于确定性随机算法)。

❓ 常见问题
问:为什么抓取后价格没有变化?
答:请检查配置文件是否已正确生成,并确认 随机化物品价格 为 true。同时确保抓取的物品是贵重物品(有 ValuableObject 组件)。如果仍无效,可开启 详细日志输出 查看日志中是否有价格修改记录。

问:游戏内漂浮价格显示的还是原价,但日志显示已修改?
答:这可能是因为游戏 UI 缓存未立即刷新。实际提取物品时,获得的金额将是修改后的价格(以日志为准)。你可以通过提取物品来验证。

问:这个模组和其他价格修改模组冲突吗?
答:如果其他模组也在抓取时修改价格,可能会相互覆盖。建议只保留一个价格模组。

问:如何在自己的模组中使用 API?
答:在您的模组项目中添加对本模组 DLL 的引用,然后使用 RandomValueAPI 类即可。

问:这个模组支持多人游戏吗?
答:支持基本机制,但配置需手动同步。由于未经过充分多人测试,如果遇到问题欢迎反馈。

问:多人游戏中如何确保价格一致?
答:主机在关卡开始时广播配置和随机种子,每个客户端基于相同种子和物品 ID 独立计算价格,因此结果必然相同。此过程无需传输价格值,性能优异。

问:与 Empress Currency 一起使用会有冲突吗?
答:不会。本模组修改的是底层美元数值,Empress Currency 只改变显示方式,两者可同时使用。

🙏 致谢
感谢所有在调试过程中提供帮助的社区朋友。

感谢 REPOConfig 作者提供的便捷配置 UI。

感谢所有推荐模组的作者,他们的创作为玩家带来更丰富的游戏体验。

AI 辅助来自 DeepSeek。