SoapsHungerStamina Wiki
Last updated Sep 18, 2026
MMOCore stamina addon: action drain, inventory weight, hunger overflow, combat pressure, and recovery.
Version 1.1.2
Quick links
| Page | Description |
|---|---|
| Introduction | What SHS does and how it sits on MMOCore |
| Getting Started | Install, first reload, and what to tune first |
| Default Config Files | config.yml, actions.yml, weight.yml, messages.yml |
| Configuration | Worlds, UI, hunger, weather, feedback, display choice |
| Actions | Drain costs, mounted combat, custom weapon costs |
| Weight and Encumbrance | Carry weight, scaling, pack animals |
| Hunger Modes | overflow, bar, disabled |
| Abilities | Dodge, sprint burst, bed rest, stamina food |
| Endurance and Class Identity | MMOCore growth, food identity, recovery cues, identity presets |
| Commands and Permissions | /shs, /stamina, /weight |
| Admin GUI | /shs gui |
| Placeholders | PlaceholderAPI %shs_*% |
| Examples | Copy-paste snippets |
| FAQ | Common server-owner questions |
| Changelog | Version history |
Requirements
| Requirement | Details |
|---|---|
| Plugins | SoapsCommon, MMOCore, MythicLib |
| Server | Paper 26.2 |
| Spigot | 26.2 |
| Folia | Supported |
| Java | 21+ |
| Tested on | Paper 26.2, Java 25 |
Optional
| Integration | Purpose |
|---|---|
| PlaceholderAPI | %shs_*% tokens and scaling placeholders |
| MMOItems | Custom item weights and per-item attack costs; duplicate melee drain skip |
| MythicCrucible | Custom item weights and per-item attack costs |
| ExecutableItems | Custom item weights |
| EcoItems | Custom item weights |
How it fits together
MMOCore owns stamina numbers. SoapsHungerStamina decides when stamina drains and recovers from real play.
Flow: Act → drain → combat slows regen → empty stamina taps hunger → rest / food / bed recover.
Pressure extras (biomes, altitude, weather, mounted gallop, mouth-anchored feedback) default off. Helpful extras (player HUD choice, pack-animal burden relief) default on.