?

🌊 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 players
enabled → Toggles whitelist functionality
whitelist → 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.yml as 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.