ModsJava
Name-Based Whitelist
Java mod listed for Minecraft 1.19–26.x. Downloads from the MC Java Mods app on Android.
⬇ 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 |
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.19.4, 1.20, 1.20.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
File checked by MCModsHub
- Ships as NameBasedWhitelist-3.2.4.jar — drop this file into the mods folder
- Download size: 16 KB
- Download link checked 10 Oct 2026 — working
These come from our own check of the pack file, not from the source page.