Hunger Modes

config.yml → hunger.mode: overflow, bar, or disabled.

Only one of overflow/bar can be on. Toggling the other in GUI disables the first and warns.

---

overflow (default)

Stamina is the main resource. When stamina is empty, leftover exertion drains food (and saturation first if drain-saturation: true). Food is an emergency reserve, not a second stamina bar.

hunger:
  mode: overflow
  drain-per-second: 0.45
  min-hunger: 0
  drain-saturation: true
  overflow-to-food-ratio: 0.2

Bypass: soapsstamina.bypass.hunger.

---

bar

The vanilla food bar mirrors stamina percent. Eating converts into stamina restore according to stamina-food rules and vanilla food values. Players should not treat the hunger bar as independent hunger.

---

disabled

SHS does not touch food. Stamina still drains from actions. Exhaustion and overexertion still apply unless you turn those off too.

---

Stamina food

actions.yml → stamina-food lists materials that restore stamina (and optional well-fed regen). Works in all hunger modes. Bypass: soapsstamina.bypass.stamina-food.