
NAT-Whitelist
A better Whitelist management plugin (Support Discord Webhooks, MySQL)
Автор: Nat0uille5683обновлён 29 июл. 2026 г.
УправлениеХранениеТехнологии
Описание

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 |
Галерея
Последние версии
Все версии →release
NAT-Whitelist 2.0.2
2.0.229 июл. 2026 г.51Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2bukkit, paper, purpur, spigot
Что нового
# NAT-Whitelist 2.0.2
## What's New
- Add admin-only whitelist mode: `/whitelist admin <on/off>` restricts the server to admins only (`natwhitelist.admin`/`natwhitelist.bypass`), taking priority over the normal whitelist
- Rework config and language file migration to merge new settings/messages into your existing files without losing your customizations
## Support
Need help? Join our Discord: https://nat0uille.com/discord
Thank you for using NAT-Whitelist!
release
NAT-Whitelist 2.0.1-hotfix.1
2.0.1-hotfix.116 июн. 2026 г.39Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2bukkit, paper, purpur, spigot
Что нового
# NAT-Whitelist 2.0.1-hotfix.1
## What's New
- Fix the Migration config to add new lines
## Support
Need help? Join our Discord: https://nat0uille.com/discord
Thank you for using NAT-Whitelist!
release
NAT-Whitelist 2.0.1
2.0.116 июн. 2026 г.17Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2bukkit, paper, purpur, spigot
Что нового
# NAT-Whitelist 2.0.1
## What's New
- Auto-Update: The plugin can now automatically download the latest version from Modrinth when an update is available. Enable it in config.yml with auto-update: true — the update is applied on the next server restart.
- Lighter JAR: Dependencies (HikariCP, H2, MySQL, MariaDB) are now downloaded directly by Paper at startup instead of being bundled in the JAR.
## Improvements
- Security: Fixed potential SQL injection vulnerabilities in whitelist queries
- Code: Merged the internal common and paper modules into a single clean structure
## Configuration
A new option has been added to config.yml:
# Automatically download updates from Modrinth on next restart
auto-update: false
## Support
Need help? Join our Discord: https://nat0uille.com/discord
Thank you for using NAT-Whitelist!
release
NAT-Whitelist 2.0.0
2.0.017 янв. 2026 г.75Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
# NAT-Whitelist 2.0.0 - Complete Rewrite
We're excited to announce the release of **NAT-Whitelist 2.0.0**! This major version represents a complete rewrite of the plugin from the ground up.
## What's New
This version has been entirely redeveloped with a focus on:
- **Clean Architecture**: Complete code restructure for better maintainability and performance
- **Modern Standards**: Built with current best practices and modern Java patterns
- **Enhanced Stability**: Improved error handling and resource management
- **Better Performance**: Optimized database operations and event handling
## Important Notes
- This is a **major version** with breaking changes
- **Backup your data** before upgrading from 1.x versions
- Configuration file has been updated - configs are automatically migrated
- First-time setup requires database configuration (or use default H2)
## Known Issues
As this is a complete rewrite, please report any bugs you encounter on our [GitHub Issues](https://github.com/Nat0uille/NAT-Whitelist/issues) page.
## Support
Need help? Join our Discord: https://nat0uille.com/discord
Thank you for using NAT-Whitelist!
release
NAT-Whitelist 1.5.1
1.5.127 нояб. 2025 г.96Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, paper, spigot
Что нового
## 🎉New release - Version 1.5.1
This update brings several technical improvements, performance optimizations and various fixes to make the plugin more reliable, faster and better documented.
## ⚠️ Attention
If you want to take advantage of the new features, the configuration files have been changed as well as the messages, see more section: 💻Editing
### 🔧What changed
* Added a custom directory for JAR generation in `build.gradle`.
* Reduced task execution time from **20 to 10 ticks**.
* Improved display of whitelisted players with **color code according to their online status**.
* Improved retrieval of language messages with support for **custom messages for missing keys**.
* Console startup messages now include **plugin name and version**.
* Enhanced logging via Discord webhooks.
* Overhaul of **SQL DELETE** queries for greater consistency and better encoding management.
* Modification of certain methods with the deletion of **useless code**.
* Correction of an oversight in activation/deactivation text.
* The **READMEAPI file is now entirely in English**.
### 💻Editing
### In config file (`config.yml`)
```
# Discord webhook URL. If no URL is specified, the plugin will not send messages to Discord.
discord-webhook-url: ""
```
### In the lang file (`/lang` folder)
#### For `en-us.yml`
```
webhook-add-title: "Added to whitelist"
webhook-add-desc: "{player} was added to the whitelist"
webhook-remove-title: "Removed from whitelist"
webhook-remove-desc: "{player} was removed from the whitelist"
webhook-removeoffline-title: "Offline removal from whitelist"
webhook-removeoffline-desc: "{player} was removed from the whitelist (offline)"
webhook-notwhitelisted-title: "Connection refused"
webhook-notwhitelisted-desc: "{player} tried to connect but is not whitelisted."
webhook-on-title: "Whitelist enabled"
webhook-on-desc: "The whitelist has been enabled."
webhook-off-title: "Whitelist disabled"
webhook-off-desc: "The whitelist has been disabled."
```
#### For `fr-fr.yml`
```
webhook-add-title: "Ajout dans la whitelist"
webhook-add-desc: "{player} a été ajouté à la whitelist"
webhook-remove-title: "Suppression de la whitelist"
webhook-remove-desc: "{player} a été retiré de la whitelist"
webhook-removeoffline-title: "Suppression hors-ligne de la whitelist"
webhook-removeoffline-desc: "{player} a été retiré de la whitelist (hors-ligne)"
webhook-notwhitelisted-title: "Connexion refusée"
webhook-notwhitelisted-desc: "{player} a tenté de se connecter sans être whitelist."
webhook-on-title: "Whitelist activée"
webhook-on-desc: "La whitelist a été activée."
webhook-off-title: "Whitelist désactivée"
webhook-off-desc: "La whitelist a été désactivée."
```
release
NAT-Whitelist 1.5.0
1.5.017 нояб. 2025 г.30Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10bukkit, spigot
Что нового
## Version 1.5.0
### What’s new & changed
* Added API section in the README.
* Removed the log message that appeared when the plugin was disabled.
* Updated API documentation and refactored whitelist methods by removing the `playerName` parameter.
* Cleaned up `build.gradle`.
* Refactored whitelist handling: renamed `WhitelistListener` to `Whitelist` and updated all related references.
* Edited message texts.
* Merged update for dependency `io.papermc.paper:paper-api` (via pull request #9).
* Bumped `io.papermc.paper:paper-api` version.
* Merged dependency update for `io.papermc.paper:paper-api` (via pull request #8).
release
1.4
1.45 окт. 2025 г.60Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9bukkit, paper, spigot
Что нового
# NEW CONFIG
please add `lang: en-us` to your config.yml
## What's Changed
* Bump com.google.code.gson:gson from 2.13.1 to 2.13.2 by @dependabot[bot] in https://github.com/Nat0uille/NAT-Whitelist/pull/5
* Bump io.papermc.paper:paper-api from 1.21.8-R0.1-SNAPSHOT to 1.21.9-pre2-R0.1-SNAPSHOT by @dependabot[bot] in https://github.com/Nat0uille/NAT-Whitelist/pull/6
* Bump io.papermc.paper:paper-api from 1.21.9-pre2-R0.1-SNAPSHOT to 1.21.9-pre4-R0.1-SNAPSHOT by @dependabot[bot] in https://github.com/Nat0uille/NAT-Whitelist/pull/7
- Add Start of API addition
- Add a language system with custom languages accepted.
- Bump minecraft version to 1.21.9 max.
- Fix kick with the bypass permission when whitelist on.
Minecraft version | Paper version 1.21.8-60-main@29c8822
-- | --
SHA-256 | 6D4725EFA2BFB03D745CF528FDB45A61BB189D4949D9869F63468BE2250FD6D5
**Full Changelog**: https://github.com/Nat0uille/NAT-Whitelist/compare/1.3.3...1.4
release
NAT-Whitelist 1.3.3
1.3.313 сент. 2025 г.39Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, paper, spigot
Что нового
## Changes
* Fixed config
* Fix error on code with SQL
* Fix error kick if not whitlisted
**Development server version**: `Paper version 1.21.4-187-main@1d5e5a5 `
**SHA-256** : `1472365AC7DC4F2093F4352533BDA718CEC3F29084193E6F98A39737C16D8440`
**Full Changelog**: https://github.com/Nat0uille/NAT-Whitelist/compare/1.3.2...1.3.3
release
NAT-Whitelist 1.3.2
1.3.22 сент. 2025 г.38Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8bukkit, paper, spigot
Что нового
## Changes
- Adding a whitelist bypass permission: `natwhitelist.bypass`
- Changes to checks using UUIDs instead of players
- Added nickname change to whitelist when renaming Minecraft nickname
**Development server version**: `Paper version 1.21.4-187-main@1d5e5a5 `
**SHA-256** : `204BE1B43CAE684ECD03D656EC1BCFD1D8EF0C081D8567FF27680DE469874328`
**Full Changelog**: https://github.com/Nat0uille/NAT-Whitelist/compare/1.3.1...1.3.2
release
NAT-Whitelist 1.3.1
1.3.123 авг. 2025 г.25Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8paper, spigot
Что нового
Fix enabled whitelist
NEW line config.yml
```
# If true, the whitelist is enabled.
enabled: true
```


