Peak Stamina

Advanced Features

Exhaustion Penalties

Define what happens when a player hits 0 Stamina. You can apply temporary debuffs that linger after stamina starts regenerating. You can find the list of available attributes by running the command /attributes @s (a list will be displayed)

• exhaustionCooldownDuration (Default: 60): How many ticks (3s) the penalties persist after hitting 0.
• customExhaustionPenalties: A list of Attribute Modifiers to apply.

Format: "AttributeName;Amount;Operation"

• 0: Addition (Flat number)
• 1: Multiply Base
• 2: Multiply Total (Percentage)

Examples:

# Slow down player by 15%
"minecraft:generic.movement_speed;-0.15;2"

# Reduce Attack Speed by 15%
"minecraft:generic.attack_speed;-0.15;2"

# Reduce Damage by 1 flat point
"minecraft:generic.attack_damage;-1.0;0"

Universal Compatibility (NBT & Status Effects)

Link ANY mod's data (Thirst, Temperature, Radiation, Magic) to the stamina system without needing an official update. You can find the Player NBT data by doing the ingame command /data get entity @s

• universalPenalties: A list of rules defining external penalties.

Format: "Type;Key;Comparator;Threshold;WorstValue;MaxPenalty;ColorInt"

Parameter	Description
Type	NBT (reads player data) or EFFECT (potion effect).
Key	The NBT Path (e.g. thirstLevel) or Effect ID.
Comparator	< (Less than), > (Greater than), or = (Equal).
Threshold	The value where the penalty starts (0% penalty).
WorstValue	The value where the penalty is max (100% penalty).
MaxPenalty	How much Max Stamina is removed at the "WorstValue".
ColorInt	The Decimal Integer color for the HUD stripes.

Examples:

1. Tough As Nails (Thirst) Logic: If thirst is < 6, scale penalty until thirst is 0. Max penalty 20.0. Color Blue (38143).

"NBT;thirstLevel;<;6;0;20.0;38143"

2. Cold Sweat (Body Temperature) Logic: If temp is > 2, scale penalty until temp is 4. Max penalty 20.0. Color Orange-ish red (16724016). If temp is < 2, scale penalty until temp is 0. Max penalty 20.0. Color lightblue (65535).

"NBT;targetTemperatureLevel;>;2;4;20.0;16724016",
"NBT;targetTemperatureLevel;<;2;0;20.0;65535"

---

Debugging Guide

How to find the correct NBT Path

If your config isn't working, the mod has a built-in debugger.

1. Guess the path in your config (e.g., "NBT;thirstLevel;<;...).
2. Launch the game.
3. Check your logs (logs/latest.log). If the path is wrong, the mod will print a WARNING showing you exactly what data is available.
   • Look for: [Peak Stamina] NBT Path NOT Found followed by -> Available keys at this level: [...].
4. Use those keys to fix your config.

How to get Colors

Minecraft configs use Decimal colors, not Hex.

1. Go to a Hex to Decimal Converter.
2. Enter your Hex color (e.g., FF0000 for Red).
3. Copy the result (e.g., 16711680).

Client Config (peak_stamina-client.toml)

• Position: barXOffset, barYOffset.
• Size: barWidth, barHeight.
• Colors: Full Decimal color support for the bar, background, and penalty stripes.

---