UpgradeLimiter
Caps how many of each player upgrade can be stacked. Configurable per upgrade.
模組介紹 作者原文
UpgradeLimiter
A R.E.P.O. mod that caps how many of each player upgrade can be stacked. Each upgrade has its own enable toggle and max-stacks value.
When a player tries to consume an upgrade past the cap, the upgrade crystal is consumed normally but the stat does not increase. Decrements and resets pass through unchanged.
Features
- Per-upgrade Enabled toggle and MaxStacks value (0–99)
- Covers all 13 base-game player upgrades (Health, Energy, ExtraJump, TumbleLaunch, TumbleClimb, TumbleWings, SprintSpeed, CrouchRest, GrabStrength, ThrowStrength, GrabRange, DeathHeadBattery, MapPlayerCount)
- Modded UpgradePlayer* methods are auto-discovered via IL scanning and added to the config
- Host-to-client sync via Photon room properties — only the host needs to configure caps
- Live config reload: changing limits mid-run takes effect on the next pickup, no level reload needed
- Compatible with REPOConfig — adjust settings in-game
Configuration
Config file: BepInEx/config/darkharasho.UpgradeLimiter.cfg
Each upgrade gets its own section:
[Health]
Enabled = false
MaxStacks = 5
[SprintSpeed]
Enabled = true
MaxStacks = 2
| Key | Default | Range | Description |
|-----|---------|-------|-------------|
| Enabled | false | — | When true, the upgrade is capped. When false, it behaves vanilla. |
| MaxStacks | 5 | 0–99 | Maximum stacks of this upgrade per player. 0 blocks every pickup (effectively disables the upgrade). |
Plus a sync section:
[Sync]
SyncToClients = true
When SyncToClients = true, the host pushes its caps to every client via Photon room properties and clients ignore their own local caps while in the room. When false, each client uses its own local config.
Multiplayer
The cap is enforced on the host's authoritative state, so toggling caps on a client without host sync will not actually limit the upgrade — only the host's settings matter for enforcement.
Dependencies
- BepInExPack
Installation
Install Mod Manager / r2modman, or manually place UpgradeLimiter.dll in BepInEx/plugins/UpgradeLimiter.
Building
GAME_DIR="/path/to/REPO"./package.sh
Builds the DLL and produces a -ready zip. Install the zip via r2modman.
安裝與使用 安裝：BepInEx 外掛
- 本站下載的壓縮包就是模組本體，通常是 BepInEx 外掛（解壓後得到 .dll 或外掛資料夾）。
- 建議流程：用社群模組管理器（如 r2modman）選中本遊戲後匯入該模組，管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程：先在遊戲目錄裝好 BepInEx 載入器，再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲，BepInEx 控制台會列印載入日誌；確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝，否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。
下面這些內容需要先安裝，否則該模組不會生效：