🌊 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)
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 playersenabled→ Toggles whitelist functionalitywhitelist→ List of allowed player usernames
🚀 Installation
- Download the latest version from the Releases tab or Modrinth.
- Drop the JAR into your
plugins/folder on your Velocity proxy. - Restart or reload the proxy.
- Adjust your
config.ymlas needed.
🧑💻 Developer
Author: BlackDev / AquaCoding Studios
GitHub: AquaCodingStudios/AquaWhitelist
🪶 License
This project is licensed under the MIT License — you are free to modify and redistribute with credit.
