Waterborne | Hardcore Hydration + Diseases [1.21+]

What is Waterborne?
Waterborne adds a hardcore thirst system that is tightly connected to waterborne parasites. Players must drink to survive — but the easy, dirty water (rivers, swamps, bottles) can infect them with parasites. The only truly safe water is purified, and infections are cleared with craftable remedies. It's a self-reinforcing survival loop: the water you need to live is also what makes you sick.

Everything is fully configurable and translated into 4 languages.

✨ Features

• Thirst system — a thirst bar that drains over time, faster when sprinting or in hot biomes. Low thirst gives debuffs; empty deals damage.
• 8 parasites — Giardia, Amebiasis, Cryptosporidium, Tapeworm, Hookworm, Guinea worm (from drinking), plus Leech & Schistosoma (from swimming). Each drains thirst, hunger or health with symptoms.
• Disease duration & severity (new in 1.4) — your body fights the illness: parasites can heal on their own after a configurable time, and non-fatal ones only weaken you (they can't kill) — you resist and recover, and die only from the ones you mark as truly fatal.
• 4 craftable cures — each remedy treats a group of parasites and has its own recipe; a broad-spectrum cures anything. Remedies are eaten with the normal eat animation, even heads or non-food items.
• Custom drinks — turn any item in your hand into a thirst-restoring drink with /wb additem, with an optional crafting recipe. Food/potion drinks are eaten or drunk the vanilla way.
• Purified water — craft safe water (never infects), and it stacks. The bridge between thirst and parasites.
• Status & recipe GUIs — /wb status shows your thirst, parasites, symptoms, the cure and its recipe. Click a parasite to open a crafting-table view of the cure, highlighting which ingredients you already have.
• Configurable display — BossBar (default, no conflicts with other plugins), ActionBar, or NONE + placeholders. Per-player toggle with /wb hud.
• PlaceholderAPI — thirst, percent, bar and parasite count for your own scoreboard/HUD.
• Fully configurable — every rate, biome, effect, parasite and cure. Add your own parasites and remedies.
• Self-updating config & languages — new options and messages are added automatically on update; your settings, edits and translations are kept. No file to delete.
• 4 languages included and fully editable (EN / ES / FR / ZH).

Dependencies
None are required — the plugin runs on its own.

• PlaceholderAPI (optional) — placeholders for scoreboards/HUD.

⌨️ Commands
Base: /waterborne · aliases /wb, /thirst, /sed
Players

• /wb status — your status GUI (thirst, parasites, cures)
• /wb hud — toggle your thirst bar
• /wb help — command list
• /wb version — version & author

Admins

• /wb thirst <get|set|add> <player> [n]
• /wb parasite <infect|cure|list> <player> [type]
• /wb give <purified|remedy-key|drink-id> [player] [n]
• /wb additem <thirst> [dirty] [id] — turn the held item into a custom drink
• /wb reload

Permissions

• waterborne.use — affected by thirst & parasites (default: true)
• waterborne.bypass — immune to thirst & parasites (default: false)
• waterborne.admin — all admin commands (default: op)

PlaceholderAPI

⚙️ Configuration
One clean, commented config.yml. Add your own parasites and cures.

Installation

1. Drop Waterborne.jar into your /plugins folder.
2. Restart the server (Java 21).
3. (Optional) Install PlaceholderAPI.
4. Edit config.yml and run /waterborne reload.

Full guide & configuration: https://infinity3113.mc-paradise.com/plugins/waterborne/