ModsJava
Name-Based Whitelist
Simple name-based whitelist for your servers. Yaml or MySql storage. Free Minecraft Java mod for 1.19.4, 1.20, 1.20.1.
⬇ Download on Modrinth
🧾 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=falsePlace the plugin
.jarfile into thepluginsfolderStart 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 |
Verified by MCModsHub
- Ships as NameBasedWhitelist-3.2.4.jar — drop this file into the mods folder
- Download size: 16 KB
- Download link checked 30 Aug 2026 — working
These come from our own check of the pack file, not from the source page.