Compatibility
Minecraft: Java Edition
26.1.x
1.21.x
1.20.x
1.19.4
Platforms
Links
Tags
Creators
Details
Licensed ARR
Published 2 years ago
🧾 Name-Based Whitelist
Name-Based Whitelist is a simple and flexible whitelist plugin that allows you to manage access using player nicknames instead of UUIDs.
It supports multiple storage systems and is designed to be lightweight and easy to use.
✨ Features
- 🧾 Simple name-based whitelist system
- 💾 Two storage options: YAML or MySQL
- 🔤 Case-insensitive player name handling
- 🎨 HEX color support in messages
- ⚡ Lightweight and performance-friendly
🚀 Installation
-
Disable the default Minecraft whitelist in
server.propertiesby setting: white-list=false -
Place the plugin
.jarfile into thepluginsfolder -
Start or restart your server
🗄️ MySQL Setup (Optional)
If you want to use MySQL instead of YAML:
- Set
storage-typetomysqlin the config - Enter your database credentials (host, port, database, user, password)
- Restart your server
📜 Commands
| Command | Description |
|---|---|
/nbwl add <username> |
Add a player to the whitelist |
/nbwl remove <username> |
Remove a player from the whitelist |
/nbwl enable |
Enable Name-Based Whitelist |
/nbwl disable |
Disable Name-Based Whitelist |
/nbwl reload |
Reload configuration |
🔐 Permissions
| Permission | Description |
|---|---|
namebasedwhitelist.* |
Access to all commands |
namebasedwhitelist.modify |
Permission to add/remove players |
namebasedwhitelist.manage |
Permission to reload and toggle whitelist |


