SoapsUniverse
SoapsHungerStamina
SoapsHungerStamina

Getting Started

HomeIntroductionGetting StartedDefault Config Files

Systems

ConfigurationActionsWeight and EncumbranceHunger ModesAbilitiesEndurance and class identity

Reference

Commands and PermissionsAdmin GUIPlaceholders

Other

ExamplesFAQChangelog

FAQ

Last updated Sep 18, 2026

FAQ

Which server software works?

Paper 26.2, Spigot 26.2, and Folia are supported (tested on Paper 26.2, Java 25). Java 21+. Hard dependencies: SoapsCommon, MMOCore, MythicLib.

Stamina does not drain

  • Creative / spectator / flying with general.ignore-flying: true
  • soapsstamina.bypass or general.op-bypass while OP
  • World listed under general.disabled-worlds.stamina
  • MMOCore stamina API not ready yet (wait a moment after join)
  • The specific action is enabled: false

/stamina display says the feature is disabled

Set player-display-choice.enabled: true and ui.enabled: true. Permission: soapsstamina.display.choose.

MMOItems swings cost twice (or never)

If MMOItems already spent stamina, SHS skips that hit. Custom TYPE:ID costs apply only when SHS is the one charging the swing. Check /stamina debug for MMOItems skip.

Quote YAML keys: "SWORD:EXCALIBUR": 1.2.

Horse does not drain stamina

mounted.enabled defaults to false. Toggle it. The mount must be moving at or above min-speed. Boats use boat, not mounted. Pigs, striders, and minecarts are ignored.

Pack animals do nothing

  • Animal must be adult and (by default) carrying a chest
  • Within radius
  • Type listed under pack-animals.entities
  • World not in disabled-worlds.weight
  • Relief changes penalty weight, not %shs_weight%

Particles / heartbeat spam

feedback.enabled defaults false. When on, particles are player-only at the mouth, rate-limited. Bypass: soapsstamina.bypass.feedback. Global sounds.enabled: false mutes the audio half.

Folia: engine stopped after world change

1.1.0 cancels and restarts the per-player task on world change. If drain still stops, check the world disable lists.

Session stats reset

/shs stats is session-only. Lifetime stats are not stored.

Jump macro / spam

Use context.rate-limits.jump in config.yml (hardcore preset example: 8 jumps per 2000 ms). Tune live with /shs config set context jump-rate-limit-count 8 and jump-rate-limit-window-ms 2000.

Nether world multiplier does not affect attacks

As of 1.1.1, worlds: world_nether: 1.25 scales both tick drains and instant drains (attacks, mining, projectiles). Use action-world-overrides if you only want to change one action in one world.

Dodge blocked in combat

context.in-combat.allow-dodge: false means dodge is disabled while in combat (default). Set true to allow dodge during MMOCore combat tag.

PvP tuning: bed rest and second wind

  • Bed rest: actions.bed-rest.restore-percent and cooldown-seconds — default full restore every 5 minutes may be strong for PvP.
  • Second wind: actions.winded.second-wind — default 25% max stamina after 4s idle; lower recovery-percent or raise cooldown-seconds for tighter fights.
  • Winded refresh: actions.winded.refresh-on-hit: true can extend winded indefinitely in prolonged trades; set false or shorten durations for faster recovery.

Idle regen while floating in water

Default (engine.regen-block-idle-while-swimming: false): standing still in water allows idle/sneak regen. Set true to restore pre-1.1.1 behavior (swimming pose blocks regen even when not moving).

Why do I regen while sprinting?

As of 1.1.2, SHS idle/sneak regen and Well Fed only apply when you are not busy (sprint, fight, recent actions, and the same activity gate). MMOCore native STA_REGEN is also paused while busy when integration.mmocore.block-native-regen-while-active is true (default for new installs).

If stamina still climbs while sprinting:

  • Confirm the toggle is on (/shs toggle block-native-regen-while-active or Features → Recovery)
  • Stand still and confirm regen resumes
  • Check /stamina debug for activity-blocked and native-blocked

Set block-native-regen-while-active: false only if you want soft MMOCore regen during sprint, and tune class STA_REGEN instead.

Encumbrance slows recovery

weight.yml encumbrance.regen-multiplier-normal (default 1.0) and regen-multiplier-severe (default 0.5) scale SHS sneak/idle/Well Fed regen. Change live with /shs weight encumbrance regen-multiplier-severe 0.5. /stamina debug shows enc-regen-mult.

With recovery-cues.enabled: true, players get a short line when they start resting while heavy.

Fair public defaults and class feel

Use presets/public-smp.yml for softer first-hour pressure. Use identity-fighter.yml, identity-swimmer.yml, or identity-climber.yml as selective overlays. Full guide: Endurance and Class Identity.