Waterborne

Installation

Get Waterborne running in a minute — it needs no other plugin.

Steps

1. Download Waterborne.jar and drop it into your server's plugins/ folder.
2. Restart the server (Java 21 required for 1.21+).
3. (Optional) Install PlaceholderAPI if you want placeholders in a scoreboard or HUD.
4. Edit config.yml and run /waterborne reload.

Thirst

Every player has a thirst bar (0–100 by default). It drains over time and you must drink to refill it.

Water & drinking

Water is the core of the plugin: it saves you from thirst, but dirty water can infect you.

Purified water (the safe option)

Purified Water never infects you. Craft it from a water bottle + an ingredient (coal by default). Dirty biomes (swamp, jungle, river…) multiply the infection risk.

# default purification recipe (config.yml)
purification:
  recipe:
    enabled: true
    ingredient: COAL     # water bottle + coal → Purified Water

Parasites

8 parasites are included. Drinking dirty water can give the water-borne ones; swimming in dirty biomes gives the aquatic ones. Each one drains something and adds symptoms.

Cures

4 remedies are included. Each cures a group of parasites and has its own crafting recipe. Right-click the remedy to cure one parasite it treats.

Commands

Base command /waterborne — aliases /wb, /thirst, /sed.

Players

Admin

Permissions

Grant these with LuckPerms or any permissions plugin.

Placeholders

Requires PlaceholderAPI. Great for a scoreboard or a custom HUD (set display.mode: NONE and render the bar yourself).

%waterborne_thirst%          # current thirst
%waterborne_thirst_max%      # max thirst
%waterborne_thirst_percent%  # thirst %
%waterborne_thirst_bar%      # text bar
%waterborne_parasites%       # number of parasites
%waterborne_infected%        # true / false

Configuration

One clean, commented config.yml. Everything below is editable, and you can add your own parasites and cures.

Thirst & display

thirst:
  max: 100.0
  decay:
    interval-ticks: 120   # 20 ticks = 1s
    base: 1.0
    sprint-extra: 1.0
    hot-biome-extra: 1.5
  effects:                # applied when thirst <= threshold
    '25': [ "slowness:0" ]
    '10': [ "slowness:1", "weakness:0" ]
    '3':  [ "slowness:2", "weakness:1", "hunger:0" ]
  damage-at-zero: { enabled: true, amount: 1.0 }

display:
  mode: BOSSBAR           # BOSSBAR | ACTIONBAR | NONE
  show-below-percent: 100 # only show when thirst is below this %

Add a parasite

parasites:
  types:
    giardia:
      name: "<#7CFC00>Giardia"
      description: [ "<gray>Intestinal protozoan from stagnant water." ]
      drain-thirst: 4.0
      drain-hunger: 0
      damage: 0.0
      effects: [ "hunger:0" ]   # effect:amplifier
      weight: 40                # relative chance to roll
      icon: SLIME_BALL          # icon in /wb status

Add a cure

cures:
  antiprotozoal_tonic:
    name: "<#7CFC00>Antiprotozoal Tonic"
    material: FERMENTED_SPIDER_EYE
    treats: [ giardia, amebiasis, cryptosporidium ]
    consume: true
    recipe:
      enabled: true
      ingredients: [ FERMENTED_SPIDER_EYE, BROWN_MUSHROOM, SUGAR ]

Player reviews

What server owners think of Waterborne.