Перейти к содержимому
Mineforgian

NAT-Whitelist

Whitelist management plugin independent of the Minecraft base plugin (Support Discord Webhooks, MySQL)

Загрузки
411
Подписчики
3
Обновлён
16 июня 2026 г.
Лицензия
MIT

Опубликован 7 августа 2025 г.

Исходный кодСообщить об ошибке

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
  • Log with Discord webhooks (on, off, add, remove, join but no whitelited)

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 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.admin Grants all NAT-Whitelist rights (inherits all of the above permissions)

Ченджлог

2.0.1-hotfix.1Релиз26.1, 26.1.1, 26.1.2 · 16 июня 2026 г.

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!

2.0.1Релиз26.1, 26.1.1, 26.1.2 · 16 июня 2026 г.

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!

2.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 17 января 2026 г.

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 page.

Support

Need help? Join our Discord: https://nat0uille.com/discord

Thank you for using NAT-Whitelist!

1.5.1Релиз1.21.8, 1.21.9, 1.21.10 · 27 ноября 2025 г.

🎉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."
1.5.0Релиз1.21.8, 1.21.9, 1.21.10 · 17 ноября 2025 г.

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).
1.4Релиз1.21.7, 1.21.8, 1.21.9 · 5 октября 2025 г.

NEW CONFIG

please add lang: en-us to your config.yml

What's Changed

  • 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

1.3.3Релиз1.21.6, 1.21.7, 1.21.8 · 13 сентября 2025 г.

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

1.3.2Релиз1.21.6, 1.21.7, 1.21.8 · 2 сентября 2025 г.

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

Комментарии

Загружаем…