WaterBar999
1.0.8The WaterBar plugin enhances Minecraft gameplay by implementing a thirst management system that requires players to monitor their hydration levels, collect and purify water, and adapt their survival s
1.0.8latestWaterBar999 1.0.8 The More Admin Commands Update!Sep 17, 2026 New Features
Added* a reload command,/water reload, so changes to the server settings, the biome rates, the water bar and the recipes take effect straight away instead of needing a restart. Added* three admin commands./water setgives a player an exact water level,/water addraises or lowers a level by an amount, and/water resetreturns a player to the level they start with. All three refuse impossible values and keep a player inside the configured limits. Added* command suggestions. Pressing tab now completes every command, item name and player name as you type. Added* a choice of water bar displays, so each server can pick the experience bar, text above the hotbar, a boss bar along the top of the screen, or a sidebar panel. The number of bar segments, the symbols and the colors can all be changed. Added* configurable warning and critical water levels, so a server decides exactly when players are warned and when low-water effects begin. Added* an option for how far purification messages reach, an option to choose which effect is applied when water runs critically low, and a death message for players who die of thirst, which can be turned off or rewritten.Bug Fixes
Fixed* waterskins blocking every block interaction. Holding a waterskin and right-clicking a chest, door, crafting table or any other block drank from the waterskin and cancelled the click, so the block never responded. Fixed* water and waterlogged blocks cancelling every right-click. Blocks could no longer be placed into water, waterlogged chests and doors could not be used, and anything held in the hand stopped working whenever a waterlogged stair, slab or fence was clicked. Fixed* the water bar, low-water warnings and the check command ignoring a custom maximum water level, so all of them now match the setting instead of always using one hundred. Fixed* the low-water effects never being applied because the example effects used outdated names. Outdated names in an existing setup are now translated automatically and reported in the console. Fixed* the configurable slowness duration being ignored. The effect now really is applied when water drops to the critical level, and its type, duration and strength can be set. Fixed* partially used dirty waterskins being impossible to purify. A dirty waterskin with any number of charges left can now be purified, and it no longer comes back full. Fixed* rainwater cauldrons being unusable. Water can now be taken from a filled cauldron with a bottle or an empty waterskin, which lowers the cauldron by one level. Bottled cauldron water is always clean. Fixed* player water levels being saved in a way that could lose progress or damage the stored data when several saves happened at the same time. Saving is now serialised and always completes before the plugin shuts down. Fixed* the water recipes staying behind after the plugin was reloaded or disabled, which left the server unable to craft or cook water items until it was restarted. Fixed* jumping almost never counting as activity, so the jumping dehydration multiplier now actually applies. Fixed* players in creative and spectator mode losing water and taking thirst damage. Only survival and adventure players are affected now. Fixed* the give command accepting anything as an item name and silently handing out the wrong item. Fixed* thirst damage landing an extra hit the moment water ran out, and thirsty deaths being reported as an ordinary death. Players who die of thirst now get a proper dehydration death message. Fixed* repeated rain checks doing the same work many times over for players standing near each other, and settings changes only taking effect after a restart. Fixed* the water bar taking over the experience bar without ever handing it back, and being shown to players who were not being tracked at all. Fixed* player entries being kept in memory forever after logging out, and low-water effects being removed when they were no longer needed being unreliable. Fixed* the console being unable to use any water command, and admins having no way to check or change another player's water level. Fixed* custom water items being accepted by unrelated crafting recipes, which could consume a waterskin or water bottle by accident. Fixed* the plugin's description listing the wrong waterskin recipe and a setting that did not actually work. Fixed* the placeholder values disagreeing with the configured maximum, breaking when the maximum was not set correctly, and ignoring the configured bar symbols and colors. Fixed* filling water being spammable with no feedback, and bottles being taken from the wrong inventory slot when several were held. Fixed* players in the hottest places in the world losing water slower than they should, because those areas were not covered by the default heat settings. Fixed* the version being different in different places. Everything now reports one version, and the author is credited everywhere.1.0.71.0.7 The Big Bug Fix!Feb 26, 2026 Bug Fixes
- Fixed dirty water bottles not being smeltable in furnaces. Dirty water bottles and dirty waterskins could not be placed into furnaces for purification. They can now be smelted in furnaces to produce clean water bottles and clean waterskins as intended. - Fixed cauldrons not filling with water during rain. Cauldrons near players were never gaining water levels during rainstorms. They now properly fill one level at a time when it is raining and they have a clear view of the sky. - Fixed players respawning with zero water after dying from dehydration. Players who died from dehydration damage would respawn with no water and immediately begin taking damage again. Water level now resets to the configured starting amount on respawn. - Fixed waterskin always updating the main hand even when held in the off-hand. Drinking from or filling a waterskin held in the off-hand would incorrectly modify the main hand item. The correct hand is now updated based on which hand the player used. - Fixed a potential crash when a player movement event had no destination. A missing null check on movement data could cause an error under certain conditions. This is now handled safely. - Removed an unused import that could cause compile warnings. A dependency reference that was never actually used in the code has been cleaned up.1.0.61.0.6 PlaceHolder Update!Dec 31, 2025 - Added PlaceholderAPI integration with support for water level placeholders - Added %thirstbar_water_level% placeholder to display current water level as integer - Added %thirstbar_water_level_formatted% placeholder to display current water level as decimal - Added %thirstbar_water_percentage% placeholder to display current water level as percentage - Added %thirstbar_water_bar% placeholder to display visual water bar - Added PlaceholderAPI as optional dependency with softdepend - Updated plugin version to 1.0.6 - Added placeholder information to configuration file1.0.5WaterBar999 1.0.5 The Customizable Effects UpdateNov 10, 2025 New Features:
Thirst Effects Customization:* Server owners can now fully customize negative potion effects (e.g., Weakness, Mining Fatigue, Blindness) applied at different low thirst thresholds. This is configurable via theeffects.custom-effectssection inconfig.yml. Dynamic Thirst Depletion based on Activity:* Thirst depletion rates now dynamically adjust based on player actions such as sprinting, jumping, swimming, mining, and fighting. These multipliers are configurable in thewater-loss.activity-multiplierssection ofconfig.yml.Improvements & Bug Fixes:
Robust Potion Effect Tracking:* The plugin now more accurately tracks and clears only the custom potion effects it applies, preventing unintended interference with other plugins or game mechanics. Cauldron Filling Logic Improved:* The cauldron filling mechanism has been updated to ensure more reliable block state updates. Improved Dehydration Message:* The dehydration warning message now displays whole numbers for heart damage, improving clarity for players.1.0.4WaterBar999 1.0.4Oct 3, 2025
####New Features
Rainwater Cauldron System - Passive Water Collection: Cauldrons placed outdoors will now slowly fill up with clean water during rainfall. - Configurable Rates: Server administrators can now configure how fast and how often cauldrons fill via the new
cauldronsection inconfig.yml. -fill-rate-ticks: Controls how often the plugin attempts to add water to a cauldron. -fill-chance: Sets the probability of a water level being added during each attempt. ####Waterskin Item - Multi-Use Water Container: Players can now craft a Waterskin, a new item capable of holding multiple servings of water to save precious inventory space. - Crafting: The Waterskin is crafted from 4 pieces of leather in each corner and 4 string on each side and in the center a glass bottle. - Dynamic Display: The Waterskin appears as a glowing enchanted item. Its description dynamically updates to show its current state, such as
Charges: 3/3orEmpty. - Configurable Capacity: The maximum number of charges the Waterskin can hold is configurable in the newwaterskinsection ofconfig.yml. ####New Gameplay Mechanics - Challenging Collection: To add a layer of realism, collecting water with a Waterskin will always result in a Dirty Waterskin, regardless of the water source. - Purification Methods: A Dirty Waterskin can be purified into a Clean Waterskin by: - Cooking it in a Furnace. - Placing it on a Campfire. - Configurable Cook Time: The time it takes to purify a Waterskin is configurable via
purification-time-ticksinconfig.yml.
- Configurable Slowness: The duration of theGameplay & Configuration Enhancements
Slownesseffect applied at low water levels is now configurable undereffects.low-water.slowness-durationin the config file. - Water Bottle Parity: The original behavior for glass bottles has been preserved. They still have an 80% chance of collecting Dirty Water and a 20% chance of collecting Clean Water.
- Upgraded Java Version: The plugin's source has been upgraded from Java 8 to Java 17, ensuring compatibility with modern server environments. - Improved Dependency Management: The Spigot API version is now managed by a property in theProject & Build Improvements
pom.xmlfile, making future updates simpler and more reliable.administrative Updates
- Expanded Give Command: The/water givecommand now supportswaterskinas an argument, allowing admins to spawn an empty Waterskin directly. - Updated Help Command: The/water helpcommand has been updated to reflect the newgivecommand option.1.0.3WaterBar999 1.0.3Sep 2, 2025 Features Added dynamic water depletion system with biome-based loss rates (hot, cold, default biomes). Implemented dirty and clean water items with distinct effects and lore. Added water collection mechanic from water and waterlogged blocks with 80% chance dirty water, 20% clean water. Introduced water purification via campfire smelting with custom CampfireRecipe. Added crafting recipe for dirty water (glass bottle + dirt). Implemented custom furnace purification handling via FurnaceSmeltEvent to convert dirty water to clean water. Water level displayed on player XP bar for smooth visual feedback. Configurable water restore amounts for dirty and clean water. Configurable potion effects: poison from dirty water, slowness when water is low. Dehydration damage task that damages player periodically when water reaches zero. Configurable dehydration damage amount and interval. Async player data saving to prevent server lag. Robust event handling for player join, respawn, interact, item consume, and furnace events. Permission-based commands for checking water level and giving water items. Action bar notifications for low water and dehydration status. Prevents item duplication and unintended behavior with careful inventory management. Bug Fixes Fixed waterlogged block detection by properly checking Waterlogged interface and waterlogged state. Removed use of FurnaceRecipe with custom ItemStack metadata; replaced with event-based furnace smelting handling. Fixed player data saving race conditions by loading player data once and saving asynchronously. Fixed dehydration task lingering after player death or respawn by cancelling tasks on respawn. Fixed glass bottle removal to remove exactly one bottle instead of all stacks. Reduced action bar spam by removing redundant messages and consolidating notifications. Fixed biome water loss truncation by using double precision for water levels and loss rates. Clarified config units (ticks) for potion effect durations. Prevented water farming exploits by restricting water collection to valid water or waterlogged blocks only. Improved random chance for water collection to 80% dirty, 20% clean for realism.V1.0.2WaterBar999 V1.0.2Aug 8, 2025 Configuration Changes Added Configuration Options: Introduced a new configuration structure in config.yml for water system settings: water-levels: max-water: Maximum water level (default: 100) starting-water: Starting water level for players (default: 100) warning-threshold: Water level threshold for warnings (default: 20) dirty-water-restore: Water restored from drinking dirty water (default: 5) clean-water-restore: Water restored from drinking clean water (default: 20) water-loss: hot-loss: Water loss rate in hot biomes (default: 0.66) cold-loss: Water loss rate in cold biomes (default: 0.16) default-loss: Default water loss rate (default: 0.33) hot-biomes: List of hot biomes (e.g., "DESERT", "SAVANNA", "BADLANDS") cold-biomes: List of cold biomes (e.g., "SNOWY_PLAINS", "ICE_SPIKES", "FROZEN_OCEAN") effects: dirty-water: poison-duration: Duration of poison effect from dirty water (default: 100) poison-strength: Strength of poison effect from dirty water (default: 0) Code Changes Biome Loss Rate Loading: Added loadBiomeLossRates() method to load biome-specific water loss rates from the configuration. Player Data Management: Added loadPlayerData(UUID uuid) method to load player data from player.yml. Implemented automatic creation of player data entries if they do not exist, initializing water levels to the starting value from the configuration. Introduced getPlayerConfig() and savePlayerConfig(FileConfiguration playerConfig) methods to handle player data storage in player.yml. Water Level Updates: Updated the logic in onPlayerDrink(PlayerItemConsumeEvent event) to use configurable values for restoring water levels when consuming dirty or clean water. Dynamic Water Loss: Updated the updatePlayerThirst(Player player) method to use the loaded biome loss rates, including a default loss rate for unspecified biomes. Removed Hardcoded Values: Replaced hardcoded values for maximum water, starting water, and restoration amounts with values loaded from the configuration. Updated Player Join Logic: Modified onPlayerJoin(PlayerJoinEvent event) to load player data upon joining, ensuring that player water levels are initialized correctly. Removed Unused Code: Removed any code that was not necessary for the new configuration and functionality.V1.1WaterBar 1.1Jul 22, 2025 fixed the where the plugin would spam chat if you were in creative with useless messages exp bar now actively shows how much water you have left along with still showing your exp level when you click with a water bottle it now uses up 2 of them and 1 becomes a normal water bottle for brewing and the other becomes a dirty or clean water bottleV1.0WaterBar 1.0Jul 10, 2025 the first release
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.8MSueta
Let Me Despawn
Improves performance by tweaking mob despawn rules. Say bye to pesky unintentional persistent mobs.
25MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
Emotecraft
Create your own emotes in Minecraft.
7.5MSueta