SharedUpgradesPlus compatibilitytweaks
Host-controlled upgrade sharing with External Map / Personal sections, readable automatic two-column fitting, and saved per-player life charges. Preserves one team benefit per purchase without refilling spent lives.SharedUpgradesPlus-compatibilitytweaks
Author: ByteSizeMetal
Keeps supported upgrades consistent across the lobby using the host's settings. Shares personal upgrades, preserves one team benefit per world-upgrade purchase, and tracks each player's remaining life charges.
The upgrade panel
Upgrades appear under two subheaders, with indented entries:
- External Map shows the team's level for supported upgrades that affect the world, such as Valuable Density and Investor. Everyone can see the benefit without receiving extra copies that multiply its effect.
- Personal shows your own upgrades and remaining consumable charges. An exhausted life upgrade disappears from your list.
The list keeps the game's original font size. If it is too long for one column it splits into two, with a clear gap between them, and shrinks only if two columns still would not fit the free space on the HUD. Both sections keep their headers, each count stays beside its name, and no names are shortened to make room.
TextUpgradesUIScale is optional and can stay enabled. With this mod's fitting on, the final layout is measured from the original font size rather than an already-shrunk result. Turning FitUpgradePanel off lets the optional fitter use its own layout, including aligned columns.
Sharing and life charges
Ordinary permanent upgrades catch up to the highest level held by a connected teammate, when the host's sharing rules allow it. Supported world effects retain one contribution per purchase.
For supported REPOLib consumables, the host keeps purchase history and a separate spending balance for every player. Each pickup grants everyone immediately, regardless of who uses it. Spending a charge lowers only that player's balance. For example, after two Extra Life purchases, a player who has spent both sees no Extra Life row; a teammate who has spent none still has two.
New players can receive the run's grant history. Returning players receive purchases missed while away, with their own previous spending retained. Spending or rejoining never turns another player's unused lives into a refill. Level caps still apply, and purchases blocked by a cap do not become a hidden reserve of charges.
The ledger saves with the game's run stats. When first loading an existing save, the mod preserves observed balances: it cannot reconstruct spending that happened before the ledger was installed. It also cannot reliably undo inflated levels from an older sharing setup.
Second Chance from Extra Battle Upgrades currently uses a cooldown, rather than spending a level when activated. This mod preserves that behavior. Its level decreases only if the source mod actually consumes it.
Host settings
The current host controls compatibility rules, named per-upgrade choices, caps, charge bookkeeping, historical grants and the grouped panel/fitting options. Clients receive the policy automatically without having their saved config overwritten. Leaving the lobby restores their local choices; a new host supplies the next policy.
Use the same 1.5.1 version on the host and every client. Versions before 1.5.0 use a different policy format. Compatibility catch-up waits for valid host rules rather than guessing from a client's local settings.
Universal charge bookkeeping and highest-level permanent catch-up require the host's SharedUpgradesPlus sharing chance to be 100%. Global sharing, modded-upgrade sharing and the relevant per-upgrade sharing switches must also be enabled. Otherwise the normal purchase path remains in charge; the ledger does not override those exclusions or turn probabilistic sharing into guaranteed grants.
This synchronizes this compatibility mod's rules, not every balance setting in the underlying upgrade mods. Keep those mod versions and gameplay configs matched too. Pop-up visibility/duration and debug logging remain personal preferences.
Supported world effects
| Mod | External Map upgrades |
|---|---|
| SLRUpgradePack | Valuable Density, Object Value, Object Durability |
| Nikki's Upgrades | Investor |
| MoreUpgrades | Item Value |
These upgrades select their supported handling automatically. Valuable Density affects the next level's generation; it cannot add valuables to a level that has already been generated. MoreUpgrades' Valuable Count is a personal HUD counter, and Item Resist protects only items held or last grabbed by players who own it. Both follow ordinary permanent-upgrade sharing.
Other registered upgrades receive named options where their source can be identified. Generic REPOLib consumable handling needs the source mod's normal upgrade-item and level-change APIs. Custom activation paths may need a separate compatibility check.
Installation
Install on the host and every client. The host needs SharedUpgradesPlus for purchase sharing. Keep the upgrade mods you want to use; this package includes no content mods. Optional integrations activate only when their supported APIs are present.
This replaces SharedUpgradesFix and the older SharedUpgrades_SLRPatch. Remove or disable those older packages first. Keep one copy of this compatibility mod enabled and restart the game normally after installation.
For manual installation, put the DLL in:
BepInEx/plugins/SharedUpgradesPlus.CompatibilityTweaks/SharedUpgradesPlus.CompatibilityTweaks.dll
Configuration
Existing settings are retained in:
BepInEx/config/nakeem.SharedUpgradesFix.cfg
That filename stays the same for compatibility. The mod appears under its public name in the mod manager.
Upgrades have named entries grouped by source mod. Use Allow sharing to enable or disable one and Handling to choose its behavior. No typed upgrade IDs or exception lists are needed.
| Handling | Meaning |
|---|---|
| Automatic | Recommended. Selects the supported behavior for that upgrade. |
| SharedPermanent | Catches everyone up to the highest connected permanent level. |
| TeamPooled | Preserves individual contributions and shows one team total under External Map. |
| Consumable | Tracks shared purchases and individual spending when host ledger conditions are met. Never uses highest-level refill. |
Leave supported world upgrades on Automatic or TeamPooled. Extra Life and Second Chance remain protected as consumables.
| Section / option | Default | Effect |
|---|---|---|
| Consumable charges / HostChargeLedger | On | Host bookkeeping for supported purchases and per-player spending. |
| Consumable charges / GrantHistoryOnJoin | On | Grants past purchases to newcomers and missed purchases to returning players. Off skips historical grants while new pickups still share immediately. |
| Display / ShowTeamPooledLevels | On | Groups the panel into External Map and Personal. The existing config key is retained. |
| Display / FitUpgradePanel | On | Fits the list automatically, with or without TextUpgradesUIScale. |
The Team effects section controls individual compatibility adjustments. Disabling the ledger preserves its saved history. SharedUpgradesPlus' generic host-level late catch-up is excluded for consumables, because copying someone else's remaining count could restore spent charges.
Compatibility and reporting
Checked against the installed APIs for R.E.P.O. 0.5.0, SharedUpgradesPlus 1.6.2, REPOLib 4.3.0, MoreUpgrades 1.7.3, SLRUpgradePack 0.6.0 and TextUpgradesUIScale 1.4.1. Purchase, spending, save/load, host migration and layout behavior have offline regression checks; live multiplayer validation is still needed.
If players disagree, include the upgrade name, purchaser, mod versions and affected players' logs. State whether the mismatch is in the panel, remaining charges or the effect itself.
Original mods remain credited to their creators. This package contains compatibility code, not their content.