Commands and Permissions

Main command: /shs (alias /soapshungerstamina). Player shortcuts: /stamina, /weight.

---

Player commands

Command	Permission	Description
/stamina or /shs stamina	soapsstamina.use	Current stamina
/stamina display	soapsstamina.display.choose	Opens display picker GUI
/stamina display <off|actionbar|bossbar|chat|default>	soapsstamina.display.choose	HUD preference (persists)
/shs stamina display <...>	same	Same as above
/stamina debug	soapsstamina.debug or soapsstamina.admin	Live multiplier snapshot
/shs stats	soapsstamina.use	Session drain/regen stats (reset on quit)
/weight or /shs weight	soapsstamina.use	Current carry weight
/shs weight info [material]	soapsstamina.use	Item weight lookup
/shs help [page]	soapsstamina.use	Paginated help

/stamina display requires player-display-choice.enabled and ui.enabled. default clears the saved preference. No args opens the picker.

---

Admin commands

Command	Permission	Description
/shs reload	soapsstamina.admin	Reload YAML
/shs gui	soapsstamina.admin	Settings GUI
/shs toggle <setting>	soapsstamina.admin	Flip a boolean or cycle hunger-mode / stamina-provider
/shs config get <group> <key>	soapsstamina.admin	Read a config value
/shs config set <group> <key> <value>	soapsstamina.admin	Set a number/string
/shs stamina give <player> <amount>	soapsstamina.admin	Add stamina
/shs stamina take <player> <amount>	soapsstamina.admin	Remove stamina
/shs stamina set <player> <amount>	soapsstamina.admin	Set stamina exactly
/shs stamina reset <player>	soapsstamina.admin	Fill stamina
/shs stamina <player>	soapsstamina.admin or debug	Other-player status line
/shs stamina inspect <player>	soapsstamina.debug or admin	Other-player debug snapshot
/shs weight set <material> <weight>	soapsstamina.admin	Write weight.yml item weight
/shs weight hand <weight>	soapsstamina.admin	Set held item weight
/shs weight encumbrance <key> <value>	soapsstamina.admin	Encumbrance numbers in weight.yml
/shs weight pack-animals <key> <value>	soapsstamina.admin	radius, relief-per-animal, max-relief, require-chest

Config set groups

Tab completion lists config groups (same knobs as Values in /shs gui, plus CLI-only groups such as context, general, sprint-lock, and ui.type). Pack-animals and encumbrance numeric writes use /shs weight … only (not /shs config set).

/shs toggle with no args prints usage. /shs toggle hunger-mode cycles Overflow → Bar → Off (with a one-line explanation). /shs toggle stamina-provider cycles Auto → MMOCore → MythicRPG (restart required to apply). /shs config set mythicrpg reagent Stamina then /shs reload sets the Mythic reagent. /shs toggle list shows common (GUI-visible) toggles; /shs toggle list all shows advanced/hidden ones too.

Stamina store setup and verify steps: Choosing a Stamina Store.

---

Permissions

Player defaults

Permission	Default
soapsstamina.use	Everyone
soapsstamina.display.choose	Everyone

Staff

Permission	Default
soapsstamina.admin	OP
soapsstamina.debug	OP

Bypass (all permission defaults false)

Bypass	Default	Effect
general.op-bypass in config.yml	false (new installs)	Players with isOp() skip the entire stamina engine
soapsstamina.bypass	false	Same skip via permission (also granted by many * OP setups)

Five category parents (use these for ranks)

Grant one parent instead of dozens of leaf nodes:

Parent	Covers
soapsstamina.bypass.movement	sprint, jump, swim, travel, tools, terrain contacts, mounts, …
soapsstamina.bypass.combat	attack, shield, winded, projectiles, mace, dodge, sprint-burst, …
soapsstamina.bypass.recovery	sneak, idle, stamina-food, bed-rest, second-wind
soapsstamina.bypass.world	biomes, altitude, weather
soapsstamina.bypass.effects	slowness, sweat, breathing, stumble

Global: soapsstamina.bypass includes the category parents (plus hunger, encumbrance, pack-animals, feedback, overexertion). Leaf nodes remain in plugin.yml for fine-grained grants.

/shs help and /shs reload warn when op-bypass is true. See FAQ.

Carry cap: soapsstamina.maxweight.<amount>.