🛡️ Whitelist-Managers

Whitelist-Managers is a lightweight, robust, and zero-dependency administration tool built exclusively for modern Paper and Purpur servers (compiled with Java 25).

It provides server administrators with a simple, secure, and OP-safe mechanism to delegate whitelist management (/whitelist add and /whitelist remove equivalents) to trusted players (Managers) without giving them full operator status or raw vanilla permission nodes.

---

🚀 Key Features

• 🔒 Console-Locked Promotion (/wladmin): Granting or revoking whitelist manager privileges can only be done directly from the server console terminal. Any in-game attempts, even by OPs, are rejected.
• 🛡️ Mutiny & Lockout Protection: Whitelist managers cannot remove themselves or other promoted Whitelist Managers from the whitelist, preventing accidental lockout cycles and unauthorized admin mutinies.
• ⚡ Connection-Kicking on Removal: When an authorized manager removes a player using /wl remove, the target player is immediately kicked from the server using the modern Adventure API.
• 🔄 UUID-Safe Synchronization: Keeps track of managers using Mojang UUIDs. In-game usernames stored in config.yml are dynamically updated if a manager changes their Minecraft username.
• 💡 Intelligent Tab-Completion:
  • /wl remove <tab> dynamically suggests only currently whitelisted players on the server.
  • /wladmin remove <tab> suggests only currently promoted whitelist managers.
• 📊 Anonymous Telemetry: Seamless background metrics collection via bStats (completely relocated to avoid library conflicts).
• 🌱 Ultra-Lightweight & Clean: Standalone plugin with zero database or LuckPerms dependencies. Extremely high-performance impact.

---

🛠️ Commands & Usage

💻 Administrator Commands (Console-Only)

These commands are restricted solely to the server terminal:

• /wladmin add <player> — Appoints a player as a Whitelist Manager, registering their UUID in config.yml.
• /wladmin remove <player> — Revokes a player's Whitelist Manager privileges.
• /wladmin list — Lists all players currently allowed to run /wl commands.
• /wladmin reload — Reloads the configuration file from disk.

🎮 Whitelist Manager Commands (In-game)

Accessible in-game only by players registered in config.yml:

• /wl add <player> — Adds the target player to the vanilla whitelist.
• /wl remove <player> — Removes the target player from the whitelist and kicks them immediately if online.

---

⚙️ Configuration (config.yml)

Located at plugins/Whitelist-Managers/config.yml. Both the player name and Mojang UUID are automatically recorded:

# Whitelist Managers configuration file
# Manage this file via console using /wladmin

allowed-players:
  - name: "Murqin"
    uuid: "f8c3de3d-xxxx-xxxx-xxxx-xxxxxxxxxxxx"

---

📥 Quick Installation Guide

1. Ensure your server is running on Java 25 (standard for Paper 26.1.2+).
2. Download whitelist-managers-1.6.0.jar and drop it into your server's plugins/ folder.
3. Start or restart your server.
4. From the server console terminal, run /wladmin add YourName to promote yourself!