Getting Started

Install SoapsHungerStamina 1.1.6 and confirm it loads.

Requirements

Requirement	Details
Plugins	SoapsCommon, plus MMOCore + MythicLib and/or MythicRPG
Server	Paper / Spigot 26.1, 26.2, 26.3 · Folia supported
Java	21+ (Java 25 recommended)

Downloads are ZIPs. Extract the .jar into plugins/.

Installation

1. Download SoapsCommon and SoapsHungerStamina; extract both jars.
2. Install a stamina store: MMOCore + MythicLib and/or MythicRPG.
   Checklists: MMOCore Setup · MythicRPG Setup
3. Put jars in plugins/ and fully restart (not /reload).
4. If both stores are installed, pick the provider in /shs gui → Integrations → Stamina provider, then restart again.
5. Confirm green plugins and console stamina=mmocore or stamina=mythicrpg. Run /stamina.

Symptom	Fix
Red plugin, no data folder	JAR still inside a ZIP, or dependency missing
SoapsCommon green, SHS red	Store failed or Mythic reagent wrong — see Troubleshooting

First-run files

plugins/SoapsHungerStamina/
  config.yml
  actions.yml
  weight.yml
  worlds.yml
  environment.yml
  feedback.yml
  messages.yml

Full defaults: Config Reference

Admin path

1. /shs gui — Features, Values, Weight, Stamina food, World overrides
2. YAML — food / biome / item weight tables
3. /shs config set|get — power-user tweaks

Prefer GUI day-to-day; YAML for bulk lists.

Reload policy

Change	What to run
Most GUI / toggle / config edits	Apply at runtime
YAML file edits	/shs reload
engine.tick-interval	/shs reload
integration.stamina-provider	Full server restart
Jar upgrade / first install	Full server restart (not /reload)

Verify

New installs ship op-bypass: false. Upgraded configs may still have true — /shs help warns when it is on.

/stamina
/weight
/shs gui

Sprint should drain the active store. HUD default is boss bar (ui.type). Players can run /stamina display … when allowed.

Common goals

Goal	Page
Food bar shows stamina	Want food bar
Mythic only	Want Mythic only
Soften / harden drain	Want soften/harden
Disable weight	Want turn weight off
Skills share the bar	Want skills share bar

Next: Configuration · Upgrading to 1.1.6 · FAQ