CodeWhitelist
Protect your server with code authentication!
Автор: febarut2,2 тыс.3обновлён 23 сент. 2025 г.
Управление
Описание
CodeWhitelist - Whitelist Plugin 🚀
CodeWhitelist is a verification code-based entry control system for your Minecraft server. Players joining the server must enter a verification code provided to them to gain access. This system prevents players from moving or performing any actions on the server without verification.
✨ Features
- Verification Code System: A unique verification code is generated every time the server starts and saved in the
config.ymlfile. - IP-Based Registration: Once players verify themselves, their IP addresses are saved, so they don’t need to re-enter the code on future logins.
- Freeze System: Players cannot move, use items, or deal/take damage until they are verified.
- Code Display: The verification code is displayed in the console when the server is fully loaded and ready for players to join.
- Flexible Management:
- IP checks can be enabled or disabled through the
config.ymlfile. - The whitelist of verified players can be easily managed.
- IP checks can be enabled or disabled through the
🛠 Installation
- Download the plugin and place it in your server's
pluginsfolder. - Restart your server.
- After the server has started, find the verification code in the console or in the
plugins/codeWhitelist/config.ymlfile.
🔧 Configuration
The plugin automatically creates a config.yml file when it is first run. The file contents look like this:
server-code: "ABC123" # The verification code
players: [] # Player names and IP addresses
settings:
ip-check: true # IP check (Recommended to keep enabled)
server-code: The verification code generated by the server.players: A list of verified player names and their IP addresses.ip-check: A feature to enable or disable IP-based verification control.
📜 Commands
/kod <code>//code <code>: Allows players to enter the verification code. If the code is correct, they will gain access to the server./kod al//code al: This commands give you your server verification code.
Последние версии
Все версии →release
1.7
1.723 сент. 2025 г.1,2 тыс.Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 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
Что нового
<h1>📢 CodeWhitelist - Changelog</h1> <h2>✨ v1.7 Update</h2> <h3>⚙️ New Features:</h3> <ul> <li>🌍 <strong>Global Ban System:</strong></li> <ul> <li>✅ Malicious players are now banned <strong>across all servers</strong> using CodeWhitelist, not just your own.</li> </ul> <li>🛡 <strong>Active Player Protection:</strong></li> <ul> <li>✅ If someone tries to join using the username of a player who is <strong>already online</strong>, the connection will be automatically <strong>blocked</strong>.</li> </ul> </ul> <h3>🔧 Bug Fixes & Improvements:</h3> <ul> <li>🚀 General performance and security improvements.</li> </ul> <p>💡 <strong>Note:</strong> If you encounter any issues or have suggestions, feel free to share your feedback!</p> <p>🔗 <strong>Download the latest version:</strong> <a href="https://github.com/febarut/codeWhitelist/releases/download/codeWhitelist_v1.7/codewhitelist-1.7.jar">GitHub - CodeWhitelist</a></p> <p>👾 <strong>Thank you for your support!</strong> 🚀</p>
release
1.6
1.69 февр. 2025 г.503Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4paper, purpur, spigot
Что нового
<h1>📢 CodeWhitelist - Changelog</h1>
<h2>✨ v1.6 Update</h2>
<h3>⚙️ New Features:</h3>
<ul>
<li>🔄 <strong>Transition from UUID to Player Name System:</strong></li>
<ul>
<li>✅ Inventory storage now uses <strong>player names</strong> instead of <strong>UUIDs</strong>. This makes it more resistant to issues when server settings like <strong>online-mode</strong> are changed, reducing the chances of item loss.</li>
</ul>
</ul>
<h3>🔧 Bug Fixes:</h3>
<ul>
<li>🛠 <strong>Item Loss Bug Fix:</strong></li>
<ul>
<li>✅ Fixed an issue where players would <strong>lose their inventory</strong> if they logged out before entering the verification code.</li>
<li>✅ Inventories are now stored <strong>only once</strong>, preventing overwriting with an empty inventory.</li>
</ul>
</ul>
<h3>📦 Version Update:</h3>
<ul>
<li>🚀 <strong>Performance and Stability Improvements</strong></li>
</ul>
<p>💡 <strong>Note:</strong> If you encounter any issues or have suggestions, feel free to share your feedback!</p>
<p>🔗 <strong>Download the latest version:</strong> <a href="https://github.com/febarut/codeWhitelist/releases/download/codeWhitelist_v1.6/codewhitelist-1.6.jar">GitHub - CodeWhitelist</a></p>
<p>👾 <strong>Thank you for your support!</strong> 🚀</p>
release
1.5
1.528 нояб. 2024 г.233Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3paper, purpur, spigot
Что нового
<h1>📢 CodeWhitelist - Changelog</h1>
<h2>✨ v1.5 Update</h2>
<hr>
<h3>⚙️ New Features:</h3>
<ul>
<li>
<strong>Configurable IP Address Validation:</strong>
<ul>
<li>🔒 Added <code>PlayerLoginEvent</code> support to validate subdomains used by players during login.</li>
<li>🚫 Players attempting to connect with unverified IP Address will be denied access to the server.</li>
</ul>
</li>
</ul>
<hr>
<h3>📦 Version Update:</h3>
<ul>
<li>🔄 The plugin is now fully compatible with Minecraft versions <strong>1.20 and 1.21</strong>!</li>
</ul>
<hr>
<p>💡 <strong>Note:</strong> Make sure your <code>config.yml</code> file is up to date to use the new hostname validation feature!</p>
<p>🔗 <strong>Download the latest version:</strong> <a href="https://github.com/febarut/codeWhitelist" target="_blank">GitHub - CodeWhitelist</a></p>
<p>👾 Thank you for your feedback and support! Keep your server secure! 🎉</p>
release
1.4
1.427 нояб. 2024 г.60Minecraft: 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3paper, purpur, spigot
Что нового
<h1>📢 CodeWhitelist - Changelog</h1>
<h2>✨ v1.4 Update</h2>
<hr>
<h3>⚙️ New Features:</h3>
<ul>
<li>
<strong>Console Message Update:</strong>
<ul>
<li>✅ Fixed the issue with a message being spammed every 15 minutes in the console.</li>
</ul>
</li>
<li>
<strong>Player Login Logs:</strong>
<ul>
<li>🎮 A message is now displayed in the console to indicate whether a player has successfully logged in.</li>
</ul>
</li>
</ul>
<hr>
<h3>🔧 Bug Fixes:</h3>
<ul>
<li>
<strong>Code Retrieval Bug:</strong>
<ul>
<li>🐛 Fixed an issue where administrators encountered a bug while retrieving codes.</li>
</ul>
</li>
</ul>
<hr>
<h3>📦 Version Update:</h3>
<ul>
<li>🔄 The Minecraft API version has been fully updated to support <strong>1.20</strong>.</li>
</ul>
<hr>
<p>💡 <strong>Note:</strong> Please let us know if you encounter any issues or have feature suggestions!</p>
<p>🔗 <strong>Download the latest version:</strong> <a href="https://github.com/febarut/codeWhitelist" target="_blank">GitHub - CodeWhitelist</a></p>
<p>👾 Thank you for your support and feedback!</p>
release
1.3
1.322 нояб. 2024 г.57Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3paper, purpur, spigot
Что нового
<h1>📢 CodeWhitelist - Changelog</h1>
<h2>✨ v1.3 Update</h2>
<hr>
<h3>⚙️ New Features:</h3>
<ul>
<li>
<strong>Multiple Command Support:</strong>
<ul>
<li><code>/kod</code> and <code>/code</code> commands now serve the same purpose and work together.</li>
<li>You can use these commands to enter the verification code.</li>
</ul>
</li>
<li>
<strong>Language Configuration:</strong>
<ul>
<li>The plugin now supports multiple languages.</li>
<li>Currently available languages: <strong>Turkish</strong> and <strong>English</strong>.</li>
<li>You can change the language in the <code>config.yml</code> file under the <code>language</code> key.</li>
</ul>
</li>
<li>
<strong>Get Verification Code via Command:</strong>
<ul>
<li>Use <code>/kod al</code> or <code>/code al</code> to print the verification code to the console.</li>
<li>This command is restricted to players with <strong>OP permissions</strong> only.</li>
</ul>
</li>
</ul>
<hr>
<h3>🔧 Technical Improvements:</h3>
<ul>
<li>Console and player messages are now aligned with the language configuration.</li>
<li>Error messages for invalid code entries have been made more descriptive.</li>
</ul>
<hr>
<p>💡 <strong>Note:</strong> We welcome your suggestions for adding more language support!</p>
<p>🔗 <strong>Download the latest version:</strong> <a href="https://github.com/febarut/codeWhitelist" target="_blank">GitHub - CodeWhitelist</a></p>
<p>👾 Thank you for your support and suggestions!</p>
release
1.2
1.220 нояб. 2024 г.48Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3paper, purpur, spigot
Что нового
<h1>📢 CodeWhitelist - Changelog</h1>
<h2>✨ v1.2 - Update!</h2>
<h3>🚀 New Features:</h3>
<ul>
<li>
🌍 <strong>Bug Fix:</strong>
<ul>
<li>Fixed an issue where players could access their inventory and drop items without entering a code!</li>
</ul>
</li>
<li>
🔎 <strong>Advanced Version Control:</strong>
<ul>
<li>Enhanced mechanisms to ensure smoother updates and compatibility.</li>
</ul>
</li>
</ul>
<h3>🛠️ Error Management:</h3>
<ul>
<li>
🐛 <strong>Debugging:</strong>
<ul>
<li>Added advanced debug management; errors are now logged clearly in the console, not just in the background.</li>
</ul>
</li>
</ul>
<hr>
<p>💡 <strong>This update includes an analysis system to monitor IP checks and usage statistics!</strong></p>
<p>👾 <em><strong>Thank you for your support and suggestions!</strong></em></p>
release
1.1
1.119 нояб. 2024 г.33Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3paper, purpur, spigot
Что нового
<h1>CodeWhitelist - Changelog</h1>
<h2>v1.1</h2>
<ul>
<li><strong>New Feature:</strong> When a player joins the game, if they haven’t verified their code, a <strong>title message</strong> is displayed on their screen.
<ul>
</ul>
</li>
<li><strong>New Feature:</strong> A clickable link message is added to the player's chat screen.
<ul>
<li><strong>Message:</strong> ">>> Doğrulama Rehberine Git <<<"</li>
<li>This message directs players to a guide link.</li>
</ul>
</li>
<li><strong>Improvement:</strong> The verification code is sent to the console every <strong>15 minutes</strong>.</li>
</ul>
release
CodeWhitelist v1.0
1.019 нояб. 2024 г.63Minecraft: 1.21paper, purpur, spigot