Actions

Costs live in actions.yml. Each action has enabled, a cost or drain-per-second, and a bypass permission soapsstamina.bypass.<name>.

After any draining action, sneak/idle regen waits regen-action-cooldown milliseconds.

---

Core movement and combat

Action	Default	Notes
sprint	on	Drain while sprinting and moving
jump	on	Per jump (statistic-based, no missed jumps)
swim	on	Sprint-swim
attack	on	Melee hit; see weapon costs below
shield-block	on	Initial cost + drain while blocking
winded	on	Hit taken → instant cost + lingering drain
projectiles	on	Bow / crossbow / trident / throwables
elytra, climbing, crawling	on	Movement drains
boat	on	Paddling only (not mounted gallop)
mace	on	Extra smash cost while falling
idle / sneak regen	on	Gated by combat tag + cooldown

Creative, spectator, soapsstamina.bypass, and general.op-bypass skip the engine.

---

Weapon attack costs

Resolution order on a melee hit:

1. MMOItems TYPE:ID if mmoitems-attack-cost.enabled and the item has MMOItems NBT
2. MythicCrucible / MythicMobs PDC id if crucible-attack-cost.enabled
3. Material suffix: *_SWORD, *_AXE, TRIDENT, fist
4. attack.cost

If MMOItems already spent stamina for that swing, SHS skips the hit entirely (no custom TYPE:ID cost on top). /stamina debug shows MMOItems skip.

attack:
  weapon-costs:
    enabled: true
    sword: 0.55
    axe: 0.95
    trident: 0.85
    fist: 0.25
  mmoitems-attack-cost:
    enabled: true
    default-cost: -1          # -1 = fall through to material / default
    items:
      "SWORD:EXCALIBUR": 1.2
  crucible-attack-cost:
    enabled: true
    default-cost: -1
    items:
      IRON_GREATSWORD: 2.0

Tune: /shs toggle mmoitems-attack-cost
/shs config set mmoitems-attack-cost SWORD:EXCALIBUR 1.2
/shs config set crucible-attack-cost IRON_GREATSWORD 2.0
/shs config set weapon-costs sword 0.55

ExecutableItems and EcoItems are weight-only (no attack cost maps).

---

Mounted combat (off by default)

Applies to AbstractHorse: horse, camel, donkey, mule, llama. Not pigs, striders, minecarts, or boats (boat stays boat).

mounted:
  enabled: false
  sprint-drain-per-second: 0.55
  attack-cost-multiplier: 1.15
  min-speed: 0.12
  lance-bonus:
    enabled: true
    cost-multiplier: 0.85
    min-mount-speed: 0.2

Gallop drain stacks with world multipliers, weather (if on), armor, encumbrance, well-rested, and new-player easing. Mounted swings stack with PvP/PvE attack multipliers. Charging with a sword or trident uses the lance multiplier instead of attack-cost-multiplier.

Bypass: soapsstamina.bypass.mounted.

Tune: /shs toggle mounted · /shs toggle mounted-lance
/shs config set mounted sprint-drain-per-second 0.55

See Abilities for how dodge/sprint-burst interact with combat state (they do not replace mounted rules).

---

Block interact (off by default)

Right-click a block with an empty hand (doors, levers, buttons). Bypass: soapsstamina.bypass.tool-use (same as tool-use).

---

Instant vs tick multiplier stacking

Drain type	World worlds: mult	Per-action override	Load multipliers (armor, encumbrance, scaling-drain, speed, well-rested, new-player)
Tick movement (sprint, swim, shield hold, etc.)	yes	yes	yes (always)
Instant (attack, block break, bow, dodge, etc.)	yes	yes	only if apply-load-multipliers-to-instant: true

Haste still scales block-break and tool-use only. PvP/PvE multipliers apply to combat-related instant drains regardless of the load flag.