Stamina999

Features

• Dynamic Stamina System: Players have a stamina bar that depletes with actions and regenerates over time.
• Stamina Consumption for Actions:
  • Movement: Configurable stamina drain for walking, sprinting, and swimming.
  • Mining: Stamina consumed per block broken.
  • Combat: Stamina consumed for attacking and drawing a bow.
  • Movement: Stamina consumed for jumping.
• Biome-Specific Stamina Drain: Customize stamina consumption rates based on the player's current biome.
• Well-Rested Buff: Players can gain a temporary stamina regeneration boost by sleeping.
• Low Stamina Effects: Configurable negative potion effects (e.g., Mining Fatigue, Nausea) and reduced attack damage when stamina is critically low.
• Stamina Increase: Max stamina capacity can increase upon extreme exhaustion, offering a sense of progression.
• Configurable Display: Choose how players see their stamina: Experience Bar, Action Bar, or a prominent Boss Bar.
• PlaceholderAPI Support: Integrate stamina values into other plugins (e.g., scoreboards, custom UIs).

Commands

All commands start with /stamina.

• /stamina check [player]
  • Description: View your current and maximum stamina levels. If [player] is specified, administrators can check another player's stamina.
  • Permissions: stamina999.use (for self), stamina999.admin (for others)
• /stamina reload
  • Description: Reloads the plugin's config.yml file, applying changes without a server restart.
  • Permissions: stamina999.admin
• /stamina set <player> <amount>
  • Description: Manually sets a target player's current stamina to the specified amount.
  • Permissions: stamina999.admin
• /stamina max <player> <amount>
  • Description: Manually sets a target player's maximum stamina capacity to the specified amount.
  • Permissions: stamina999.admin

Configuration (config.yml)

The config.yml file allows you to customize almost every aspect of the Stamina999 plugin.

# Core settings
default-stamina: 20
max-stamina-increase-amount: 5
stamina-regen-delay: 2
stamina-regen-amount: 2
stamina-food-regen: 20

# Stamina consumption settings for general actions
stamina-consumption:
  walking:
    amount: 1
    interval-seconds: 60
  sprinting:
    amount: 3
    interval-seconds: 20
  swimming:
    amount: 3
    interval-seconds: 1 # Drains 3 stamina per second
  jumping: 1 # Stamina cost per jump
  attacking: 0.5 # Stamina cost per attack
  drawing-bow: 2 # Stamina cost for drawing a bow

# Stamina consumption per biome (overrides the default walking consumption for specified biomes)
stamina-consumption-per-biome:
  desert:
    walking:
      amount: 1.5
      interval-seconds: 60
  snowy:
    walking:
      amount: 1.2
      interval-seconds: 60

# Stamina lost per block mined
mining-stamina-per-block: 1

# "Well Rested" buff obtained from sleeping
well-rested-buff:
  duration-seconds: 300 # How long the buff lasts in seconds
  regen-multiplier: 2.0 # Multiplier for stamina regeneration (2.0 = 2x faster)

# Low stamina effects
low-stamina-effects:
  threshold-percentage: 25 # Percentage of max stamina to be considered "low" (e.g., 25 for 25%)
  apply-mining-fatigue: true
  reduce-attack-damage: true
  apply-nausea: false

# Display settings
display:
  display-type: "EXP_BAR" # Options: "EXP_BAR", "ACTION_BAR", "BOSS_BAR", "NONE"
  action-bar-message: "&eStamina: &f%current%/%max%" # Message for action bar or boss bar

PlaceholderAPI Support

Stamina999 provides the following placeholders for use with PlaceholderAPI:

• %stamina_current%: Displays the player's current stamina.
• %stamina_max%: Displays the player's maximum stamina.

Permissions

• stamina999.use: Allows a player to use /stamina check for themselves (default: true).
• stamina999.admin: Grants access to all /stamina subcommands, including reload, set, max, and checking other players' stamina (default: op).