RunBasedPassives

RunBasedPassives

局內被動屬性成長，通過行動累積升級，永久保存。

版本：0.4.1

致謝

本模組 UI 基於 王子晨 (WZC_UI) 的 MoreUI 源碼抽離出的 MoreUIPanel 庫。

概述

在關卡中通過跳躍、抓取物品、移動、受到治療、蹲伏恢復累積經驗，達到閾值後永久提升對應屬性。所有成長跨局保留，屬性數值由模組直接應用，升級後立即生效。同一存檔內換層時未填滿的進度會自動繼承，切換存檔則重新開始。

⚠️ 重要說明

• 聯機同步：各自獨立累積，互不影響。
• 軟依賴：需安裝 MoreUIPanel 庫模組才能顯示信息面板。

🔧 衝突模組

以下模組與 RunBasedPassives 存在已知衝突：

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

這些模組會同步升級字典到所有玩家，與我們的被動等級存儲方式衝突。不要同時使用。

• InfiniteStamina / MoreStamina 等體力修改模組
• InfiniteGrab 等抓取力量修改模組
• MoreUpgrades（開啓"允許團隊升級"或"同步主機升級"時）

✨ 功能

• 跳躍升級：每跳躍一定次數，額外跳躍次數 +1
• 力量升級：每抓取一定數量不同物品，抓取力量 +1
• 耐力升級：每移動一定距離，體力上限 +10
• 生命升級：每受到一定次數有效治療，最大生命 +20
• 衝刺速度升級：衝刺時累積距離，每升一級衝刺速度 +1.0（與原版升級幅度一致），可配置封頂等級
• 蹲伏恢復升級：蹲伏時恢復體力，基於實際恢復量累積經驗，恢復速度每級 +1
• 進度繼承：同一存檔內換層時，未完成的升級進度會保留到下一關，不再從零開始
• 存檔隔離：切換存檔後經驗自動清零，不同存檔獨立計算
• 動態遞增閾值：升級門檻隨等級提高，避免後期屬性爆炸
• 屬性實時應用：所有屬性每幀強制應用，升級瞬間生效
• 屬性永久保存：等級存儲於遊戲原版升級字典，跟隨存檔，與商店升級完美兼容
• 左下角實時進度顯示：通過 MoreUIPanel 庫顯示當前經驗與等級
• 六個屬性可單獨開關
• 衝刺速度封頂可配置：可在配置文件中設置封頂等級，0 爲不封頂
• 輕量、無額外功能

📋 未來規劃

以下功能正在考慮中。

• 更多被動屬性：抓取範圍、翻滾距離等
• 屬性 API：供其他模組註冊自定義被動屬性，實現統一管理

安裝

• 確保已安裝 BepInExPack 和 MoreUIPanel
• 將 RunBasedPassives.dll 放入 BepInEx/plugins 文件夾
• 啓動遊戲，模組會自動生成配置文件

⚙️ 配置

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

| 配置項 | 默認值 | 說明 |

|---|---|---|

| EnableJump | true | 啓用跳躍升級 |

| EnableStrength | true | 啓用力量升級 |

| EnableStamina | true | 啓用耐力升級 |

| EnableHealth | true | 啓用生命升級 |

| EnableSprintSpeed | true | 啓用衝刺速度升級 |

| EnableCrouchRestore | true | 啓用蹲伏恢復升級 |

| SprintSpeedCap | 0 | 衝刺速度封頂等級（0=不封頂） |

| VerboseLogging | false | 詳細日誌（調試用） |

❓ 常見問題

Q：衝刺速度太快怎麼辦？

A：可在配置文件中設置 SprintSpeedCap 爲一個合適的等級，超過該等級後速度不再增長。

Q：換存檔後屬性會繼承嗎？

A：屬性跟隨遊戲存檔，每個存檔獨立累積。切換存檔後屬性恢復爲對應存檔的進度。

Q：如何查看當前等級？

A：屏幕左下角會實時顯示等級和進度。需要 MoreUIPanel 依賴。

Q：能否手動調整閾值？

A：暫不支持，可通過修改源碼中的常數自行編譯。