Weight and Encumbrance

weight.yml assigns a weight to items and armor. When total weight crosses encumbrance.max-weight / severe-weight, drain, slowness, drowning, and fall damage get worse.

Displayed inventory weight is the raw sum (%shs_weight%). Pack animals lower the penalty weight (%shs_penalty_weight%) used for drain tiers, slowness, fall damage, %shs_encumbered%, and scaling-drain placeholders.

World disable: config.yml → general.disabled-worlds.weight.
Bypass: soapsstamina.bypass.encumbrance.
Per-player cap: soapsstamina.maxweight.<number> (example soapsstamina.maxweight.500).

---

Encumbrance knobs

Key	Role
max-weight	Normal encumbrance starts here
severe-weight	Severe tier
default-weight	Fallback for unlisted items
container-weight	Shulkers / bundles recurse
armor-weight	Extra drain multiplier from worn armor

Admin: /shs weight set STONE 0.5, /shs weight encumbrance max-weight 350.

---

Scaling

scaling-weight raises the carry cap from a PlaceholderAPI placeholder (often MMOCore level).
scaling-drain compares a stat placeholder to load so strong characters pay less drain for the same backpack.

Requires PlaceholderAPI. See %shs_carry_burden%, %shs_scaling_drain_mult%, and %shs_penalty_weight% in Placeholders.

MMOCore pairing checklist: enable scaling-drain + PlaceholderAPI + %mmocore_attribute_strength%; optionally scaling-weight with %mmocore_level%; tune MMOCore STA_REGEN alongside integration.mmocore.activity-regen-scale in config.yml.

---

Plugin item weights

Optional maps for MMOItems, ExecutableItems, EcoItems, and MythicCrucible. Toggle with /shs toggle mmoitems-weight (and the matching keys).

---

Pack animals (on by default)

A nearby adult chested llama, trader llama, donkey, or mule eases carry burden.

pack-animals:
  enabled: true
  radius: 8.0
  require-chest: true
  relief-per-animal: 0.20
  max-relief: 0.60
  entities:
    - LLAMA
    - TRADER_LLAMA
    - DONKEY
    - MULE

Example: one chested llama within 8 blocks → 20% less penalty weight (capped at 60%). You do not have to be leading the animal.

soapsstamina.bypass.pack-animals skips relief (full burden). Folia scans are region-safe; if the region is unloaded the last cached count is kept.

Tune: /shs toggle pack-animals
/shs weight pack-animals radius 10
/shs weight pack-animals relief-per-animal 0.25
/shs weight pack-animals require-chest true

Placeholders: %shs_pack_animals%, %shs_pack_relief%.