LowHealthChallenge

LowHealthChallenge

LowHealthChallenge is a challenge mod that sets all players' maximum health to low HP values of 100 or less.

You can choose a target health value from 0 to 100, and the mod will automatically convert it to the nearest supported tier:

0, 20, 40, 60, 80, or 100.

Examples:

• 22 becomes 20
• 78 becomes 80
• 90 becomes 100

This makes it easy to run low-health challenge rooms without manually managing each player.

The mod also prevents Health Upgrade items from appearing at all.

They are removed from shop candidates, blocked from normal item availability, and cleaned up if they somehow appear in the world.

This keeps the challenge rules consistent for the entire run.

Known limitation

If you change the max health setting during an active run, other clients may not see their updated max health immediately.

In practice, participant max health may not fully update until a load transition happens, such as moving to the next level or another scene.

Host commands

• /hpset
• Sets the target health
• Example: /hpset 22
• /hpnow
• Shows the current configured health, rounded health, and internal applied tier
• /hpreset
• Resets the target health to 100

How it plays

• Everyone in the lobby is forced to the same health limit
• New joiners are automatically forced to the same limit
• After level changes, the same health limit is applied again
• If current HP is already below the new maximum, it stays as-is
• If current HP is above the new maximum, it is reduced to the new maximum
• If you change the health setting mid-run, participant-side max health may not fully refresh until a load transition occurs

This is especially useful for:

• low HP challenge runs
• high-risk event rooms
• fixed difficulty challenge rooms
• testing enemy setups under reduced survivability

Settings

General

EnableMod

• Description: Enable or disable the mod
• Default: true

Health

TargetHealth

• Description: Requested health value from 0 to 100. The mod rewrites this to the nearest valid tier
• Default: 40
• Minimum input: 0
• Maximum input: 100
• Actual applied values: 0, 20, 40, 60, 80, 100

Health Upgrade Blocking

BlockHealthUpgradeInShop

• Description: Removes Health Upgrade from shop candidate generation
• Default: true

BlockHealthUpgradeInWorld

• Description: Disables Health Upgrade entries from the world item dictionary
• Default: true

DestroyExistingHealthUpgradeItems

• Description: Periodically searches for spawned Health Upgrade items and destroys them
• Default: true

ReapplyHealthOverrideIfChanged

• Description: Periodically reapplies the fixed health rule if another system changes it
• Default: false

Debug

LogRoundedResult

• Description: Writes requested value, rounded value, and applied internal tier to the log
• Default: true

Details

Internally, the mod treats the rounded health tier as the only valid value.

Both command input and direct config edits are normalized to the same final tier, and the config is rewritten to that rounded value.

The health normalization rule is:

• Clamp input to 0 through 100
• Round to the nearest value in 0 / 20 / 40 / 60 / 80 / 100
• If the input is exactly between two valid tiers, round upward

Applied examples:

• 10 becomes 20
• 30 becomes 40
• 50 becomes 60
• 70 becomes 80
• 90 becomes 100

The mod then applies the corresponding fixed max health to all active players on the host side and updates current HP with this rule:

• If current HP is greater than the new maximum, it is clamped down to the new maximum
• If current HP is already below the new maximum, it is preserved

To keep the fixed-health rule stable, the mod uses multiple layers of Health Upgrade blocking:

• removes the item from shop upgrade candidate lists
• disables Health Upgrade entries in the item dictionary
• destroys any spawned Health Upgrade item found in the world
• optionally reapplies fixed health on a timed loop if another system changes it

The mod also reapplies the fixed health tier:

• when StatsManager st