What is
NAT-Whitelist is a powerful and flexible whitelist management plugin for Minecraft servers. It allows server administrators to easily control who can join the server, with support for both MySQL and SQLite databases.
Features
- Add or remove players from the whitelist using commands
- Supports both MySQL and SQLite for storing whitelist data
- Automatically fetches correct usernames from Mojang API
- Option to kick non-whitelisted players automatically
- Option to remove offline players from the whitelist
- Customizable messages using MiniMessage format
- Easy integration with Bukkit/Spigot servers
Commands
| Command | Description |
|---|---|
/whitelist add <name> <another name> |
Adds a player to the whitelist |
/whitelist remove <name><another name> |
Removes a player from the whitelist |
/whitelist list |
Lists all whitelisted players |
/whitelist reload |
Reloads the plugin configuration |
/whitelist enable |
Enables the whitelist |
/whitelist disable |
Disables the whitelist |
/whitelist admin <on/off> |
Restricts the server to admins only (natwhitelist.admin/natwhitelist.bypass), overriding the normal whitelist |
/whitelist removeoffline |
Remove offlines players |
Permissions
| Permission | Description |
|---|---|
natwhitelist.reload |
Allows you to reload the configuration |
natwhitelist.add |
Allows you to add a player to the whitelist |
natwhitelist.remove |
Allows you to remove a player from the whitelist |
natwhitelist.on |
Enables the whitelist |
natwhitelist.off |
Allows you to disable the whitelist |
natwhitelist.removeoffline |
Allows offline players to be removed |
natwhitelist.bypass |
Allows joining even without being whitelisted |
natwhitelist.list |
Allows you to list whitelisted players |
natwhitelist.adminwhitelist |
Allows you to toggle the admin-only whitelist mode (/whitelist admin on|off) |
natwhitelist.admin |
Grants all NAT-Whitelist rights (inherits all of the above permissions), and is also the permission checked to let admins join while admin-only mode is active |
natwhitelist.* |
Same as natwhitelist.admin |
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- 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.
Verified by MCModsHub
- Ships as NAT-Whitelist.jar — drop this file into the mods folder
- Download size: 65 KB
- Download link checked 5 Sept 2026 — working
These come from our own check of the pack file, not from the source page.