ВЕРСИИ (13)

## [1.1.2] - 2026-07-14 ### Fixed * Fixed jump detection logic - jumping now properly consumes stamina and no longer prevents regeneration until landing (was detecting landing instead of jumping) * Fixed stamina regeneration while walking when `enable-standing-still-regen: false` - players can now regenerate stamina while walking (not sprinting/swimming/jumping) * Fixed stamina consumption while riding vehicles (horses, boats, etc.) - stamina no longer drains while mounted * Fixed shield low-stamina cooldown - now tracked per-player in data.yml instead of using item cooldown (persists across shield swaps/drops) * Fixed swimming toggle flickering at water surface - now checks if player's feet are in water before forcing swim state off * Fixed player data persistence - all PlayerData fields (well-rested buff, combat state, message cooldowns, shield cooldown, wasOnGround) now save/load correctly across restarts * Fixed biome-specific stamina config parsing - added validation for amount/interval-seconds with sensible defaults * Fixed VehicleExitEvent - now properly updates wasOnGround state when exiting vehicles ### Added * Added horse/vehicle stamina recovery support - stamina now regenerates while riding (configurable via `enable-standing-still-regen`) * Added shield cooldown tracking to player data - cooldown persists through shield swaps and world changes * Added wasOnGround tracking in PlayerData for reliable jump detection ### Changed * Improved biome configuration validation - missing amount/interval-seconds now default to 1.0 instead of causing errors * Shield low-stamina cooldown now uses player data instead of item cooldown (more reliable)

- Fixed shield stamina-break behavior so shield protection is now reliably disabled when stamina is below the configured threshold. - Improved shield low-stamina handling to force the shield out of active blocking state instead of only applying cooldown. - Fixed bow stamina usage so drawing a bow now correctly consumes stamina. - Added crossbow stamina usage with a separate configurable drain value and a lower default cost than bow usage. - Added a dedicated low-stamina warning message for crossbow loading. - Added broad server compatibility so the same build loads on 1.19.2, 1.20.4, and 1.21+.

- Added a configurable low-stamina gravity penalty so players feel heavier when stamina drops below the threshold. - Added shield block stamina drain that scales with blocked damage, including a configurable damage cap (default 20.0) for per-hit stamina calculations. - Added low-stamina shield failure behavior so shields can stop protecting when stamina is under the configured threshold, with configurable cooldown timing. - Improved low-stamina effect handling so managed penalties are cleaned up more reliably when stamina systems are inactive. - Improved cross-version effect compatibility so stamina penalties remain stable across modern server versions. - Fixed stale command usage fallback text for the leaderboard subcommand.

- Fixed stamina regeneration to honor the configured regeneration amount. - Fixed regeneration delay timing so configured seconds are applied correctly. - Fixed stamina drain rates to match configured interval timing regardless of update frequency. - Fixed stamina-consuming actions so stamina no longer drops below zero and exhaustion triggers consistently. - Fixed exhaustion state to reset when stamina fully regenerates. - Fixed movement/jump handling to avoid errors when a move event has no destination. - Fixed invalid update intervals so the stamina update loop always runs safely.

### New Features - **Per-Food Stamina Values** — Each food type can now restore a different amount of stamina. For example, Cooked Beef restores 15, Bread restores 5, and Golden Apples restore 30. Any food not listed in the config falls back to the default `stamina-food-regen` value. Over 20 foods are pre-configured out of the box. - **Per-World Stamina Settings** — Stamina can now be completely disabled in specific worlds (e.g., a lobby world) or have its drain and regeneration rates scaled per world. Each world can have its own `drain-multiplier` and `regen-multiplier` to make certain worlds harder or easier. - **Leaderboard Command** — `/stamina leaderboard` shows the top 10 players with the highest max stamina. Includes both online and offline players. All leaderboard messages are fully customizable in messages.yml. - **Proximity Stamina Sharing** — Players near each other now receive a stamina regeneration bonus. The distance and bonus multiplier are both configurable. By default, players within 20 blocks of each other get a 1.2x regen boost. - **Mining Added to Stamina Consumption List** — Mining stamina cost is now configured under the `stamina-consumption` section alongside walking, sprinting, swimming, jumping, attacking, and drawing a bow. ### Bug Fixes - Fixed the PlaceholderAPI expansion reporting an outdated version number.

### New Features - **Persistent Stamina Data** Player max stamina and current stamina are now saved and restored across server restarts, player disconnects, and reconnects. No more losing progress. - **Auto-Save** All player stamina data is automatically saved every 5 minutes to prevent data loss from unexpected shutdowns. - **`/stamina give <player> <amount>` Command** A new additive command for stamina progression. Unlike `set`, which overwrites the value, `give` adds to a player's max stamina without risk of lowering it. Designed for use with consumable items, skill trees, quest rewards, zone events, and shop purchases. Only accepts positive values. Refills current stamina to the new max upon use. - **Configurable Give Command Messages** Five new messages added to `messages.yml` for the give command: - Feedback message sent to the admin who ran the command - Feedback message sent to the player receiving the stamina - Usage hint when the command is used incorrectly - Permission denied message - Error message when a non-positive amount is provided - **Documented Configuration Files** `config.yml` and `messages.yml` now include clear, organized comments explaining every setting, available placeholders, and expected values. ### Bug Fixes - **Fixed conflicting slowness effects** Three separate systems were applying the Slowness potion effect with different amplifiers and durations, causing visual flickering and unpredictable movement behavior. Slowness is now managed from a single source with consistent behavior. - **Fixed duplicate swimming exhaustion checks** The swimming exhaustion warning was being evaluated twice per tick, which could cause redundant processing. Consolidated into a single check. - **Fixed incorrect jump detection** The vertical movement threshold used to detect jumps was set too low, causing false triggers from walking up stairs, slabs, and minor terrain changes while missing actual jumps entirely. Corrected the detection range to accurately capture real jumps.

### Creative/Spectator Mode Exclusions - Players in CREATIVE or SPECTATOR modes are now completely exempt from stamina consumption - Both main update loop and consumption methods check game modes

### Added - Swimming stamina threshold - players can't swim when below configured stamina percentage - Configurable stamina regeneration settings with options to disable regeneration while sprinting, swimming, or jumping - Option to enable/disable standing still stamina regeneration with configurable settings - Swimming-specific exhaustion message in messages.yml - New configuration section for stamina regeneration settings - Swimming threshold percentage setting in configuration ### Changed - Fixed in-game reload command to properly update all online players without requiring server restart - Swimming now consumes double stamina when below threshold, making sustained swimming impossible - Enhanced stamina regeneration logic with configurable conditions - Improved swimming exhaustion handling with proper messaging

### Added - Added configurable messages system with messages.yml file - Allow customization of all plugin messages through external configuration ### Changed - Fixed slowness effect to properly respect configured threshold percentage - Slowness now correctly applies based on configured value instead of hardcoded 50% - All messages are now configurable instead of hardcoded

### Added - **Stamina Commands:** - `/stamina check [player]`: Players can view their current and maximum stamina. Administrators can check other players' stamina. - `/stamina reload`: Allows server administrators to reload the plugin's configuration without restarting the server. - `/stamina set <player> <amount>`: Administrators can manually set a player's current stamina to a specific value. - `/stamina max <player> <amount>`: Administrators can manually set a player's maximum stamina capacity. - **Configurable Stamina Consumption:** - **Swimming Stamina:** Stamina now drains when swimming, with a configurable rate per second. - **Mining Stamina:** Stamina now drains for each block mined, with a configurable cost per block. - **Action-Based Stamina:** Configurable stamina costs for jumping, attacking entities, and drawing a bow. - **Biome-Specific Stamina Drain:** Walking stamina consumption can now be configured to vary depending on the biome the player is in. - **Low Stamina Effects:** - Introduced configurable effects that apply when a player's stamina falls below a certain percentage (threshold is configurable). - Options to apply Mining Fatigue, Nausea, and reduce attack damage when stamina is low. - **Stamina Display Options:** - Added an option to display stamina in a Boss Bar, providing a more prominent visual indicator. - The display type can be configured to use the Experience Bar, Action Bar, Boss Bar, or no display.

### New Features * **Configurable Display Options:** You can now configure how and where the stamina is displayed. * **Experience Bar:** A new option `show-in-exp-bar` in the `config.yml` allows you to show or hide the stamina in the experience bar. * **Action Bar:** A new option `show-in-action-bar` in the `config.yml` allows you to show or hide the stamina in the action bar. * **Custom Action Bar Message:** You can now customize the action bar message using the `action-bar-message` option in the `config.yml`. Use `%current%` and `%max%` as placeholders for the current and maximum stamina. * **PlaceholderAPI Support:** The plugin now supports PlaceholderAPI. You can use the following placeholders in your scoreboard or other plugins: * `%stamina_current%`: Displays the player's current stamina. * `%stamina_max%`: Displays the player's maximum stamina. ### Changes * The `updateActionBar` method now uses `player.spigot().sendMessage` to display the action bar message, ensuring compatibility with Spigot servers. * Added a note in the `config.yml` to clarify that the maximum level displayed in the experience bar is 20, which corresponds to 100 stamina.

* New Feature: Swimming Stamina Drain * New Feature: "Well Rested" Buff * Configurable Starting Stamina: * Critical Bugfix: Fixed an incorrect class path in plugin.yml that prevented the plugin from loading. * A lot of configuration changes (changelog will be updates later to include them)

the first release