WorldGuard support for WDLCompanion: Save Only Your Regions
Server administrators running Minecraft often face a common challenge: allowing players to save their own builds with World Downloader while preventing the entire map from being copied. The WorldGuard support for WDLCompanion: Save Only Your Regions plugin solves this by linking chunk save permissions directly to WorldGuard region ownership. This article covers installation, configuration, and version compatibility for a stable setup.
Core Functionality
This server-side add-on introduces a new chunk override type called "Owned WorldGuard regions" for WDLCompanion. When a player requests chunks via World Downloader, the plugin checks each chunk against existing WorldGuard regions. If the player owns or is a member of the region, the chunk is delivered; otherwise, the save is blocked. This eliminates the need to manually list coordinates for every protected area.
Installation Requirements
Before you download WorldGuard support for WDLCompanion: Save Only Your Regions, ensure your server runs both WDLCompanion and WorldGuard. The plugin is compatible with Minecraft versions commonly used on modded servers, including 1.16.5 through 1.20.x, and works with the Spigot and Paper server loaders. There is no client-side installation required; the add-on operates entirely on the server.
Step-by-Step Setup
- Stop your Minecraft server.
- Place the downloaded JAR file into the plugins folder.
- Start the server to generate the integration with existing configs.
- Open the WDLCompanion config.yml file.
- Add a new chunk override entry under chunkOverrides.
The how to install process is straightforward. No separate configuration file is created by this add-on; all settings are managed through the main WDLCompanion configuration.
Configuration Parameters
Add the following block to your WDLCompanion config to enable region-based saving:
- type: Set to "Owned WorldGuard regions".
- ownershipType: Choose between ownerOrMember, owner, or member.
- preservePolygons: Set to true for exact polygon boundaries or false for faster square-based checks.
The recommended ownershipType is ownerOrMember, which allows both region owners and listed members to save their chunks. For strict control, use owner to restrict saving to the primary owner only. The member option is rarely used and grants access to members but not the owner.
Polygon Handling
WorldGuard regions are often polygonal. By default, the plugin expands these to a bounding square, which speeds up checks but may include adjacent chunks. Enabling preservePolygons respects the exact shape, providing precise saves at a slight performance cost. For most servers, the default false setting is sufficient.
Practical Usage Scenario
Consider a survival server with hundreds of player claims marked by WorldGuard. Previously, an admin had to update WDLCompanion configs each time a new claim was created. With this add-on, the system automatically evaluates every chunk request against the region database. A player entering their plot can save their structure via World Downloader, while neighboring builds remain protected. This saves hours of manual maintenance and reduces errors.
Compatibility Notes
WorldGuard support for WDLCompanion: Save Only Your Regions for Minecraft works alongside the PluginMetrics system for anonymous usage statistics. If you prefer to disable data collection, set the opt-out flag in the PluginMetrics config; this affects all plugins using that system. The add-on does not require additional permissions nodes and integrates seamlessly with existing WorldGuard flags.
Conclusion
This add-on bridges two powerful tools, providing a transparent and fair system for saving builds. It is a reliable choice for server owners who want to grant players the freedom to back up their work without risking map leaks. The open-source nature of the project allows for code review and custom modifications. For a stable and efficient server environment, download WorldGuard support for WDLCompanion: Save Only Your Regions and streamline your region-based save permissions today.