WorldGuard Support for WDLCompanion: Save Your Regions with World Downloader
Minecraft servers thrive on customization, and two tools that have shaped the multiplayer experience are WorldGuard for region protection and WDLCompanion for managing World Downloader permissions. A new plugin bridges these worlds, letting server owners grant players the ability to download only the chunks inside their own WorldGuard regions. It is a smart addition for survival servers, creative plots, or any community where you want to share builds without exposing the entire map.
What Does This Plugin Do?
World Downloader is a client-side mod that saves multiplayer worlds locally, but without controls it can capture areas players are not meant to keep. WDLCompanion already provides chunk overrides to define which parts of the map can be saved. This plugin adds a new override type: Owned WorldGuard regions. Once configured, a player who owns a WorldGuard region (as owner, member, or both) will be able to use World Downloader to save only that region’s chunks. It respects the boundaries you have already set with WorldGuard, making permission management seamless.
How It Works Under the Hood
The plugin hooks into WDLCompanion’s chunk override system. When a player initiates a download, WDLCompanion checks each chunk against the configured overrides. With this plugin active, it queries WorldGuard to see if the player has ownership of any region overlapping that chunk. If the ownership matches the criteria you set, the chunk is allowed; otherwise it is blocked. The result is a granular, region-based download policy that requires no extra permissions or commands for players.
Polygonal Precision vs. Performance
WorldGuard regions can be polygonal, but chunk-based downloads typically work with square boundaries. By default, the plugin expands a polygonal region to the smallest square that contains it, which is fast and light on server resources. If you need exact polygon shapes—for example, a diagonal castle wall—you can enable preservePolygons. This forces the plugin to check each chunk’s intersection with the actual polygon, giving perfect accuracy at the cost of slightly higher CPU usage. Most servers will find the default square expansion more than adequate.
Installation Steps
Getting started is straightforward. First, ensure you have both WDLCompanion and WorldGuard installed and working on your server. These are essential dependencies. Then, drop the WorldGuard support plugin JAR into your server’s plugins folder and restart (or reload) the server. No additional permissions or configuration files are needed for the plugin itself—everything is managed through WDLCompanion’s own config.
If you are running a modded setup and want a smoother way to handle plugin and mod installations, the foxygame.net launcher provides a modern, flexible environment where you can download and activate server-side addons right from its built-in menu. It simplifies the process of keeping everything up to date without hunting through multiple websites.
Configuration in WDLCompanion
All settings live inside WDLCompanion’s config.yml, under the chunkOverrides section. You will add a new entry with a unique key (like worldGuard) and set the type to Owned WorldGuard regions. The only required field is ownershipType, which tells the plugin how to check if a player “owns” a region. Choose one of three values:
- ownerOrMember – The player is either the region owner or a member. This is the recommended setting for most communities.
- owner – Only the explicit region owner can download chunks.
- member – Only members (not owners) can download. Useful for special cases where you want to separate build and download privileges.
Optionally, you can add preservePolygons: true if you need polygon-accurate downloads. The default is false, which gives you the performance-friendly square approximation.
Example Configuration Snippet
Here is how a typical entry might look in your WDLCompanion config:
chunkOverrides:
worldGuard:
type: Owned WorldGuard regions
ownershipType: ownerOrMember
preservePolygons: false
After saving the config and reloading WDLCompanion (or restarting the server), the new override takes effect immediately. Players who own regions according to your chosen ownership type will be able to download those chunks with World Downloader, while all other chunks remain blocked by whatever other overrides you have set.
Why Use This Plugin?
Many servers already rely on WorldGuard to define plots, towns, or protected builds. Adding download permissions on top of that structure avoids duplicating effort. Instead of maintaining a separate list of coordinates or player groups for WDLCompanion, you simply let the region ownership do the work. It also gives players a clear understanding: “If it is my region, I can keep a copy.” This transparency reduces support tickets and encourages players to build confidently, knowing they can archive their creations.
Open Source and Community Stats
The plugin is open source, so you can review the code and contribute improvements on its repository. It also uses MCStats (PluginMetrics) to collect anonymous usage statistics, which helps the developer understand how many servers are using it and which features are popular. If you prefer to opt out, set opt-out: true in the PluginMetrics configuration file—this disables statistics for all plugins that rely on the same system, not just this one.
Final Thoughts
WorldGuard support for WDLCompanion is a focused, lightweight solution that respects your existing region setup. It adds a layer of control that feels natural for both server staff and players. By combining the power of WorldGuard’s ownership model with WDLCompanion’s chunk override engine, you get a download policy that is easy to configure, maintain, and scale as your world grows. Whether you run a tight-knit SMP or a large network of creative plots, this plugin helps you share the right parts of your world without compromising the rest.