Whitelist+

Still using versions 1.7.9 or 1.8.x? No problem! You can use the legacy build available here: 👉 Download Legacy Build (v2.0)

This plugin offers a powerful and flexible solution for Minecraft server administrators. With versatile storage options including JSON, MySQL, and SQLite, it ensures reliable player data management. The configuration is clean and organized, with separate files for settings, messages, and whitelists, making maintenance easy. PlaceholderAPI support lets you seamlessly integrate this plugin variables for customization. Compatible with Minecraft versions from 1.7.9 up to 1.21.6 (1.21.7 not tested, but I don't think there are any code-breaking changes).

Preview

GUI Interactions

Images

Commands

GUI

Server Access Denied

Plugin & Message Configuration Files

For the no-permission-* keys in the lang file, you can leave them empty — the plugin will automatically fall back to the general no-permission key.

The supported storage types are: file, mysql, and sqlite.

Commands

All commands are executed using the base command: /whitelist or using the aliases [wlp, wlist] Note: Permissions are required for each subcommand.

---

/whitelist or /whitelist help

Displays the list of available commands along with descriptions. ✅ Permission: whitelistplus.commands

---

/whitelist reload

Reloads the plugin configuration and language files. Also reloads the whitelist storage. ⚠️ Don't use /reload or restart the server to apply changes — it won't work and changes will be lost. Always use /whitelist reload instead. ✅ Permission: whitelistplus.reload

---

/whitelist on

Enables the whitelist system. 📢 Optionally broadcasts a message and kicks non-whitelisted players (based on config settings). ✅ Permission: whitelistplus.on

---

/whitelist off

Disables the whitelist system. 📢 Optionally broadcasts a message. ✅ Permission: whitelistplus.off

---

/whitelist add <player>

Adds a player to the whitelist. ❗ The player must not already be whitelisted. ✅ Permission: whitelistplus.add

---

/whitelist remove <player>

Removes a player from the whitelist. ❗ The player must already be on the whitelist. ✅ Permission: whitelistplus.remove

---

/whitelist list

Displays a list of all whitelisted players. ✅ Permission: whitelistplus.list

---

/whitelist gui

Opens an interactive GUI to manage the whitelist. 👤 Only available to players (not the console). ✅ Permission: whitelistplus.open

Permissions

Permission	Description	Default
whitelistplus.admin	Full admin access to WhitelistPlus.	op
whitelistplus.commands	Allows use of the /whitelist command and its subcommands.	op
whitelistplus.add	Allows adding players to the whitelist.	op
whitelistplus.remove	Allows removing players from the whitelist.	op
whitelistplus.view	Allows viewing the whitelist through the GUI.	op
whitelistplus.lang	Allows changing the language or messages.	op
whitelistplus.toggle	Allows toggling the whitelist ON or OFF through the GUI.	op
whitelistplus.reload	Allows reloading the plugin configuration.	op
whitelistplus.open	Allows opening the main WhitelistPlus GUI.	op
whitelistplus.bypass	Allows joining the server even if the whitelist is enabled.	false
whitelistplus.list	Allows listing all currently whitelisted players.	op
whitelistplus.on	Allows enabling the whitelist.	op
whitelistplus.off	Allows disabling the whitelist.	op

Complements

Name	Description	Minimum plugin version	Minimum API Version	Author	Homepage
NONE	NONE	0	0	NONE	NONE

PlaceholderAPI Variables

• %wlp_status% shows a colored message indicating whether the whitelist is enabled or disabled

• %wlp_is_whitelisted% returns "true" if the player is currently whitelisted (by UUID or name), otherwise "false".

• %wlp_total_whitelisted% displays the total number of players in the whitelist.

• %wlp_is_enabled% indicates whether the whitelist system is currently enabled ("true" or "false").

• %wlp_whitelisted_by% shows the name of the user who added the player to the whitelist.

• %wlp_whitelisted_by_uuid% displays the UUID of the user who added the player to the whitelist.

FAQ

Q: Does the list work for offline player? | A: Absolutely! It should works offline. But if you have any trouble, just let me know 🙂

What else should I put here 🤔?

Support

Email(s):

• [e-mail]

• [e-mail] (I don't check this one much, but you can send it to both... maybe you'll have a better chance of me seeing your message ¯_(ツ)_/¯)

Discord: nexspecter

SpigotMC: TheSantiCraft234