AquaWhitelist
A Whitelist for your Velocity Proxy
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
AquaWhitelist
🌊 AquaWhitelist
A lightweight and modern Velocity proxy whitelist plugin built for simplicity and reliability.
---
✨ Features
- ✅ Enable or disable the whitelist with a single command - ✅ Add or remove players dynamically — no restarts required - ✅ Fully customizable kick message in `config.yml` - ✅ Automatically saves and persists whitelist entries across restarts - ✅ Clean MiniMessage-based formatting (supports color & styling) - ✅ Built for Velocity 3.4+ - ⚡ Lightweight & fast — minimal overhead
---
⚙️ Commands
| Command | Description | Permission | |----------|--------------|-------------| | `/aw add <player>` | Adds a player to the whitelist | `aquawhitelist.admin` | | `/aw remove <player>` | Removes a player from the whitelist | `aquawhitelist.admin` | | `/aw enable` | Enables whitelist enforcement | `aquawhitelist.admin` | | `/aw disable` | Disables the whitelist temporarily | `aquawhitelist.admin` |
---
🧩 Configuration (`config.yml`)
```yaml settings: kick-message: "<red>You are not whitelisted on this proxy.</red>" enabled: true
whitelist: - Blue_of_Phoenix_ ```
Explanation: - `kick-message` → MiniMessage-formatted message shown to non-whitelisted players - `enabled` → Toggles whitelist functionality - `whitelist` → List of allowed player usernames
---
🚀 Installation
1. Download the latest version from the Releases tab or Modrinth. 2. Drop the JAR into your `plugins/` folder on your Velocity proxy. 3. Restart or reload the proxy. 4. Adjust your `config.yml` as needed.
---
🧑💻 Developer
GitHub: GitHub: GitHub: %%MD1%%
---
🪶 License
This project is licensed under the MIT License — you are free to modify and redistribute with credit.