H2Oh!

H20h

A complete thirst system plugin for Minecraft servers (PaperMC/Spigot).

Features

- Customizable Thirst System - Players have a thirst level that decreases over time. - Maximum thirst level is configurable. - Thirst decreases at a configurable rate. - Thirst can be restored by drinking water bottles.

- Thirst Bar Display - Thirst bar can be shown in the action bar or as a boss bar. - Bar style, symbol, colors, and number of segments are configurable. - Option to display thirst value (current/max) in the bar.

- Thirst Effects - When thirst drops below a configurable threshold, players receive configurable potion effects (e.g., slowness). - Hurt animation can be triggered when thirst is low (configurable intensity). - When thirst reaches zero, players receive a configurable dehydration effect (e.g., weakness). - Custom messages are shown when players are dehydrated.

- Language Support - All messages are configurable and support multiple languages (see `lang/` folder).

- Permissions - `H2Oh.bypass.thirst`: Allows players to bypass the thirst system.

- Configuration - All features are configurable via `config.yml`: - Max thirst, decrease rate, bar style, symbols, colors, display mode, effects, messages, drinking refill amount, etc.

Installation

1. Place the plugin JAR in your server's `plugins` folder. 2. Start the server to generate the default configuration files. 3. Edit `config.yml` and language files as needed. 4. Reload or restart your server.

Usage

- Players' thirst will decrease automatically over time. - Drink water bottles to restore thirst. - Thirst bar and effects will update in real time based on configuration. - Use permissions to bypass thirst for specific players/groups.

Configuration Options

See `config.yml` for all available options and documentation.

Compatibility

- PaperMC/Spigot 1.20+ (may work on other versions, but not guaranteed)

Support

For issues or feature requests, a ticket on my discord server.

---

Enjoy a realistic thirst experience for your Minecraft server!