RunBasedPassives

局内被动属性成长，通过行动累积升级，永久保存。

版本：0.2.0

致谢

本模组 UI 基于 王子晨 (WZC_UI) 的 MoreUI 源码抽离出的 MoreUIPanel 库。

概述

在关卡中通过跳跃、抓取物品、移动、受到治疗累积经验，达到阈值后永久提升对应属性。

⚠️ 重要说明

• 联机同步：各自独立累积，互不影响。
• 软依赖：需安装 MoreUIPanel 库模组才能显示信息面板。

🔧 冲突模组

以下模组与 RunBasedPassives 存在已知冲突：

• SharedUpgrades / SharedUpgrades Patch / SharedUpgradesChance
• SharedUpgradesPlus
• BetterTeamUpgrades
• Empress SharedUpgrades
• LateJoinSharedUpgradesByNastyPablo
• hairo-SharedUpgrades

这些模组会同步升级字典到所有玩家，与我们的被动等级存储方式冲突。不要同时使用。

• InfiniteStamina / MoreStamina 等体力修改模组
  直接修改 EnergyStart 字段，与耐力升级逻辑冲突，可能导致体力值被反复重置。

• InfiniteGrab 等抓取力量修改模组
  直接修改 grabStrength 字段，与力量升级逻辑冲突，可能导致抓取力量被覆盖。

• MoreUpgrades（开启"允许团队升级"或"同步主机升级"时）
  MoreUpgrades 本身使用独立的自定义字典键，默认不冲突。但如果其配置中开启了团队升级或主机同步功能，会将我们的被动等级误同步给其他玩家，造成字典污染。建议关闭这两个选项，或保持默认配置。

• 任何直接修改 JumpExtra、grabStrength、EnergyStart、maxHealth 的模组
  这些模组会与 RunBasedPassives 每帧应用的属性值互相覆盖，导致升级效果时有时无。

✨ 功能

• 跳跃升级：每跳跃一定次数，额外跳跃次数 +1
• 力量升级：每抓取一定数量不同物品，抓取力量 +1
• 耐力升级：每移动一定距离，体力上限 +10
• 生命升级：每受到一定次数有效治疗，最大生命 +20
• 阈值随等级动态递增，避免后期属性爆炸
• 属性交由游戏自身管理，与商店升级完美兼容
• 属性永久保存，跨关卡、跨存档继承（跟随游戏存档）
• 屏幕左下角实时显示当前进度
• 四个属性可单独开关
• 轻量、无额外功能

📋 未来规划

以下功能正在考虑中。

• 更多被动属性：翻滚距离、移动速度、投掷力量等
• 属性 API：供其他模组注册自定义被动属性，实现统一管理

安装

• 确保已安装 BepInExPack 和 MoreUIPanel
• 将 RunBasedPassives.dll 放入 BepInEx/plugins 文件夹
• 启动游戏，模组会自动生成配置文件

⚙️ 配置

配置文件位置：BepInEx/config/cn_xc.RunBasedPassives.cfg

❓ 常见问题

Q：换存档后属性会继承吗？
A：属性跟随游戏存档，每个存档独立累积。切换存档后属性恢复为对应存档的进度。

Q：如何查看当前等级？
A：屏幕左下角会实时显示等级和进度。需要 MoreUIPanel 依赖。

Q：能否手动调整阈值？
A：暂不支持，可通过修改源码中的常数自行编译。