Purpose:
This plugin provides a
minimalistic HTTP API that allows external tools or websites to add players to the Minecraft
whitelist. Perfect for web forms, Discord bots, or custom tools.
Features
✅ Adds players to the whitelist via HTTP request
✅ Protected by a
token for security
✅ Configurable port via config.yml
✅ Extremely lightweight – no dependencies except Bukkit/Paper
✅ Optional console logging on each API call
⚙️ Installation
- Place WhitelistAPI.jar into your Paper server’s plugins folder (supports version 1.21.5 and newer)
- Start the server once
- The config file plugins/LuWhitelistAPI/config.yml will be generated automatically
Example config:
port: 25566
token: secret123
Change the token to ensure only your website or tool can access the API!
API Usage
The API runs on your server at:
http://<your-ip-or-domain>:<port>/whitelist?name=<playername>&token=<yourtoken>
Example request:
http://j82cz1le3whjjath.myfritz.net:25566/whitelist?name=Lu212&token=secret123
️ Security
- No player permissions required – runs as server console
- Works even if the player is offline
️ Example website link
<a href="
http://j82cz1le3whjjath.myfritz.net:25566/whitelist?name=Lu212&token=secret123" target="_blank">
Add to whitelist now</a>