Default actions.yml

Shipped defaults from SoapsHungerStamina 1.1.6. After first run, this file lives in plugins/SoapsHungerStamina/.

Updating the jar does not overwrite your live copy. Use this page to compare or reset.

See also: Config Reference · Actions · Abilities

# Action costs and recovery.
# Movement, combat, tools, and rest spend or restore the RPG stamina bar.
# Most values can also be changed with /shs gui or /shs config set.
#
# Play loop: actions spend stamina. Combat and winded slow the fight.
# Empty stamina can tap hunger (config.yml). Rest, food, bed, and second wind recover.
# Pair sneak/idle regen with config.yml integration.mmocore.activity-regen-scale.


# Milliseconds after a draining action before sneak or idle regen starts.
# Stops crouch-spam recovery mid-fight. Short default keeps easy survival resty.
regen-action-cooldown: 1500

# When true, attacks and other instant costs also scale with armor weight, encumbrance,
# speed potions, well-rested, and new-player easing. Continuous drains always scale.
apply-load-multipliers-to-instant: false


# Movement
# Defaults suit an easy survival pool (about 20 to 30). Raise drains for harder play.

# Sprint while moving. Bypass: soapsstamina.bypass.sprint
sprint:
  enabled: true
  drain-per-second: 0.45
  # Block sprinting when empty, then choose how sprint unlocks again.
  lock:
    enabled: true
    # disabled | above-zero | threshold-percent
    unlock-mode: above-zero
    unlock-threshold-percent: 0.0
    warn-player: true

# Cost per jump. Bypass: soapsstamina.bypass.jump
jump:
  enabled: true
  cost: 0.55

# Drain while swimming with sprint in water. Bypass: soapsstamina.bypass.swim
swim:
  enabled: true
  drain-per-second: 0.4

# Drain while crawling through 1-block gaps. Bypass: soapsstamina.bypass.crawling
crawling:
  enabled: true
  drain-per-second: 0.2

# Drain while climbing ladders, vines, or scaffolding. Bypass: soapsstamina.bypass.climbing
climbing:
  enabled: true
  drain-per-second: 0.25

# Drain while gliding. Firework boosts do not add extra cost. Bypass: soapsstamina.bypass.elytra
elytra:
  enabled: true
  drain-per-second: 0.3

# Light drain while paddling a moving boat. Still costs nothing. Bypass: soapsstamina.bypass.boat
boat:
  enabled: false
  drain-per-second: 0.08

# Flat cost when launching with Riptide. Bypass: soapsstamina.bypass.riptide
riptide:
  enabled: true
  cost: 1.4


# Combat

# Cost per melee hit. Skips if MMOItems already spent stamina on the same swing.
# Bypass: soapsstamina.bypass.attack
attack:
  enabled: true
  cost: 0.5
  # Materials that never spend stamina on melee (WOODEN_SWORD, DIAMOND_AXE, ...).
  exclude: []
  # When enabled, sword/axe/trident/fist costs replace the generic cost above.
  weapon-costs:
    enabled: true
    sword: 0.4
    axe: 0.7
    trident: 0.55
    fist: 0.2
  mmoitems-attack-cost:
    enabled: true
    default-cost: -1          # -1 = use material costs above
    items:
      "SWORD:EXCALIBUR": 0.9  # TYPE:ID example (quote keys that contain :)
  crucible-attack-cost:
    enabled: true
    default-cost: -1
    items:
      IRON_GREATSWORD: 1.4

# Extra cost for a falling mace smash. Stacks on the normal attack cost.
# Bypass: soapsstamina.bypass.mace
mace:
  enabled: true
  cost: 1.4
  min-fall-distance: 1.5

# Raising a shield costs a little once, then drains while held.
# At or below min-stamina the shield is forced down until the player recovers.
# Bypass: soapsstamina.bypass.shield-block
shield-block:
  enabled: true
  initial-cost: 0.15
  drain-per-second: 0.06
  min-stamina: 0.5
  damage-cost: 0.3

# Hit by another entity: instant stamina loss plus a short lingering drain.
# Critical hits are harsher and briefly block all stamina regen (stagger).
# Bypass: soapsstamina.bypass.winded
winded:
  enabled: true
  # Getting hit again while winded restarts the timer.
  refresh-on-hit: true
  normal:
    instant-cost: 0.2
    drain-per-second: 0.2
    duration: 2.0
  critical:
    instant-cost: 0.65
    drain-per-second: 0.4
    duration: 2.5
    regen-lock-duration: 1.5
  # Brief idle at empty stamina can grant a clutch recovery.
  # For tighter PvP, lower recovery-percent or raise cooldown-seconds.
  second-wind:
    enabled: true
    idle-seconds: 3.0
    recovery-percent: 0.35
    cooldown-seconds: 55.0

# Bows, crossbows, tridents, and thrown items.
projectiles:
  enabled: true
  bow:
    enabled: true
    cost: 0.9
    scale-with-charge: true
  crossbow:
    enabled: true
    cost: 1.1
  trident:
    enabled: true
    cost: 1.2
  throwables:
    enabled: true
    snowball: 0.15
    egg: 0.15
    ender-pearl: 0.7
    eye-of-ender: 0.35
    splash-potion: 0.3
    lingering-potion: 0.3
    experience-bottle: 0
    firework-rocket: 0.25
    fishing-rod: 0
    wind-charge: 0.3

# Non-entity damage (fire, fall, drowning). Entity hits use winded instead.
# If winded is off, entity hits fall through here.
# Bypass: soapsstamina.bypass.damage-intake
damage-intake:
  enabled: true
  cost-per-heart: 0.15


# Interactions

# Cost per block place. Exclude materials that should stay free.
# Bypass: soapsstamina.bypass.block-place
block-place:
  enabled: true
  cost: 0.04
  exclude:
    - TORCH
    - SOUL_TORCH
    - WALL_TORCH
    - SOUL_WALL_TORCH
    - REDSTONE_TORCH
    - REDSTONE_WALL_TORCH

# Cost per block break. Bypass: soapsstamina.bypass.block-break
block-break:
  enabled: true
  cost: 0.06
  exclude: []

# Hoe, shears, brush, and flint and steel. Bypass: soapsstamina.bypass.tool-use
tool-use:
  enabled: true
  hoe-cost: 0.08
  shears-cost: 0.06
  brush-cost: 0.05
  flint-and-steel-cost: 0.06

# Empty-hand right-click on doors, levers, buttons. Off by default.
# Bypass: soapsstamina.bypass.block-interact
block-interact:
  enabled: false
  cost: 0.04


# Environment

# Wading or floating without swim sprint. Off by default (swim drain covers swimming).
# Bypass: soapsstamina.bypass.water-contact
water-contact:
  enabled: false
  drain-per-second: 0.15

# Touching lava. Bypass: soapsstamina.bypass.lava-contact
lava-contact:
  enabled: true
  drain-per-second: 0.7
  require-fire-resistance: false

# Speeds cold biome exposure while standing in powder snow. Needs biomes enabled.
# Bypass: soapsstamina.bypass.powder-snow
powder-snow:
  enabled: true
  exposure-multiplier: 1.5

# Extra drain on soul sand or soul soil. Bypass: soapsstamina.bypass.soul-sand
soul-sand:
  enabled: true
  drain-multiplier: 1.12

# Extra drain on honey blocks. Bypass: soapsstamina.bypass.honey-block
honey-block:
  enabled: false
  drain-multiplier: 1.1

# Cost per slime bounce, with a short cooldown. Bypass: soapsstamina.bypass.slime-bounce
slime-bounce:
  enabled: true
  cost: 0.3
  cooldown-ms: 500
  min-upward-velocity: 0.3

# Speed raises all drain. Haste raises mining and tool costs. Off by default.
potion-modifiers:
  enabled: false
  speed-multiplier: 1.1
  haste-multiplier: 1.08


# Recovery
# After the action cooldown, sneak should refill an easy pool (about 20 to 30) in under 20 seconds.
# Idle is a slower top-up. Food gives instant help.

# Bonus regen while crouching. Scaled by activity-regen-scale in the main config.
# Bypass: soapsstamina.bypass.sneak
sneak:
  enabled: true
  regen-per-second: 1.35

# Slow regen while fully still. Also scaled by activity-regen-scale.
# Bypass: soapsstamina.bypass.idle
idle:
  enabled: true
  regen-per-second: 0.7

# Travel rations: small restore. Feasts: stronger restore plus Well Fed while resting.
# Per item: instant-stamina, buff-duration (seconds), buff-regen-bonus (per second while idle).
# In hunger.mode bar, restore is max(instant-stamina, food-points converted to stamina).
# Bypass: soapsstamina.bypass.stamina-food
stamina-food:
  enabled: true
  items:
    # Feasts (big meals / rare food)
    GOLDEN_APPLE:
      instant-stamina: 8.0
      buff-duration: 25
      buff-regen-bonus: 0.45
    ENCHANTED_GOLDEN_APPLE:
      instant-stamina: 14.0
      buff-duration: 45
      buff-regen-bonus: 0.8
    RABBIT_STEW:
      instant-stamina: 6.5
      buff-duration: 35
      buff-regen-bonus: 0.35
    MUSHROOM_STEW:
      instant-stamina: 5.0
      buff-duration: 22
      buff-regen-bonus: 0.28
    BEETROOT_SOUP:
      instant-stamina: 4.5
      buff-duration: 18
      buff-regen-bonus: 0.22
    PUMPKIN_PIE:
      instant-stamina: 5.0
      buff-duration: 18
      buff-regen-bonus: 0.25
    COOKED_BEEF:
      instant-stamina: 5.5
      buff-duration: 14
      buff-regen-bonus: 0.22
    COOKED_PORKCHOP:
      instant-stamina: 5.5
      buff-duration: 14
      buff-regen-bonus: 0.22
    # Travel rations
    GOLDEN_CARROT:
      instant-stamina: 4.5
      buff-duration: 12
      buff-regen-bonus: 0.22
    COOKED_MUTTON:
      instant-stamina: 4.0
      buff-duration: 10
      buff-regen-bonus: 0.18
    COOKED_CHICKEN:
      instant-stamina: 3.5
      buff-duration: 10
      buff-regen-bonus: 0.16
    COOKED_SALMON:
      instant-stamina: 3.0
      buff-duration: 8
      buff-regen-bonus: 0.14
    COOKED_COD:
      instant-stamina: 2.5
      buff-duration: 6
      buff-regen-bonus: 0.1
    BAKED_POTATO:
      instant-stamina: 2.5
      buff-duration: 6
      buff-regen-bonus: 0.1
    BREAD:
      instant-stamina: 2.0
      buff-duration: 5
      buff-regen-bonus: 0.08
    COOKED_RABBIT:
      instant-stamina: 3.0
      buff-duration: 8
      buff-regen-bonus: 0.12
    APPLE:
      instant-stamina: 1.25
    SWEET_BERRIES:
      instant-stamina: 0.75
    DRIED_KELP:
      instant-stamina: 0.9
    COOKIE:
      instant-stamina: 0.6
    MELON_SLICE:
      instant-stamina: 0.9
    CARROT:
      instant-stamina: 1.0
    POTATO:
      instant-stamina: 0.8
    HONEY_BOTTLE:
      instant-stamina: 2.0
      buff-duration: 8
      buff-regen-bonus: 0.12

# Optional dodge dash. Off by default.
dodge:
  enabled: false
  cost: 3.0
  cooldown-ms: 1500
  velocity: 1.2
  invulnerable-ticks: 12
  sound: ENTITY_PLAYER_ATTACK_SWEEP
  sound-volume: 0.8
  sound-pitch: 1.3

# Optional burst of speed while sprinting. Off by default.
sprint-burst:
  enabled: false
  min-stamina-percent: 70.0
  cost: 4.5
  speed-amplifier: 1
  duration-ticks: 50
  cooldown-ms: 25000
  activation-window-ms: 400
  cooldown-message: false
  sound: ENTITY_PLAYER_LEVELUP
  sound-volume: 0.6
  sound-pitch: 1.8

# Sleep restores stamina and can grant a short well-rested drain reduction.
# For combat servers, lower restore-percent or raise cooldown-seconds.
bed-rest:
  enabled: true
  restore-percent: 1.0
  cooldown-seconds: 180
  minimum-sleep-ms: 1000
  buff-enabled: true
  buff-duration-seconds: 90
  buff-drain-reduction: 0.55
  sound: ENTITY_PLAYER_LEVELUP
  sound-volume: 0.7
  sound-pitch: 1.4

# Galloping drains stamina. Mounted swings cost more unless the lance bonus applies.
# Off by default.
mounted:
  enabled: false
  sprint-drain-per-second: 0.4
  attack-cost-multiplier: 1.1
  min-speed: 0.12
  lance-bonus:
    enabled: true
    cost-multiplier: 0.85
    min-mount-speed: 0.2