## 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.

```yaml

# 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).