COWMODSКаталог модов

NAT-Whitelist

A better Whitelist management plugin (Support Discord Webhooks, MySQL)

Автор: Nat0uille5683обновлён 29 июл. 2026 г.
УправлениеХранениеТехнологии

Описание

NAT WHITELIST BANNER

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

CommandDescription
/whitelist add <name> <another name>Adds a player to the whitelist
/whitelist remove <name><another name>Removes a player from the whitelist
/whitelist listLists all whitelisted players
/whitelist reloadReloads the plugin configuration
/whitelist enableEnables the whitelist
/whitelist disableDisables the whitelist
/whitelist admin <on/off>Restricts the server to admins only (natwhitelist.admin/natwhitelist.bypass), overriding the normal whitelist
/whitelist removeofflineRemove offlines players

Permissions

PermissionDescription
natwhitelist.reloadAllows you to reload the configuration
natwhitelist.addAllows you to add a player to the whitelist
natwhitelist.removeAllows you to remove a player from the whitelist
natwhitelist.onEnables the whitelist
natwhitelist.offAllows you to disable the whitelist
natwhitelist.removeofflineAllows offline players to be removed
natwhitelist.bypassAllows joining even without being whitelisted
natwhitelist.listAllows you to list whitelisted players
natwhitelist.adminwhitelistAllows you to toggle the admin-only whitelist mode (/whitelist admin on|off)
natwhitelist.adminGrants 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

Галерея

Discord webhook featureOnline / Offline players in /whitelist list commandHelp command

Последние версии

Все версии →
release

NAT-Whitelist 2.0.2

2.0.2
29 июл. 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.1
16 июн. 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.1
16 июн. 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.0
17 янв. 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.1
27 нояб. 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.0
17 нояб. 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.4
5 окт. 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.3
13 сент. 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.2
2 сент. 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.1
23 авг. 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 ```