Peak Stamina

It skipped a bunch of version numbers so its consistent with my curseforge versions. (so I dont have to keep changing stuff)

New basic config

• initialMaxStamina (Default: 100.0): The starting maximum stamina value for all players. This sets the base attribute value that penalties and modifiers are calculated against.

Weight System

The Weight System tracks the total weight of items in your inventory and applies penalties when you carry too much.

How It Works

Weight Calculation:

• Every item has a weight value
• Weight is calculated from inventory, armor, offhand, and Curios slots (if installed)
• Containers (shulkers, backpacks, etc.) include the weight of their contents
• Weight accumulates recursively (should work with backpacks inside backpacks if thats possible)

Weight Penalty:

• When your total weight exceeds the threshold, a penalty begins to apply
• The penalty scales linearly from threshold to limit
• At maximum weight, you suffer the full configured penalty to Max Stamina
• Weight penalty is displayed as a gray striped section on the stamina bar

Configuration

General Settings:

[Weight System]
    # Enable the weight calculation system
    enableWeightSystem = true
    
    # Weight at which penalty begins (0% penalty)
    weightPenaltyThreshold = 125.0
    
    # Weight at which penalty reaches maximum (100% penalty)
    weightPenaltyLimit = 400.0
    
    # Maximum stamina penalty at full weight limit
    maxWeightPenaltyAmount = 40.0
    
    # Maximum depth for recursive container scanning (prevents lag)
    maxWeightRecursionDepth = 3

Auto-Weigher (Heuristic System):

    # Base weight for unlisted items
    # Formula: Weight = (Base / MaxStackSize) * Count
    # Result: 1 full stack of ANY item = Base weight
    #
    # Examples (if Base = 10):
    #  - 1 Sword (stack 1) = 10.0 weight
    #  - 16 Ender Pearls (stack 16) = 10.0 weight (0.625 per pearl)
    #  - 64 Dirt (stack 64) = 10.0 weight (0.156 per block)
    autoWeightBase = 10.0

Priority 1: Explicit Item Weights Items in this list bypass the auto-weigher entirely.

    # Format: 'modid:item;weight'
    # Each individual item has this weight (not per stack)
    #
    # Examples:
    customItemWeights = [
        "minecraft:netherite_chestplate;15.0",
        "minecraft:diamond_sword;4.0",
        "minecraft:obsidian;1.2"  # Each obsidian block = 1.2 weight
    ]

Priority 2: Tag/Category Weights Items matching these tags (but not in explicit list) use tag weight.

    # Format: 'tag;weight'
    # Each individual item in the tag has this weight
    #
    # Examples:
    customTagWeights = [
        "forge:ores;0.25",           # Each ore = 0.25 weight
        "forge:storage_blocks;0.15", # Each storage block = 0.15 weight
        "forge:ingots;0.2"           # Each ingot = 0.2 weight
    ]

Priority 3: Auto-Weigher Any item not in the above lists uses the heuristic formula.

Custom Container Paths: For backpack mods that store items in NBT:

    # Format: 'modid:item;path.to.list'
    # Use dots (.) for nested NBT tags
    #
    # Built-in support:
    #  - Vanilla Shulker Boxes (BlockEntityTag.Items)
    #  - Curios API
    #  - PackedUp (via reflection)
    #
    # Examples for other mods:
    customContainerPaths = [
        "somemod:satchel;Inventory",
        "anothermod:backpack;StorageTag.Items"
    ]

Weight Limit Attribute

Players can increase their weight capacity using the weight_limit attribute:

• Base value: 0.0
• Adds 0.5 weight capacity per point to both threshold and limit
• Example: +20 weight_limit = +10 threshold, +10 limit

Command Example:

/stamina attr weight_limit 40.0

Client Configs

• Color: Gray (RGB: 5592405, configurable)

---

Universal Penalties - Advanced Comparators

The Universal Penalties system now supports Instant Application and Multiplier Mode for more flexible mod integration.

New Comparator Operators

Instant Flag (!)

• Prefix any comparator with ! to apply penalties instantly
• Bypasses the gradual buildup/decay system
• Useful for sudden status changes

Multiplier Mode (*)

• Uses multiplication instead of linear scaling
• Penalty = (Difference × MaxPenalty)
• Can be combined with instant flag (!*)
• Two variants:
  • * = Triggers when value is HIGHER than threshold
  • *< = Triggers when value is LOWER than threshold

Comparator Reference

Operator	Mode	Behavior
>	Scale	Linear penalty from Threshold to WorstValue (increasing)
<	Scale	Linear penalty from Threshold to WorstValue (decreasing)
*	Multiply	Penalty per point above Threshold (capped at WorstValue)
*<	Multiply	Penalty per point below Threshold (capped at WorstValue)
!>	Instant Scale	Instant version of >
!<	Instant Scale	Instant version of <
!*	Instant Multiply	Instant version of *
!*<	Instant Multiply	Instant version of *<

Configuration Format

# Format: "Type;Key;Comparator;Threshold;WorstValue;MaxPenalty;ColorInt;IconText"
#
# Arguments:
#  1. Type:       'NBT' or 'EFFECT'
#  2. Key:        NBT path (e.g. 'thirstLevel') or Effect ID
#  3. Comparator: >, <, *, *< (with optional ! prefix)
#  4. Threshold:  Safe value where penalty starts (0%)
#  5. WorstValue: In SCALE: penalty = 100% | In MULTIPLY: hard cap
#  6. MaxPenalty: In SCALE: total penalty | In MULTIPLY: penalty per unit
#  7. ColorInt:   Decimal color code (e.g. 16711680 = red)
#  8. IconText:   Emoji/text for HUD (use 'none' to disable)

Scale Mode Examples

Default:

# Thirst dropping from 6 to 0 gradually builds penalty 0→20
"NBT;thirstLevel;<;6;0;20.0;38143;💧"

# Temperature rising from 37 to 42 gradually builds penalty 0→25
"NBT;temperature;>;37;42;25.0;16724016;🔥"

# Wither I to IV gradually builds penalty 0→40
"EFFECT;minecraft:wither;>;-1;3;40.0;3355443;💀"

Instant Application:

# Thirst penalty applies immediately with no buildup
"NBT;thirstLevel;!<;6;0;20.0;38143;💧"

# Cold temperature penalty applies instantly
"NBT;targetTemperatureLevel;!<;2;0;15.0;65535;❄"

Multiplier Mode Examples

Gradual Buildup:

# Below 6 thirst: each point lost adds 2.0 penalty (builds over time)
# Thirst 5 = 2.0, Thirst 4 = 4.0, Thirst 2 = 8.0 (capped at 30)
"NBT;thirstLevel;*<;6;30;2.0;38143;💧"

# Each poison level adds 5.0 penalty (builds over time)
# Poison I = 5.0, Poison II = 10.0, Poison III = 15.0 (capped at 50)
"EFFECT;minecraft:poison;*;0;50;5.0;4488448;☣"

# Above 10 radiation: each point adds 3.5 penalty (builds over time)
# Radiation 11 = 3.5, Radiation 15 = 17.5, Radiation 20 = 35.0 (capped at 100)
"NBT;radiation;*;10;100;3.5;65280;☢"

Instant Application:

# Below 6 thirst: each point instantly adds 2.0 penalty
"NBT;thirstLevel;!*<;6;30;2.0;38143;💧"

# Each poison level instantly adds 5.0 penalty
"EFFECT;minecraft:poison;!*;0;50;5.0;4488448;☣"

# Infection mod: each level instantly adds 10.0 penalty
"EFFECT;hordes:infected;!*;0;80;10.0;8388736;🦠"

How It Works

Scale Mode (> or <):

1. Calculates ratio between current value and range
2. Applies MaxPenalty × ratio
3. Builds/decays gradually (or instantly with !)

Multiplier Mode (* or *<):

1. Calculates difference from threshold
2. Applies MaxPenalty × difference
3. WorstValue acts as hard cap instead of range endpoint
4. Builds/decays gradually (or instantly with !)

Safe Room System:

• All penalties compete for available stamina space
• Later penalties in the config list have lower priority
• Total penalties cannot reduce stamina below minMaxStamina

Default Examples

universalPenalties = [
    # Thirst (Tough As Nails) - Gradual scale from 6 to 0
    "NBT;thirstLevel;*<;6;0;20.0;38143;💧",
    
    # Heat (Tough As Nails) - Gradual scale from 2 to 4+
    "NBT;targetTemperatureLevel;>;2;4;15.0;16724016;🔥",
    
    # Cold (Tough As Nails) - Gradual scale from 2 to 0
    "NBT;targetTemperatureLevel;<;2;0;15.0;65535;❄",
    
    # Poison - Instant multiplier mode
    "EFFECT;minecraft:poison;!*;0;50;15.0;4488448;☣"
]