FAQ

Short answers. Symptoms: Troubleshooting. Upgrade steps: Upgrading to 1.1.6.

Plugin is red / no files

Extract jars from ZIPs, install SoapsCommon + a stamina store, full restart. Details: Troubleshooting.

Restart vs /shs reload

Jar upgrade / provider change = full restart. YAML edits = /shs reload. Policy: Getting Started.

Where are shipped defaults?

Config Reference — one page per file, full contents.

/shs gui does nothing

Needs gui.enabled: true and soapsstamina.admin. Admin GUI

First-join tip

Set player-display-choice.first-join-tip: false, then /shs reload. Configuration

Which servers work?

Paper / Spigot 26.1–26.3, Folia. Java 21+. SoapsCommon + MMOCore/MythicLib and/or MythicRPG.

OP or Creative: no stamina

Set general.op-bypass: false and reload. Check bypass permissions and disabled worlds. Troubleshooting

Food bar as stamina?

hunger.mode: bar (not only ui.type). Want food bar · Hunger Modes

Which hunger mode?

Mode	When
overflow (default)	Normal hunger; food is emergency reserve after stamina empties
bar	Food bar shows stamina
disabled	SHS never touches food

Stamina does not drain while sprinting

Often OP bypass, world disable, or native regen filling the bar. MMOCore: leave block-native-regen-while-active: true. MMOCore Setup · Troubleshooting

Encumbrance slows regen

weight.yml encumbrance.regen-multiplier-severe (default 0.7) scales sneak/idle/Well Fed regen. /stamina debug shows enc-regen-mult. Weight and Encumbrance

Bed rest / second wind feel strong

Lower restore percent or raise cooldowns in actions.yml. Abilities · Default actions.yml

Updating from older versions

Upgrading to 1.1.6. Presentation presets are removed; use Display toggles.