Understanding WDLCompanion: The Smart Way to Manage World Downloader on Your Server
If you run a Minecraft server, you have probably heard of the World Downloader mod. It lets players save a local copy of your carefully crafted world, which can be a blessing for builders wanting backups or a headache for server owners worried about map theft. Simply kicking players who have the mod installed is a blunt instrument that frustrates everyone. WDLCompanion offers a far more elegant solution by tapping directly into the mod's own plugin channel API, giving you granular control without ruining the player experience.
Why Choose WDLCompanion Over Other Plugins?
Many anti-World Downloader plugins take the nuclear option: detect the mod and immediately disconnect the player. This approach is not only hostile but also misses the point. Players might have the mod installed for perfectly innocent reasons, and a sudden kick feels unfair. WDLCompanion, developed by the same person behind the World Downloader mod itself, fully implements the official plugin channel API. This means it communicates with the client smoothly, allowing you to set rules, grant temporary access, and even define specific areas where downloading is always permitted. Because it is the official implementation, you never have to worry about compatibility breaking when the mod updates.
Key Features That Set WDLCompanion Apart
WDLCompanion packs a rich set of capabilities that go far beyond a simple on/off switch. Here is what you can expect:
- Global and per-world configuration: Toggle whether World Downloader can download at all, or fine-tune settings like chunk caching, entity saving, and tile entity saving. You can apply these globally or override them for specific worlds, including different dimensions.
- Permission requests: Instead of outright banning the mod, you can require players to ask for permission. They submit a request from inside the mod, and you can accept, reject, or revoke it with simple commands. Granted permissions expire after a configurable time, so you stay in control.
- Chunk overrides: This is where the plugin truly shines. You can designate areas—either static coordinates or dynamically generated zones—where players are always allowed to download, regardless of other restrictions. For example, on a factions server, you could let players download only within their own faction's territory.
- Custom logging: All significant events, such as player logins and permission requests, are logged both to the main server log and a dedicated subfolder. This helps you monitor activity without cluttering your primary logs, and you can disable it if desired.
- Bukkit permissions integration: Use your existing permissions system to grant specific players or groups the right to use World Downloader, making administration seamless.
Configuration and Setup Made Simple
The plugin is driven by a well-annotated configuration file that is designed to be self-explanatory. If you just want to disable World Downloader entirely, set canDownloadInGeneral to false—that single line does the job. All other settings become irrelevant because they are inferred as false. However, you can keep the door open for permission requests by leaving the request system enabled and even setting a custom message that explains your server's rules to players who ask. After making changes, run /wdl reload to apply them without restarting the server.
For per-world settings, you add a section under the per-world tag with the world folder name, then specify any keys you want to override. If a value is missing, the global default kicks in. This makes it easy to have strict rules on your survival world while being more lenient in a creative plot world.
Advanced Chunk Overrides: Dynamic and Flexible
Chunk overrides are defined in the configuration using two built-in types: ChunkRange (chunk coordinates) and BlockRange (block coordinates, rounded to the nearest chunk). Each override gets a name and an optional tag for logging and packet optimization. You can confine them to a specific world, and you can define as many as you need. A simple example might look like this:
region1:
type: BlockRange
world: world
tag: Freebuild area
x1: 1000
z1: 1000
x2: 1100
z2: 1250
region2:
type: ChunkRange
tag: Spawn chunks
x1: -5
z1: -5
x2: 5
z2: 5
What makes this truly powerful is the API that allows other plugins to generate chunk overrides dynamically. Extension plugins already exist for Factions, WorldGuard, GriefPrevention, Skyblock, and RedProtect. This means you can automatically tie download permissions to land claims, faction membership, or protected regions without writing a single line of code. If a player wants to download outside an allowed area, they can simply submit a permission request, which you can handle in-game.
Commands and Permissions at Your Fingertips
Players have access to /wdl updateme to refresh their client-side permissions if something changes. Server staff get a full suite of commands: /wdl reload to reload config, /wdl update to manually refresh a single player, and /wdl requests list/accept/reject/revoke to manage pending requests. Permissions are documented clearly, so you can delegate these tasks to moderators without giving them full operator status.
A Note on Player Intent
It is important to remember that just because a player has World Downloader installed does not mean they are a griefer or a thief. Many builders use it to back up their own creations, experiment with designs in single-player creative mode, or export 3D models for fan art. The mod sends a permission packet on every join to ensure accurate information before any download starts, so the plugin's detection is not evidence of misuse. If you're a player looking to use World Downloader, you can get it set up quickly using a modern launcher such as foxygame.net, which lets you download mods right from its built-in menu without hassle. Treating every detection as a hostile act will only alienate your community. WDLCompanion gives you the tools to allow legitimate use while blocking abuse, and that balance is what makes it the smart choice for any server.
Conclusion
WDLCompanion transforms the way server owners handle the World Downloader mod. Instead of blunt-force kicks, you get a nuanced system that respects player intent while protecting your world. With its full implementation of the plugin channel API, per-world configuration, dynamic chunk overrides, and seamless permission request workflow, it is the definitive tool for managing downloads. The plugin is open source, actively maintained by the mod's own developer, and supported by a growing list of extensions for popular plugins. If you want to stop worrying about map theft without making your server feel like a police state, WDLCompanion is the answer.