Mastering Server Access with CustomWhitelistV2
Running a Minecraft server is about more than just picking the right seed or building epic spawns. It is about crafting a community, and that starts with controlling who walks through your virtual door. The vanilla whitelist does a decent job, but when you need granular control, detailed player statuses, and a way to keep moderators in the loop, you need a tool that speaks the language of server administration. That is where CustomWhitelistV2 steps in, a plugin built from the ground up for PaperMC servers that transforms the humble whitelist into a full-featured access management system.
Why a Custom Whitelist Matters
Every server owner knows the drill: you add a player, they behave, or they do not. Sometimes you need to temporarily remove someone without fully banning them, or you want to track a player’s history beyond a simple on/off switch. The default whitelist cannot handle states like TEMP_KICKED or UNKNOWN, and it certainly does not offer a login password system or a web dashboard. CustomWhitelistV2 fills that gap, giving you a command-based interface that integrates seamlessly with LuckPerms, the go-to permission plugin for modern Minecraft servers.
Core Features That Redefine Access Control
CustomWhitelistV2 is not just a list of names. It is a dynamic status manager that lets you assign one of several states to each player. Here is what you can do right from the chat console or a locally hosted web panel:
- Add or remove players from the whitelist with simple commands.
- Update a player’s status to WHITELISTED, NOT_WHITELISTED, BANNED, KICKED, TEMP_BANNED, TEMP_KICKED, REMOVED, or UNKNOWN.
- Enable or disable specific sub-commands to fine-tune what your moderators can execute.
- Check the current status of any player instantly.
- Set and verify a join password for an extra layer of security.
- Send broadcast messages to all online moderators.
- Manage the plugin through a locally hosted web server running on port 7777, perfect for quick adjustments without logging into the game.
- Switch the plugin language (work in progress) to match your server’s locale.
All these features are wrapped in a clean command structure that feels intuitive once you learn the syntax. The plugin is developed in Java using the Bukkit API, so it runs smoothly on PaperMC and its forks, ensuring compatibility with the ecosystem you already trust.
Command Breakdown for Admins and Moderators
The power of CustomWhitelistV2 lies in its command hierarchy. There are three main command roots, each tailored to a specific role.
/customWhitelistV2 – The Operator’s Toolkit
This is the primary command for day-to-day whitelist management. You can use it to enable or disable sub-commands, list all active sub-commands, add or remove players, list all players in the system, check a player’s status, update that status, change the join password, or simply bring up the help menu. The syntax is straightforward: /customWhitelistV2 addPlayer Notch or /customWhitelistV2 statusOfPlayer Dream. It puts full control at your fingertips without needing to dig into config files.
/login – Player-Side Security
If you have set a join password, players must use /login (password) to authenticate before they can interact with the world. This adds a layer of protection against unauthorized access, especially useful for private servers where you want to double-check identity even after whitelisting.
/msgModerator – Quick Communication
Moderators can send a message to all other online moderators using /msgModerator (message). This keeps the team in sync without cluttering public chat, perfect for discussing a suspicious player or coordinating a temp ban.
/customWhitelistV2Admin – The Root of Power
Reserved for those with the LuckPerms role customwhitelistv2.administrator, this command handles debug operations, adding or removing moderators, listing all moderators, and setting the plugin language. It is the backstage pass that ensures only trusted staff can alter the plugin’s core configuration.
Installation and Setup in a Nutshell
Getting CustomWhitelistV2 onto your server is a breeze. First, download the latest release from the official GitHub repository (search for CustomWhitelistV2 on GitHub to find the .jar file). Place that .jar into your server’s plugins folder, restart the server, and the plugin will generate its default configuration. The final step is to grant yourself the administrator permission via LuckPerms with /lp user (yourname) permissions set customwhitelistv2.administrator. Once that is done, you are ready to shape your whitelist with surgical precision.
If you are also running a modded server and want your players to join effortlessly, consider recommending a launcher that simplifies modpack installation. For instance, players can use the foxygame.net launcher to quickly download and assemble all required client-side mods from a single, modern interface, ensuring they spend less time troubleshooting and more time enjoying your carefully managed world.
The Web Dashboard and Language Flexibility
One standout feature is the locally hosted web server on port 7777. By navigating to your server’s IP on that port, you can manage the whitelist through a browser. This is a game-changer for owners who prefer a graphical overview or need to make changes while away from the game client. The language setting, though still a work in progress, hints at a future where the plugin can adapt to non-English speaking communities, making it a truly global tool.
Community-Driven Development
CustomWhitelistV2 is open-source under the GNU General Public License v3.0, meaning you can inspect the code, suggest improvements, or even fork it for your own needs. Bug reports and feature requests are welcomed on the GitHub issues page. The developer, Shotix, actively maintains the project, so your feedback can directly shape upcoming versions. This collaborative spirit is what keeps the Minecraft server ecosystem vibrant and constantly evolving.
Conclusion: Elevate Your Server’s Entry Protocol
Whitelisting is often treated as an afterthought, but with CustomWhitelistV2 it becomes a strategic asset. The ability to assign nuanced statuses, enforce join passwords, communicate silently among moderators, and manage everything via a web panel gives you unprecedented oversight. Whether you run a tight-knit survival community or a large network with multiple staff tiers, this plugin scales to your needs. It respects the Bukkit API, leans on LuckPerms for permissions, and stays lightweight. If you are serious about who enters your blocky realm, CustomWhitelistV2 is the upgrade your server deserves.