{"id":141312,"date":"2026-06-08T12:35:01","date_gmt":"2026-06-08T09:35:01","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/"},"modified":"2026-06-08T12:35:01","modified_gmt":"2026-06-08T09:35:01","slug":"simplethirst","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/","title":{"rendered":"SimpleThirst"},"content":{"rendered":"<p>** \ud83c\udf0a SimpleThirst &#8211; Complete Plugin Documentation<\/p>\n<p>&#8212;<\/p>\n<p> \ud83d\udcd6 Overview<\/p>\n<p>**SimpleThirst** is a lightweight, highly customizable survival plugin that adds a realistic thirst system to your Minecraft server. Players must manage their hydration levels by drinking clean or dirty water sources, or they will suffer consequences including damage and debuffs. The plugin features three distinct visual display modes, world-specific control, and full data persistence across server restarts.<\/p>\n<p>**Version:** 1.0.0<br \/>\n**API:** Paper\/Spigot 1.21+<br \/>\n**Dependencies:** None<br \/>\n**Size:** ~25KB<\/p>\n<p>&#8212;<\/p>\n<p> \u2728 Key Features<\/p>\n<p> \ud83c\udfaf Core Mechanics<br \/>\n&#8211; **Dynamic Thirst System** (0-100 scale)<br \/>\n  &#8211; Automatically depletes over time (configurable interval)<br \/>\n  &#8211; **Sprint Penalty**: Thirst drops 2x faster while sprinting<br \/>\n  &#8211; **Death Penalty**: Reaching 0 thirst causes damage + nausea effect<\/p>\n<p>&#8211; **Two Water Sources**<br \/>\n  &#8211; \ud83e\uddea **Clean Water**: Drink potions\/milk buckets (+40 thirst, no risk)<br \/>\n  &#8211; \ud83c\udf0a **Dirty Water**: Sneak + right-click water blocks (+15 thirst, 30% poison\/hunger chance)<\/p>\n<p> \ud83d\udda5\ufe0f Three Display Modes<\/p>\n<p>| Mode | Location | Style | Best For |<br \/>\n|&#8212;&#8212;|&#8212;&#8212;&#8212;-|&#8212;&#8212;-|&#8212;&#8212;&#8212;-|<br \/>\n| **BOSSBAR** | Top of screen | Blue progress bar | Combining with ActionBar plugins |<br \/>\n| **ACTIONBAR** | Above hotbar | `Thirst: [\u2588\u2588\u2588\u2588\u2591\u2591\u2591\u2591\u2591\u2591] 40%` | Centered HUD display |<br \/>\n| **HUNGER_ALIGN** | Above hunger bar | `85 \ud83d\udca7` (right-aligned) | Mimicking vanilla UI |<\/p>\n<p> \ud83c\udf0d World Management<br \/>\n&#8211; **Three Filter Modes**:<br \/>\n  &#8211; `DISABLED` &#8211; Works in all worlds (default)<br \/>\n  &#8211; `WHITELIST` &#8211; Only enabled in specified worlds<br \/>\n  &#8211; `BLACKLIST` &#8211; Disabled in specified worlds<br \/>\n&#8211; **Auto-Hide Display** when entering disabled worlds<br \/>\n&#8211; **Smart Notifications** when crossing world boundaries<\/p>\n<p> \ud83d\udcbe Data Persistence<br \/>\n&#8211; Uses **PersistentDataContainer (PDC)** for player data<br \/>\n&#8211; Survives server restarts, crashes, and reloads<br \/>\n&#8211; No external database required<br \/>\n&#8211; No data loss on plugin updates<\/p>\n<p> \u2699\ufe0f Performance Optimized<br \/>\n&#8211; Asynchronous task processing<br \/>\n&#8211; Single-file plugin (no bloat)<br \/>\n&#8211; Minimal resource footprint<br \/>\n&#8211; Event-driven architecture (no polling)<\/p>\n<p>&#8212;<\/p>\n<p> \ud83c\udfae Use Cases<\/p>\n<p> \ud83c\udfdd\ufe0f Survival Servers<br \/>\nAdd an extra layer of difficulty to hardcore survival gameplay. Players must plan water sources during exploration and carry drinks for long journeys.<\/p>\n<p> \ud83c\udf10 Roleplay Servers<br \/>\nEnhance realism for medieval\/fantasy RP servers. Water becomes a valuable resource, encouraging player interaction (selling drinks, water well locations).<\/p>\n<p> \ud83c\udfc6 Challenge Servers<br \/>\nCreate custom challenges:<br \/>\n&#8211; Desert survival with limited water sources<br \/>\n&#8211; Ultra-hardcore mode with thirst + health depletion<br \/>\n&#8211; Nomadic gameplay requiring constant water search<\/p>\n<p> \ud83c\udfaa Adventure Maps<br \/>\nDesign quest lines around finding clean water sources or purification methods. Integrate with custom resource packs for immersive experiences.<\/p>\n<p> \ud83d\uddfa\ufe0f Multi-World Servers<br \/>\nEnable thirst only in specific worlds:<br \/>\n&#8211; Enable in survival worlds, disable in creative\/lobby<br \/>\n&#8211; Enable in custom challenge worlds only<br \/>\n&#8211; Disable in minigame arenas<\/p>\n<p>&#8212;<\/p>\n<p> \ud83d\udcdc Commands<\/p>\n<p>| Command | Description | Permission | Usage |<br \/>\n|&#8212;&#8212;&#8212;|&#8212;&#8212;&#8212;&#8212;-|&#8212;&#8212;&#8212;&#8212;|&#8212;&#8212;-|<br \/>\n| `\/thirst check` | View your current thirst level | `simplethirst.use` | Player only |<br \/>\n| `\/thirst set <player> <0-100>` | Set target player&#8217;s thirst | `simplethirst.admin` | Console\/Ops |<br \/>\n| `\/thirst reload` | Reload configuration | `simplethirst.admin` | Console\/Ops |<\/p>\n<p> Command Examples<br \/>\n&#8220;`<br \/>\n\/thirst check<br \/>\n\u2192 &#8220;Your thirst: 73%&#8221;<\/p>\n<p>\/thirst set Notch 100<br \/>\n\u2192 &#8220;Set Notch&#8217;s thirst to 100&#8221;<\/p>\n<p>\/thirst reload<br \/>\n\u2192 &#8220;SimpleThirst config reloaded!&#8221;<br \/>\n&#8220;`<\/p>\n<p>&#8212;<\/p>\n<p> \ud83d\udd10 Permissions<\/p>\n<p>&#8220;`yaml<br \/>\nsimplethirst.use<br \/>\n  Description: Check own thirst level<br \/>\n  Default: true (all players)<\/p>\n<p>simplethirst.admin<br \/>\n  Description: Set thirst for others &#038; reload config<br \/>\n  Default: op (operators only)<br \/>\n&#8220;`<\/p>\n<p>\ud83c\udfaf PlaceholderAPI Integration<\/p>\n<p>%simplethirst_thirst%              \u2192 75<br \/>\n%simplethirst_thirst_formatted%    \u2192 &#038;a75%<br \/>\n%simplethirst_percentage%          \u2192 75%<br \/>\n%simplethirst_status%              \u2192 Hydrated<br \/>\n%simplethirst_bar%                 \u2192 [|||||||   ]<br \/>\n%simplethirst_color%               \u2192 &#038;a (color code)<\/p>\n<p>&#8212;<\/p>\n<p> \u2699\ufe0f Configuration Guide<\/p>\n<p> Full `config.yml` Breakdown<\/p>\n<p>&#8220;`yaml<br \/>\n \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550<br \/>\n DEPLETION SETTINGS<br \/>\n \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550<br \/>\ndepletion-interval: 60<br \/>\n How often thirst decreases (in seconds)<br \/>\n Default: 60 (every minute)<br \/>\n Recommended: 30-120 for balanced gameplay<\/p>\n<p> \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550<br \/>\n DISPLAY SETTINGS<br \/>\n \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550<br \/>\ndisplay-mode: BOSSBAR<br \/>\n Options:<br \/>\n   BOSSBAR       \u2192 Blue bar at screen top (doesn&#8217;t conflict with ActionBar plugins)<br \/>\n   ACTIONBAR     \u2192 Centered text above hotbar<br \/>\n   HUNGER_ALIGN  \u2192 Right-aligned above hunger bubbles (uses ActionBar with spacing)<\/p>\n<p> \u26a0\ufe0f WARNING: ACTIONBAR and HUNGER_ALIGN will conflict with other ActionBar plugins!<\/p>\n<p> \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550<br \/>\n WATER RESTORATION<br \/>\n \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550<br \/>\nclean-water-restore: 40<br \/>\n Amount restored by drinking:<br \/>\n   &#8211; Water Bottles<br \/>\n   &#8211; Potions (any type)<br \/>\n   &#8211; Milk Buckets<\/p>\n<p>dirty-water-restore: 15<br \/>\n Amount restored by drinking from water blocks<br \/>\n (Sneak + Right-click with empty hand on water source)<\/p>\n<p>dirty-water-debuff-chance: 0.30<br \/>\n Chance (0.0 &#8211; 1.0) to get Poison or Hunger when drinking dirty water<br \/>\n 0.30 = 30% chance<\/p>\n<p> \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550<br \/>\n DAMAGE SETTINGS<br \/>\n \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550<br \/>\ndamage-amount: 1.0<br \/>\n Damage dealt when thirst = 0<br \/>\n 1.0 = 0.5 hearts<\/p>\n<p>damage-interval: 5<br \/>\n How often damage is dealt (in seconds)<br \/>\n Also applies Nausea effect<\/p>\n<p> \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550<br \/>\n WORLD FILTER<br \/>\n \u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550<br \/>\nworld-filter-mode: DISABLED<br \/>\n Options:<br \/>\n   DISABLED   \u2192 Works in all worlds (default)<br \/>\n   WHITELIST  \u2192 ONLY works in worlds listed below<br \/>\n   BLACKLIST  \u2192 Works in all worlds EXCEPT those listed below<\/p>\n<p>world-list:<br \/>\n  &#8211; world_nether<br \/>\n  &#8211; world_the_end<br \/>\n   Add world names here (case-sensitive!)<br \/>\n   Use \/worlds or check server folder for exact names<br \/>\n&#8220;`<\/p>\n<p>&#8212;<\/p>\n<p> \ud83c\udfa8 Configuration Examples<\/p>\n<p> Example 1: Hardcore Desert Server<br \/>\n&#8220;`yaml<br \/>\ndepletion-interval: 30         Thirst drops faster<br \/>\ndisplay-mode: HUNGER_ALIGN     Immersive UI<br \/>\nclean-water-restore: 30        Reduced healing<br \/>\ndirty-water-restore: 10        Risky to drink dirty water<br \/>\ndirty-water-debuff-chance: 0.50   50% chance of sickness<br \/>\ndamage-amount: 2.0             1 full heart damage<br \/>\nworld-filter-mode: WHITELIST<br \/>\nworld-list:<br \/>\n  &#8211; desert_world<br \/>\n&#8220;`<\/p>\n<p> Example 2: Casual Survival Server<br \/>\n&#8220;`yaml<br \/>\ndepletion-interval: 120        Slower depletion<br \/>\ndisplay-mode: BOSSBAR          Non-intrusive<br \/>\nclean-water-restore: 50        Generous healing<br \/>\ndirty-water-restore: 20        Still viable<br \/>\ndirty-water-debuff-chance: 0.20   Lower risk<br \/>\ndamage-amount: 0.5             0.25 hearts<br \/>\nworld-filter-mode: BLACKLIST<br \/>\nworld-list:<br \/>\n  &#8211; creative<br \/>\n  &#8211; lobby<br \/>\n  &#8211; minigames<br \/>\n&#8220;`<\/p>\n<p> Example 3: Roleplay Server<br \/>\n&#8220;`yaml<br \/>\ndepletion-interval: 90<br \/>\ndisplay-mode: ACTIONBAR<br \/>\nclean-water-restore: 40<br \/>\ndirty-water-restore: 15<br \/>\ndirty-water-debuff-chance: 0.40   Higher risk for realism<br \/>\ndamage-amount: 1.0<br \/>\nworld-filter-mode: WHITELIST<br \/>\nworld-list:<br \/>\n  &#8211; kingdoms<br \/>\n  &#8211; wilderness<br \/>\n  &#8211; trade_city<br \/>\n&#8220;`<\/p>\n<p>&#8212;<\/p>\n<p> \ud83d\udd27 How It Works (Technical)<\/p>\n<p> Data Flow<br \/>\n&#8220;`<br \/>\nPlayer Join \u2192 PDC Check \u2192 Initialize Thirst (100) if new<br \/>\n     \u2193<br \/>\nTimer Task (Every X seconds)<br \/>\n     \u251c\u2500 Check if sprinting \u2192 -2 thirst<br \/>\n     \u2514\u2500 Normal movement \u2192 -1 thirst<br \/>\n     \u2193<br \/>\nUpdate Display (BossBar\/ActionBar\/HungerAlign)<br \/>\n     \u2193<br \/>\nIf Thirst = 0 \u2192 Damage + Nausea (every 5s)<br \/>\n&#8220;`<\/p>\n<p> Event Triggers<br \/>\n&#8220;`<br \/>\nPlayerItemConsumeEvent<br \/>\n   \u2514\u2500 Potion\/Milk detected \u2192 +40 thirst<\/p>\n<p>PlayerInteractEvent<br \/>\n   \u2514\u2500 Sneak + Right-click water + Empty hand<br \/>\n       \u251c\u2500 +15 thirst<br \/>\n       \u2514\u2500 30% chance \u2192 Poison\/Hunger effect<\/p>\n<p>PlayerChangedWorldEvent<br \/>\n   \u2514\u2500 Check world filter \u2192 Show\/hide display<\/p>\n<p>PlayerJoinEvent<br \/>\n   \u2514\u2500 Load thirst from PDC \u2192 Show display<br \/>\n&#8220;`<\/p>\n<p> Display Rendering<\/p>\n<p>**BOSSBAR Mode:**<br \/>\n&#8220;`java<br \/>\nBossBar.bossBar(<br \/>\n    &#8220;Thirst: 75%&#8221;,      \/\/ Title<br \/>\n    0.75f,              \/\/ Progress (75%)<br \/>\n    Color.BLUE,         \/\/ Color<br \/>\n    Overlay.PROGRESS    \/\/ Style<br \/>\n)<br \/>\n&#8220;`<\/p>\n<p>**ACTIONBAR Mode:**<br \/>\n&#8220;`<br \/>\n&#038;bThirst: &#038;3[|||||||   ] &#038;f70%<br \/>\n         \u2191<br \/>\n    Filled bars based on thirst %<br \/>\n&#8220;`<\/p>\n<p>**HUNGER_ALIGN Mode:**<br \/>\n&#8220;`<br \/>\n&#8221;                                         85 \ud83d\udca7&#8221;<br \/>\n \u2191                                        \u2191<br \/>\n 45 spaces to push right         Thirst value + icon<br \/>\n&#8220;`<\/p>\n<p>&#8212;<\/p>\n<p> \ud83d\udd0c Compatibility<\/p>\n<p> \u2705 Compatible With<br \/>\n&#8211; **Paper 1.21+** (Recommended)<br \/>\n&#8211; **Spigot 1.21+** (Supported)<br \/>\n&#8211; **Purpur 1.21+** (Supported)<br \/>\n&#8211; Most survival plugins (Essentials, WorldGuard, etc.)<br \/>\n&#8211; Economy plugins (for custom water selling systems)<br \/>\n&#8211; Custom resource packs<\/p>\n<p> \u26a0\ufe0f Potential Conflicts<\/p>\n<p>| Plugin Type | Conflict | Solution |<br \/>\n|&#8212;&#8212;&#8212;&#8212;-|&#8212;&#8212;&#8212;-|&#8212;&#8212;&#8212;-|<br \/>\n| **Other ActionBar plugins** | Flickering displays if both use ActionBar | Set SimpleThirst to `BOSSBAR` mode |<br \/>\n| **Custom thirst plugins** | Duplicate mechanics | Choose one plugin |<br \/>\n| **Adventure\/Survival suites** | May have built-in thirst | Disable their thirst module |<\/p>\n<p> \ud83d\udd17 Recommended Plugin Combos<\/p>\n<p>**Setup 1: BossBar + ActionBar Combo**<br \/>\n&#8220;`<br \/>\nSimpleThirst \u2192 display-mode: BOSSBAR<br \/>\nUltimateHealthDisplay \u2192 display-mode: ACTIONBAR<br \/>\n&#8220;`<\/p>\n<p>**Setup 2: Clean Minimalist**<br \/>\n&#8220;`<br \/>\nSimpleThirst \u2192 display-mode: HUNGER_ALIGN<br \/>\n(No other HUD plugins)<br \/>\n&#8220;`<\/p>\n<p>**Setup 3: Full Survival Suite**<br \/>\n&#8220;`<br \/>\nSimpleThirst \u2192 display-mode: BOSSBAR<br \/>\nEssentialsX \u2192 For \/heal bypass<br \/>\nWorldGuard \u2192 Protect water sources in spawn<br \/>\nVault \u2192 Link to economy for water trading<br \/>\n&#8220;`<\/p>\n<p>&#8212;<\/p>\n<p> \ud83d\udcca Performance Metrics<\/p>\n<p>| Metric | Value |<br \/>\n|&#8212;&#8212;&#8211;|&#8212;&#8212;-|<br \/>\n| **File Size** | ~25KB (single class) |<br \/>\n| **RAM Usage** | <1MB (100 players) |\n| **CPU Impact** | Negligible (~0.01% on modern hardware) |\n| **TPS Impact** | None (async tasks) |\n| **Event Handlers** | 4 (optimized, conditional) |\n| **Database** | None (uses PDC) |\n\n---\n\n \ud83d\udce5 Installation\n\n Step-by-Step Guide\n\n1. **Download** the `SimpleThirst.jar` file\n\n2. **Upload** to your server's `plugins\/` folder\n   ```\n   server\/\n   \u251c\u2500\u2500 plugins\/\n   \u2502   \u2514\u2500\u2500 SimpleThirst.jar  \u2190 Place here\n   \u251c\u2500\u2500 world\/\n   \u2514\u2500\u2500 spigot.yml\n   ```\n\n3. **Restart** your server (not `\/reload`)\n\n4. **Configure** (optional)\n   ```\n   Edit: plugins\/SimpleThirst\/config.yml\n   ```\n\n5. **Reload config** (if changed)\n   ```\n   \/thirst reload\n   ```\n\n6. **Test in-game**\n   ```\n   \/thirst check\n   ```\n\n---\n\n \ud83c\udf93 Player Guide\n\n How to Stay Hydrated\n\n**Method 1: Clean Water (Safest)**\n- Craft Water Bottles (glass bottle + water source)\n- Drink potions (any type)\n- Drink Milk Buckets\n- **Restores:** 40 thirst\n\n**Method 2: Dirty Water (Risky)**\n1. Stand near a water source block (river, ocean, lake)\n2. Hold **SHIFT** (sneak)\n3. **Right-click** the water with an **empty hand**\n4. **Restores:** 15 thirst\n5. **Risk:** 30% chance of Poison or Hunger\n\n Visual Indicators\n\n**BossBar Mode:**\n```\n[\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591] Thirst: 40%\n```\n\n**ActionBar Mode:**\n```\nThirst: [\u2588\u2588\u2588\u2588\u2591\u2591\u2591\u2591\u2591\u2591] 40%\n```\n\n**Hunger-Aligned Mode:**\n```\n                                         40 \ud83d\udca7\n(Appears to the right, above hunger bubbles)\n```\n\n Warning Signs\n- **Below 30%** - Start looking for water\n- **Below 10%** - Urgent! Find water immediately\n- **0%** - Taking damage, vision blurry (Nausea)\n\n---\n\n\u2753 Frequently Asked Questions\n\n Q: Does thirst persist after death?\n**A:** Yes! Thirst is saved to your player data and survives death, logout, and server restarts.\n\n---\n\n Q: Can I disable thirst in certain worlds?\n**A:** Yes! Use the world filter system:\n```yaml\nworld-filter-mode: BLACKLIST\nworld-list:\n  - creative_world\n  - minigames\n```\n\n---\n\n Q: Can I use this with other health display plugins?\n**A:** Yes! Set SimpleThirst to `BOSSBAR` and your health plugin to `ACTIONBAR` (or vice versa).\n\n---\n\n Q: How do I make thirst deplete faster?\n**A:** Lower the `depletion-interval`:\n```yaml\ndepletion-interval: 30   Every 30 seconds instead of 60\n```\n---\n\n Q: Does this work with custom water blocks from mods?\n**A:** Only if the mod uses Bukkit's `Material.WATER` type. Most mods use custom blocks, which won't work.\n\n---\n\n Q: Can I make thirst deplete faster in deserts?\n**A:** Not in the current version. This would require biome detection. Consider requesting this as a feature! \n\n---\n\n Q: What happens if I drink a suspicious stew?\n**A:** It counts as a potion, so it restores 40 thirst (no negative effects from SimpleThirst).\n\n---\n\n \ud83d\udee0\ufe0f Troubleshooting\n\n Issue: Display not showing\n**Solutions:**\n1. Check your display mode in `config.yml`\n2. Verify you're in an enabled world (`\/thirst check`)\n3. Reload config: `\/thirst reload`\n4. Restart server\n\n---\n\n Issue: Flickering ActionBar\n**Cause:** Multiple plugins using ActionBar  \n**Solution:** Set one plugin to BOSSBAR mode\n\n---\n\n Issue: Thirst resets to 100 on restart\n**Cause:** PDC not saving (wrong API version)  \n**Solution:** Ensure you're using Paper\/Spigot 1.21+\n\n---\n\n Issue: Dirty water not working\n**Checklist:**\n- [ ] Are you **sneaking**?\n- [ ] Is it a **water source block** (not flowing)?\n- [ ] Is your **hand empty**?\n- [ ] Are you in an **enabled world**?\n\n---\n\n \ud83d\udcdd Credits &#038; License\n\n**Developer:** geturplugins  \n**API:** Kyori Adventure (Paper)  \n**License:** MIT (modify freely)  \n**Inspired by:** Realistic survival mechanics from games like Don't Starve, ARK\n\n---\n\n \ud83d\udcde Support &#038; Links\n\n- **Updates:** Check for new versions\n- **Discord:** geturplugins\n\n---\n\n \u2b50 Final Summary\n\n**SimpleThirst** transforms Minecraft survival by adding a realistic hydration system with:\n\n\u2705 **Smart mechanics** (sprint penalty, dirty water risk)  \n\u2705 **3 display modes** (fits any server aesthetic)  \n\u2705 **World filtering** (per-world control)  \n\u2705 **Zero dependencies** (plug-and-play)  \n\u2705 **Persistent data** (never lose progress)  \n\u2705 **Lightweight** (<1MB RAM, 0% TPS impact)  \n\nPerfect for survival, roleplay, and challenge servers seeking deeper gameplay without complexity.\n\n---\n\n**Version:** 1.1.0 | **Last Updated:** 2024 | **Made with \u2764\ufe0f for the Minecraft community****\n<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Add thirst mechanics in your server drink water to make sure you don&#8217;t die of thirst ..<\/p>\n","protected":false},"featured_media":141313,"template":"","meta":{"_minecraft_slug":"simplethirst","_minecraft_project_id":"RG6rdyWM","_minecraft_author":"geturplugins","_minecraft_license":"MIT","_minecraft_downloads":223,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"simplethirst.zip","_minecraft_size_bytes":194143,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-16T12:24:41.401567Z","_minecraft_date_created":"2026-01-24T22:09:17.790859Z","_minecraft_date_modified":"2026-03-21T14:12:08.463038Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/simplethirst","_minecraft_icon_attachment_id":141313,"_minecraft_imported_at":"2026-06-08T09:35:03+00:00","_minecraft_import_hash":"b7fcf41cc652efe5e656862781e75f65","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,128,129,123,92],"mod_loader":[132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-141312","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-technology","mod_category-utility","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>SimpleThirst - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"SimpleThirst - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Add thirst mechanics in your server drink water to make sure you don&#039;t die of thirst ..\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simplethirst\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simplethirst\\\/\",\"name\":\"SimpleThirst - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simplethirst\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simplethirst\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/simplethirst-icon-acd8825200c7d1035634d1c8cc1b9676ad3ce608_96.webp\",\"datePublished\":\"2026-06-08T09:35:01+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simplethirst\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simplethirst\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simplethirst\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/simplethirst-icon-acd8825200c7d1035634d1c8cc1b9676ad3ce608_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/simplethirst-icon-acd8825200c7d1035634d1c8cc1b9676ad3ce608_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/simplethirst\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"SimpleThirst\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"SimpleThirst - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/","og_locale":"en_US","og_type":"article","og_title":"SimpleThirst - Minecraft","og_description":"Add thirst mechanics in your server drink water to make sure you don't die of thirst ..","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/","name":"SimpleThirst - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/simplethirst-icon-acd8825200c7d1035634d1c8cc1b9676ad3ce608_96.webp","datePublished":"2026-06-08T09:35:01+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/simplethirst-icon-acd8825200c7d1035634d1c8cc1b9676ad3ce608_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/simplethirst-icon-acd8825200c7d1035634d1c8cc1b9676ad3ce608_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/simplethirst\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"SimpleThirst"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/141312","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/141313"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=141312"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=141312"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=141312"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=141312"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}