Stamina999

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