Expanding World Downloader Access with Factions Support for WDLCompanion
If you run a Minecraft server that uses the popular World Downloader mod, you are likely familiar with WDLCompanion—the plugin that gives server owners fine-grained control over what players can download. By default, WDLCompanion works with basic chunk override rules, but what happens when your world is built around factions? The Factions support plugin bridges that gap, letting you tie download permissions directly to MassiveCraft Factions claims and relationships. This article walks through everything you need to know to set it up, tweak permissions, and keep your world data safe while giving faction members the access they need.
What This Plugin Adds to WDLCompanion
The standard WDLCompanion relies on static chunk override definitions—you list coordinates or regions, and players inside those areas get download permission. Factions support introduces two dynamic override types that respond to in-game faction mechanics:
- Owned faction – grants a player permission to download chunks that belong to their own faction.
- Nearby factions – allows downloading in faction claims that are close to the player as they move, similar to how
/f mapreveals nearby territory.
This means you no longer need to manually update chunk lists every time a faction expands or shrinks. The plugin watches faction land changes, membership, and permission settings in real time, adding and removing overrides automatically. It works exclusively with MassiveCraft Factions; the FactionsUUID fork is not supported.
Installation and Setup
Before adding this plugin, make sure your server already has WDLCompanion and MassiveCraft Factions (along with any required dependencies) running correctly. Once those are in place, download the Factions support JAR and drop it into your server's plugins folder. A restart or reload will load the new extension. There is no separate configuration file or permission node—everything is managed through WDLCompanion’s existing config.yml.
For players and server admins who prefer a more visual approach to plugin management, the foxygame.net launcher provides a modern, flexible way to handle mods. From its built-in menu, you can download and install plugins like this one directly into your client or server setup, skipping the manual file juggling entirely.
Configuring Chunk Overrides
Open the WDLCompanion config.yml and locate the chunkOverrides section. Here you will add one or two new entries with the special types. An example configuration looks like this:
chunkOverrides:
ownedFaction:
type: Owned faction
nearbyFactions:
type: Nearby factions
distance: 12
The Owned faction type does not need any extra parameters—a player inherently knows where their faction’s land is, so the plugin can send only those chunks. The Nearby factions type, however, requires a distance value measured in chunks. This distance must be at least 2 larger than the server’s view distance set in server.properties. If you set it too low, the plugin will log a warning with the correct minimum. This constraint exists because the override list refreshes as the player moves; sending the entire faction map would be both bandwidth-heavy and a privacy risk. By limiting the radius, the plugin behaves much like the /f map command, only revealing claims near the player.
How the Two Override Types Work
Owned Faction
When a player belongs to a faction, the server automatically sends chunk override data for all claims belonging to that faction. As soon as the player leaves the faction or the faction loses land, the override is removed. This type is ideal for servers where you trust members to download their own builds but want to prevent them from grabbing neighboring territory.
Nearby Factions
This mode is more dynamic. As a player walks through the world, the plugin continuously updates a list of faction claims within the configured distance. If the player steps into a chunk claimed by a faction for which they have download permission (more on that below), the override activates. Moving away or having the permission revoked instantly removes the ability to download those chunks. The distance parameter keeps the data payload small and prevents exposing the entire faction landscape.
Managing Permissions with /f perm
Neither WDLCompanion nor this plugin introduces its own permission nodes for faction-level control. Instead, download permission is governed by a new faction permission flag called download. By default, faction members and higher ranks can download in their own faction’s land. Faction owners can fine-tune this with the /f perm command:
/f perm set download <group> <on/off> <faction>– grants or revokes download ability for a specific relation group (member, ally, neutral, enemy) in a given faction./f perm show <faction> download– displays the current download permission settings for that faction.
Because players without a faction are technically members of the “wilderness” faction, you may need to adjust wilderness permissions as well. If you want to allow everyone to download in unclaimed areas, enable the download flag for the wilderness faction’s appropriate groups. Conversely, to block downloads in the wild, revoke it. Changes take effect immediately; the plugin listens for permission updates and adjusts chunk overrides on the fly.
Practical Considerations
When using Nearby factions, always double-check that your distance value is large enough. The plugin will notify you if it is too small, but setting it correctly from the start avoids confusion. Remember that this system respects faction relationships—allies can be granted download access without opening the door to enemies. It is also wise to communicate these permissions clearly to your player base so they understand when and where the World Downloader mod will function.
The plugin is open source, and anonymous usage statistics are collected via MCStats. If you prefer to opt out, set opt-out: true in the PluginMetrics configuration file, which disables metrics for all plugins using that system.
Conclusion
Factions support for WDLCompanion turns a static chunk permission system into a living, faction-aware tool. By adding just two override types and leveraging the existing /f perm infrastructure, server admins can give players controlled download access that grows and shrinks with their faction’s territory. Whether you want members to archive their own bases or allow trusted allies to explore nearby claims, this plugin provides the flexibility without compromising map secrecy or server performance. Install it alongside MassiveCraft Factions, configure your overrides, set the permissions, and let the plugin handle the rest.