?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
AquaWhitelist

AquaWhitelist

A Whitelist for your Velocity Proxy

58downloads
0followers
58downloads
0followers

Compatibility

Minecraft: Java Edition

1.21–1.21.10

Platforms

Links

View source

Tags

Creators

Details

Licensed MIT
Published 10 months ago
Updated 10 months ago

🌊 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

  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

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.