Hunger Modes

hunger.mode in the main config: overflow, bar, or disabled.

This controls how vanilla food ties to stamina. It is not the same as ui.type (boss bar / action bar / chat HUD).

Setting	What players see
hunger.mode: overflow (default)	Normal food bar. When stamina hits 0, extra effort drains food
hunger.mode: bar	Food bar mirrors stamina % (this is “stamina on the hunger bar”)
hunger.mode: disabled	SHS never touches food
ui.type: BOSS_BAR / ACTION_BAR / CHAT	Extra stamina HUD (independent of hunger mode)

Only one of overflow/bar can be active. Switching in the GUI disables the other and warns.

---

How to enable food-bar stamina (bar)

Config

# config.yml
hunger:
  mode: bar

Then /shs reload.

In-game

1. /shs gui (needs soapsstamina.admin)
2. Features → Hunger (or System values hunger-mode cycle)
3. Set mode to Bar (“The food bar shows stamina instead of hunger.”)

Also: /shs toggle hunger-mode cycles Overflow → Bar → Off (see /shs toggle list).

Still looks like normal hunger?

1. Confirm hunger.mode: bar after reload (/shs gui should show Bar).
2. You must not be skipped by bypass. If general.op-bypass: true, OPs do not run the stamina/hunger engine. New installs ship false. Set op-bypass: false or de-op to test. See FAQ.
3. World not listed under general.disabled-worlds.stamina.
4. Remember: ui.type alone never turns the food bar into stamina. That is only hunger.mode: bar.

---

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.28
  min-hunger: 0
  drain-saturation: true
  overflow-to-food-ratio: 0.12

• drain-per-second: continuous overexertion (sprint, swim, and similar) while empty.
• overflow-to-food-ratio: instant actions (attack, jump, and similar). leftover stamina demand times this ratio becomes food demand.
• Saturation drains before food when drain-saturation is true, including when food is already at min-hunger.

Bypass: soapsstamina.bypass.hunger.

Recommended for most servers if you want a separate stamina HUD and vanilla-style hunger that only hurts after you empty stamina.

---

bar

The vanilla food bar mirrors stamina percent. Eating restores stamina:

• Unlisted foods: food points convert to stamina (foodGain / 20 × max stamina).
• Listed stamina-food items: restore is max(YAML instant-stamina, that conversion), then Well Fed if configured.

Players should not treat the hunger bar as independent hunger. soapsstamina.bypass.hunger skips bar sync and food interception (vanilla hunger for that player).

Pair with a HUD if you want both visuals:

hunger:
  mode: bar
ui:
  enabled: true
  type: BOSS_BAR   # or ACTION_BAR

Or let players pick: /stamina display bossbar / actionbar.

---

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 while idle). Works in all hunger modes.

Field	Meaning
instant-stamina	Flat stamina on eat (overflow / disabled). In bar, merged with food-point conversion via max()
buff-duration	Well Fed length in seconds (needs buff-regen-bonus > 0)
buff-regen-bonus	Extra stamina per second while idle during Well Fed

Bypass: soapsstamina.bypass.stamina-food. Edit live via /shs gui → Stamina food (instant, duration, and regen on the held item).

Defaults: Default actions.yml · Intent: Want food bar