Stamina999

- 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