Configuration

config.yml holds essentials: general, hunger, integration, engine, overexertion, UI, context.

File	Guide
actions.yml	Actions
weight.yml	Weight and Encumbrance
worlds.yml	Worlds and Overrides
environment.yml	Environment and Weather
feedback.yml	Feedback and Empty Stamina

Tune live with /shs toggle, /shs config set, or /shs gui.
Full shipped file: Default config.yml · All files: Config Reference

Reload / restart: see Getting Started. Provider changes need a full server restart.

---

General (OP bypass and skips)

general:
  bypass-permission: "soapsstamina.bypass"
  op-bypass: false
  ignore-flying: true
  debug: false
  disabled-worlds:
    stamina: []
    weight: []

Key	Default	Effect
op-bypass	false (new installs)	OPs skip the stamina engine when true
bypass-permission	soapsstamina.bypass	Permission that skips the engine
ignore-flying	true	Skip creative/spectator fly (not elytra)
disabled-worlds.*	[]	Per-world stamina / weight off

World multipliers: Worlds and Overrides.

---

Hunger and integration

See Hunger Modes for overflow / bar / disabled.

hunger:
  mode: overflow
  drain-per-second: 0.28
  min-hunger: 0
  drain-saturation: true
  overflow-to-food-ratio: 0.12

integration:
  stamina-provider: auto
  mmocore:
    use-combat-state: true
    activity-regen-scale: 0.9
    block-native-regen-while-active: true
  mythicrpg:
    reagent: Stamina

Store setup: Choosing a Stamina Store · MMOCore Setup · MythicRPG Setup

---

UI and display choice

ui:
  enabled: true
  type: BOSS_BAR
  message-cooldown: 40
player-display-choice:
  enabled: true
  first-join-tip: true

This HUD is separate from hunger.mode: bar. Players pick with /stamina display … when allowed.

Empty-stamina look and sound: Feedback and Empty Stamina.

---

Engine

engine:
  tick-interval: 4
  players-per-tick: 0
  regen-block-idle-while-swimming: false

On Folia the engine is one task per player; players-per-tick is ignored. Changing tick-interval needs /shs reload.

---

Drain multipliers

Movement and combat drain stack several systems. Full note: Actions. Use /stamina debug in play.

Climate layers: Environment and Weather.

---

Overexertion

Keep pushing at 0 stamina → warning, then damage. Keys are in Default config.yml. Exhaustion look/feel: Feedback and Empty Stamina.