AquaWhitelist
A Whitelist for your Velocity Proxy
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.