DefaultUpgrade

COMPATIBLE WITH COSMETICS UPDATE V0.4.0.

DefaultUpgrade

This mod is a host-only mod that applies configured default upgrade values before level loading starts and syncs missing upgrades to late joiners.

It is designed for runs where players should begin each level with a configured baseline of upgrades instead of starting from vanilla upgrade values.

The main application now happens before the level change continues.

This allows upgrade effects such as health, stamina, extra jump, launch, speed, and grab-related upgrades to be present when the next level initializes.

The mod uses missing-only logic.

If a player's current upgrade value is lower than the configured target, only the missing amount is added.

If a player already has an upgrade value equal to or higher than the configured target, that upgrade is left unchanged.

Late joiners are also supported.

When a player joins during a run, the host checks that player's current upgrade values and applies only the missing amount needed to reach the configured defaults.

This mod does not reduce upgrade values.

It is intended to be installed by the host only.

Features

• Host-only default upgrade application
• Pre-load upgrade application before level loading starts
• Post-load repair application as a fallback
• Missing-only upgrade logic
• Late join sync support
• Per-upgrade config values from 0 to 50
• Configurable pre-load sync wait
• Configurable late join retry window
• Mod enable toggle
• Log enable toggle

How it works

When the host starts a level change, the mod pauses the level change flow, applies the configured default upgrades to current players, syncs Stats, waits for the configured sync delay, and then resumes the original level change.

This is different from the older version, which applied upgrades after level generation.

Applying upgrades after level generation could make the values appear synced while some gameplay effects, such as max health or extra jumps, did not fully apply until the next load.

The new pre-load timing lets the vanilla player initialization pick up the upgraded values during level loading.

Example missing-only logic:

• Configured Speed = 3
• Current Speed = 0 -> add 3
• Current Speed = 2 -> add 1
• Current Speed = 3 -> add 0
• Current Speed = 5 -> add 0

The same missing-only logic is used for late joiners and post-load repair.

Host only

Only the host needs to install this mod.

The host updates and syncs the upgrade values for all players.

Config

A General

EnableMod

• Description: Enable or disable this mod
• Default: true
• Minimum: N/A
• Maximum: N/A

PreLoadApply

• Description: Apply default upgrades before level loading starts
• Default: true
• Minimum: N/A
• Maximum: N/A

PostLoadRepairApply

• Description: Repair missing upgrades after level generation as a fallback
• Default: true
• Minimum: N/A
• Maximum: N/A

NewJoinSync

• Description: Apply missing default upgrades to late join players
• Default: true
• Minimum: N/A
• Maximum: N/A

PreLoadSyncWaitSeconds

• Description: Wait seconds after Stats sync before starting level load
• Default: 0.50
• Minimum: 0.0
• Maximum: 3.0

PostLoadApplyDelay

• Description: Delay seconds before post-load repair
• Default: 1.0
• Minimum: 0.0
• Maximum: 10.0

JoinSyncWindowSeconds

• Description: Retry window seconds for late join sync
• Default: 30.0
• Minimum: 5.0
• Maximum: 120.0

B Upgrades

Health

• Description: Health upgrade default value
• Default: 1
• Minimum: 0
• Maximum: 50

Stamina

• Description: Stamina upgrade default value
• Default: 1
• Minimum: 0
• Maximum: 50

ExtraJump

• Description: Extra jump upgrade default value
• Default: 1
• Minimum: 0
• Maximum: 50

Launch

• Description: Tumble launch upgrade default value
• Default: 1
• Minimum: 0
• Maximum: 50

TumbleClimb

• Description: Tumble climb upgrade default value
• Default: 1
• Minimum: 0
• Maximum: 50

MapPlayerCount

• Description: Map player count upgrade default value
• Default: 1
• Minimum: 0
• Maximum: 50

DeathHeadBattery

• Descriptio