Introduction

SoapsHungerStamina (SHS) is an action layer on MMOCore stamina. It does not replace MMOCore stats, classes, or STA_REGEN. It spends and restores that stamina from sprinting, combat, weight, environment, food, and rest.

What players feel

• Sprinting, jumping, swimming, swinging, blocking, and projectiles cost stamina.
• At zero, slowness, sweat, heavy breathing, stumble, and optional overexertion damage kick in.
• A heavy inventory drains faster and can drown or fall harder.
• Hunger can be an emergency reserve (overflow) or a visual stamina bar (bar).
• Optional abilities: dodge, sprint burst, bed rest, stamina food.

What 1.1.0 adds

Feature	Default	Notes
Player HUD choice	On	/stamina display persists across relog; default restores server ui.type
MMOItems / Crucible attack costs	On (maps empty-ish)	Per-item melee costs; MMOItems skip still prevents double drain
Mounted gallop + saddle swings	Off	Horses, camels, donkeys, mules, llamas. Not pigs, striders, minecarts, or boats
Weather	Off	Rain/thunder on exposure and sprint
Pack animals	On	Nearby chested llama / donkey / mule eases penalty weight, not displayed weight
Mouth-anchored feedback	Off	Quiet breath / heartbeat / encumbered footsteps
/stamina debug	Admin	Live multiplier snapshot
Folia	Supported	Per-player entity tasks; Paper and Spigot use the Bukkit timer

Design rules

• MMOCore is the stamina store. SHS never invents a second stamina bar.
• Bypass permissions exist per action and as a global soapsstamina.bypass.
• World lists can disable stamina and/or weight independently.
• Pressure extras stay off until you flip them in GUI or YAML (same idea as biomes and dodge).