SimpleThirst icon

SimpleThirst -----

Add thirst mechanics in your server drink water to make sure you don't die of thirst ..



SimpleThirst

A Lightweight & Fully Configurable Thirst System
⭐ Transform your survival experience with realistic hydration mechanics! ⭐
COMMANDS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Command Description Permission
/thirst check View your current thirst level simplethirst.check
/thirst gui Open the thirst statistics GUI simplethirst.gui
/thirst set <player> <amount> Set a player's thirst level (0-100) simplethirst.set
/thirst add <player> <amount> Add thirst to a player simplethirst.add
/thirst reload Reload all configuration files simplethirst.reload
Command Aliases: /hydration, /water PERMISSIONS ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
simplethirst.use
  • Description: Basic thirst commands
  • Default: true
  • Children:
    • simplethirst.check (Check your thirst)
    • simplethirst.gui (Open stats GUI)
simplethirst.check
  • Description: Check your own thirst level
  • Default: true
simplethirst.gui
  • Description: Open the thirst statistics GUI
  • Default: true
simplethirst.admin
  • Description: Full admin access
  • Default: op
  • Children:
    • simplethirst.set (Set player thirst)
    • simplethirst.add (Add thirst to players)
    • simplethirst.reload (Reload configs)
    • simplethirst.gui.others (View other players' stats)
    • simplethirst.bypass (Bypass entire thirst system)
simplethirst.set
  • Description: Set any player's thirst level
  • Default: op
simplethirst.add
  • Description: Add/remove thirst from players
  • Default: op
simplethirst.reload
  • Description: Reload configuration files
  • Default: op
simplethirst.gui.others
  • Description: View other players' thirst stats
  • Default: op
simplethirst.bypass
  • Description: Completely bypass the thirst system
  • Default: false
  • Note: Players with this permission have infinite thirst
✨ FEATURES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  • Dynamic Thirst System
    • 0-100 thirst scale with smooth depletion
    • Sprint penalty: 2x faster depletion while running
    • Configurable depletion intervals
    • AFK detection - thirst pauses when not moving!
  • Two Water Sources
    • Clean Water: Potions, Water Bottles, Milk (+40 thirst, safe)
    • Dirty Water: Shift+Right-click water blocks (+15 thirst, risky!)
    • Configurable debuff chances and effects
  • ️ Three Display Modes
    • BOSSBAR - Clean progress bar at screen top
    • ACTIONBAR - Centered HUD above hotbar
    • HUNGER_ALIGN - Mimics vanilla UI positioning
  • World & Gamemode Filtering
    • WHITELIST, BLACKLIST, or DISABLED modes
    • Per-gamemode control (Survival only, etc.)
    • Auto-hide display when entering disabled worlds
  • ⚗️ Configurable Effects System
    • Dehydration effects (when thirst = 0)
    • Dirty water sickness effects
    • Full control over effect types, duration, and amplifiers
  • Beautiful Statistics GUI
    • Interactive player stats display
    • Fully customizable appearance
    • Real-time thirst information
  • Full Message Customization
    • Separate messages.yml file
    • Toggle individual message types
    • PlaceholderAPI support
  • ⏸️ AFK Detection System
    • Pause thirst when players are idle
    • Configurable AFK timeout
    • Optional reduced depletion while AFK
    • Multiple activity resets (movement, chat, interaction)
⚙️ CONFIGURATION ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Code (YAML):
# ═══════════════════════════════════════════════════ # SimpleThirst Configuration v1.3.2 # ═══════════════════════════════════════════════════ # How often thirst decreases (in seconds) depletion-interval: 60 # Display mode: BOSSBAR | ACTIONBAR | HUNGER_ALIGN display-mode: BOSSBAR # ═══════════════════════════════════════════════════ # CHAT FEEDBACK SETTINGS # ═══════════════════════════════════════════════════ chat-feedback:   enabled: true   show-drinking-messages: true   show-thirst-warnings: true   show-world-change-messages: true   show-command-feedback: true   show-death-messages: true # ═══════════════════════════════════════════════════ # GAMEMODE SETTINGS # ═══════════════════════════════════════════════════ gamemode-filter:   enabled: true   allowed-gamemodes:     - SURVIVAL # ═══════════════════════════════════════════════════ # DISPLAY UPDATE MODE # ═══════════════════════════════════════════════════ display-update-mode: STATIC display-show-duration: 3 display-hide-duration: 2 static-update-interval: 20 # ═══════════════════════════════════════════════════ # THIRST SETTINGS # ═══════════════════════════════════════════════════ clean-water-restore: 40 dirty-water-restore: 15 dirty-water-debuff-chance: 0.30 damage-amount: 1.0 damage-interval: 5 # ═══════════════════════════════════════════════════ # AFK DETECTION SETTINGS # ═══════════════════════════════════════════════════ afk-detection:   enabled: true   afk-time: 30   movement-threshold: 0.5   reduced-depletion-while-afk: false   afk-depletion-rate: 0.5   reset-on-interaction: true   reset-on-chat: true   reset-on-inventory: true   reset-on-damage: true # ═══════════════════════════════════════════════════ # DEHYDRATION EFFECTS # ═══════════════════════════════════════════════════ dehydration-effects:   enabled: true   effects:     - type: MINING_FATIGUE       duration: 200       amplifier: 0     - type: SLOWNESS       duration: 200       amplifier: 1 # ═══════════════════════════════════════════════════ # DIRTY WATER EFFECTS # ═══════════════════════════════════════════════════ dirty-water-effects:   enabled: true   effects:     - type: HUNGER       duration: 200       amplifier: 0     - type: POISON       duration: 100       amplifier: 0 # ═══════════════════════════════════════════════════ # WORLD FILTER # ═══════════════════════════════════════════════════ world-filter-mode: DISABLED world-list:   - world_nether   - world_the_end # ═══════════════════════════════════════════════════ # GUI SETTINGS # ═══════════════════════════════════════════════════ gui:   title: "&b&lThirst Statistics"   size: 27   background-enabled: true   background-material: BLACK_STAINED_GLASS_PANE   player-head-slot: 13   thirst-item-slot: 11   status-item-slot: 15 # ═══════════════════════════════════════════════════ # PLACEHOLDERAPI SETTINGS # ═══════════════════════════════════════════════════ placeholders:   enabled: true
Code (YAML):
# ═══════════════════════════════════════════════════ # SimpleThirst Messages # ═══════════════════════════════════════════════════ prefix: "&b&l[Thirst]&r" # ═══════════════════════════════════════════════════ # GENERAL MESSAGES # ═══════════════════════════════════════════════════ thirst-check: "{prefix} &7Your thirst: &b{thirst}%" thirst-max: "{prefix} &aYour thirst is already full!" thirst-low: "{prefix} &e⚠ You're getting thirsty!" thirst-critical: "{prefix} &c&l⚠ CRITICAL THIRST!" thirst-death: "&c&lYou are dying of thirst!" # ═══════════════════════════════════════════════════ # WATER DRINKING # ═══════════════════════════════════════════════════ clean-water-drink: "{prefix} &a+{amount} Thirst &7(Clean Water)" dirty-water-drink: "{prefix} &3+{amount} Thirst &7(Dirty Water)" dirty-water-sick: "{prefix} &cThe dirty water made you sick!" dirty-water-lucky: "{prefix} &aYou feel fine... this time." # ═══════════════════════════════════════════════════ # COMMANDS # ═══════════════════════════════════════════════════ thirst-set-self: "{prefix} &aYour thirst was set to &b{thirst}%" thirst-set-other: "{prefix} &aSet &b{player}'s&a thirst to &b{thirst}%" thirst-set-target: "{prefix} &eYour thirst was set to &b{thirst}% &eby an admin." config-reloaded: "{prefix} &aConfiguration reloaded successfully!" # ═══════════════════════════════════════════════════ # STATUS COLORS # ═══════════════════════════════════════════════════ status-colors:   hydrated: "&a"   thirsty: "&e"   dehydrated: "&c"   critical: "&c&l"
PLACEHOLDERAPI ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Code (Text):
%simplethirst_thirst%            →  75 %simplethirst_thirst_formatted%  →  &a75% %simplethirst_percentage%        →  75% %simplethirst_status%            →  Hydrated %simplethirst_status_colored%    →  &aHydrated %simplethirst_bar%               →  [|||||||   ] %simplethirst_bar_colored%       →  &a[|||||||   ] %simplethirst_color%             →  &a %simplethirst_full%              →  &a75% Hydrated
HOW TO PLAY ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Clean Water Safe & Reliable
  • Drink Water Bottles
  • Drink any Potion
  • Drink Milk Buckets
+40 Thirst No side effects!
Dirty Water Risky but Available
  • Find any water source
  • Hold SHIFT (sneak)
  • Right-click with empty hand
+15 Thirst 30% chance of sickness!

️ DISPLAY MODES ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Mode Location Style Best For
BOSSBAR Top of screen Blue progress bar Combining with ActionBar plugins
ACTIONBAR Above hotbar Thirst: [████░░░░░░] 40% Centered HUD display
HUNGER_ALIGN Above hunger bar 85 (right-aligned) Mimicking vanilla UI
PERFORMANCE ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Metric Value
File Size ~30KB
RAM Usage <1MB (100 players)
CPU Impact Negligible
TPS Impact None
Database Required None (uses PDC)
✅ COMPATIBILITY ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  • Paper 1.21+ (Recommended)
  • Spigot 1.21+
  • Purpur 1.21+
  • PlaceholderAPI
  • EssentialsX
  • WorldGuard
  • LuckPerms
  • Vault
INSTALLATION ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  1. Download SimpleThirst.jar
  2. Place in your plugins/ folder
  3. Restart your server (not /reload)
  4. Edit plugins/SimpleThirst/config.yml as needed
  5. Use /thirst reload to apply changes
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SUPPORT & COMMUNITY

[​IMG]
Made with by geturplugins | Lightweight & Configurable
Resource Information
Author:
----------
Total Downloads: 80
First Release: Jan 19, 2026
Last Update: Mar 21, 2026
Category: ---------------
All-Time Rating:
1 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings