Mod Whitelist
Running a Minecraft server comes with a unique set of challenges. You spend hours building the perfect world, setting up plugins, and curating a community, only to have a single player join with a hacked client and ruin the experience for everyone. Cheating mods, x-ray packs, and unfair advantages can quickly erode trust and break the game. That is where Mod Whitelist steps in. This powerful utility acts as a gatekeeper, ensuring that only players with the correct, verified mod configuration can enter your server. It is not just about blocking cheaters; it is about creating a fair, stable, and enjoyable environment for every player who calls your server home.
Understanding the Core Mechanics of Mod Whitelist
Unlike simple server-side anti-cheat plugins, Mod Whitelist operates on a two-part system involving both the client and the server. This dual-sided approach is what makes it so robust. On the client side, the mod gathers the identifiers (known as "mod_ids") of all installed mods. It then encrypts this list and sends it to the server during the connection handshake. On the server side, the mod decrypts this information and cross-references it against your configuration file. This allows the server to make an informed decision: allow the player in, or deny them access based on the mods they have installed.
The Importance of a Dual-Sided Approach
For Mod Whitelist to function correctly, it must be installed on both the client and the server. If it is only installed on the client, the player can still connect, but the server receives no protection. The client will simply send the encrypted data, and the server will ignore it. Conversely, if the mod is only installed on the server, any player without it will be blocked from joining and will see the message "multiplayer.disconnect.mod_whitelist.packet_corruption". This strict requirement ensures that the server administrator has full control over the client environment, which is essential for competitive or tightly-knit communities.
Configuring Your Whitelist and Blacklist
The heart of Mod Whitelist lies in its configuration file, located at <server directory>/config/mod_whitelist-config.json. While the file itself is JSON, you do not need to be a programmer to use it effectively. The process is straightforward and centers on a few key fields. To begin, you need to identify the "modid" of the mods you want to manage. The easiest way to find this is to open the mod's jar file with an archiver tool like 7-Zip or WinZip. Inside, you will find a file named fabric.mod.json. Open it, and look for the value of the key "id". For example, the modid for Mod Whitelist itself is mod_whitelist.
Setting Up Blacklist Mode (Default)
By default, the mod operates in blacklist mode. This means that any mod you add to the CLIENT_MOD_BLACKLIST field will be forbidden. If a player tries to join with one of these mods installed, they will be blocked. This is perfect for banning specific known hacking mods, such as x-ray or fly hacks. To require a mod, you would instead add it to the CLIENT_MOD_NECESSARY field. This is useful for ensuring players have essential mods like a specific performance enhancer or a voice chat client, preventing compatibility issues before they happen.
Switching to Strict Whitelist Mode
For servers that want absolute control, you can switch to whitelist mode by setting USE_WHITELIST_ONLY to true. In this mode, the blacklist is completely ignored. Instead, you must populate the CLIENT_MOD_WHITELIST field with every single mod you want players to have. If a player has a mod not on this list, they will be denied entry. This is the most secure option, as it allows only a pre-approved set of mods. Keep in mind that if you use Fabric API, the modlist can be quite extensive. To help with this, you can run the client with Mod Whitelist installed and check the .minecraft/logs/latest.log file. It will output a formatted line listing all the mod_ids, making it much easier to copy and paste them into your config.
Why Server Administrators Choose Mod Whitelist
The primary benefit is peace of mind. You no longer have to manually police players or rely on unreliable server-side checks. The mod handles the verification process automatically, saving you time and effort. Furthermore, it is highly transparent. Players know exactly what is expected of them, and the mod provides clear feedback if they are blocked. This reduces confusion and support tickets, allowing you to focus on building and managing your community. For those looking for a seamless setup, the foxygame.net launcher offers a one-click install for Mod Whitelist, automatically ensuring version compatibility with your chosen Minecraft build, so you can skip the manual configuration and get straight to protecting your server. This convenience is a huge plus for busy admins who want to deploy the mod quickly.
How to Install and Get Started
Installing Mod Whitelist is a simple process, regardless of your setup. First, you need to ensure you have the correct version for your server. The mod is primarily designed for Fabric, so you will need the Fabric Loader installed on your server. Once you have that, the steps are as follows:
- Download the Mod Whitelist jar file from a trusted source like CurseForge or Modrinth.
- Place the jar file into the
modsfolder on your server. - Restart the server to generate the default configuration file.
- Edit the
mod_whitelist-config.jsonfile to add your desired mods to the whitelist or blacklist. - Restart the server again to apply the changes.
For players, the process is identical. They simply place the Mod Whitelist jar file into their own mods folder. The mod works automatically in the background, gathering their modlist and sending it to the server upon connection. If you are unsure how to install, a quick search for "how to install" will yield many helpful guides, but the process is essentially drag-and-drop. Always ensure you download Mod Whitelist for Minecraft from the official sources to avoid malicious files.
Supported Versions and Loaders
Mod Whitelist is actively developed and supports a range of Minecraft versions, primarily those that are popular with modded communities. You will typically find builds for recent stable releases, ensuring that you can protect your server without having to downgrade. The mod is built for the Fabric mod loader, which is known for its lightweight and fast performance. This makes it an excellent choice for servers that prioritize efficiency and quick load times. Always check the mod page to confirm which specific version you need, as using an incompatible version can cause crashes or prevent the mod from working correctly.
In conclusion, Mod Whitelist is an essential tool for any server administrator who takes the integrity of their gameplay seriously. It offers a simple, effective, and highly configurable solution to the persistent problem of client-side cheating. By leveraging the dual-sided architecture, it provides a level of security that server-side plugins simply cannot match. Whether you run a small server with friends or a large public community, adding Mod Whitelist is a smart step towards a fairer, more enjoyable Minecraft experience for everyone involved.