SoapsUniverse
SoapsHungerStamina
SoapsHungerStamina

Getting Started

Home

Setup

IntroductionGetting StartedDefault Config Files

Configuration

ConfigurationActionsWeight and EncumbranceHunger ModesAbilities

Admin

Commands and PermissionsAdmin GUIPlaceholders

Reference

ExamplesFAQChangelog

SoapsHungerStamina Wiki

Last updated Jul 6, 2026

Server-owner documentation for SoapsHungerStamina v1.0.7.

SoapsHungerStamina is an MMOCore stamina addon. It adds action-based stamina drain and regen, inventory weight and encumbrance, hunger integration, biome and altitude pressure, combat winded effects, overexertion damage, and optional dodge, sprint burst, and bed rest recovery.

Requirements

Plugin Required
Paper 1.21+ Yes
SoapsCommon Yes (hard dependency)
MMOCore Yes (hard dependency)
PlaceholderAPI Optional (scaling-weight, scaling-drain, %shs_*%)
MMOItems Optional (duplicate attack drain prevention, custom item weights)
ExecutableItems, EcoItems, MythicCrucible Optional (custom item weights)
Page What it covers
Introduction Feature overview and how systems connect
Getting Started Install, first config steps, go-live checklist
Configuration config.yml reference
Actions actions.yml stamina costs and recovery
Weight and Encumbrance weight.yml, scaling, penalties
Hunger Modes overflow, bar, disabled
Abilities Dodge, sprint burst, bed rest, stamina food
Admin GUI In-game settings panel
Commands and Permissions Full command and permission tables
Placeholders All 22 %shs_*% PlaceholderAPI placeholders
Default Config Files Shipped defaults and file layout
Examples Presets and tuning recipes
FAQ Common owner questions
Changelog Version history

Config files (after first run)

plugins/SoapsHungerStamina/
  config.yml      # Global rules, UI, biomes, overexertion, hunger mode
  actions.yml     # Stamina costs per action and recovery
  weight.yml      # Item weights, encumbrance, scaling
  messages.yml    # Player and admin messages (MiniMessage)

Reload with /shs reload (requires soapsstamina.admin).

Discord