BetterRegions

# Installation 1. Download the latest release from the releases page 2. Place `BetterRegions.jar` in your server's `plugins` folder 3. Ensure (https://modrinth.com/plugin/worldguard) and (https://modrinth.com/plugin/worldedit) (or (https://modrinth.com/plugin/fastasyncworldedit)) are installed 4. Install (https://www.spigotmc.org/resources/vault.34315/) and an economy plugin if you want economy features 5. Restart your server 6. Configure the plugin in `plugins/BetterRegions/config.yml` # Features ## 🏗️ **Region Management** - **Vertical Expansion**: Automatically expand region selections to full world height - **Block Limits**: Configurable region size minimum requirements - **Auto Flags**: Automatically apply configured flags to newly created regions ## 💰 **Economy Integration** - **Pay-per-block**: Charge players for region creation based on block count <details> <summary>Video demonstration</summary> <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/hYdNF0pDrIc" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> </details> - **Permission-based Pricing**: Control prices with permissions - **Smart Calculations**: Only charge for new blocks when expanding regions <details> <summary>Video demonstration</summary> <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/O9f5gHYZw_s" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> </details> ## 🛡️ **Enhanced Protection** - **Fire Spread Protection**: Stop fire from spreading across region boundaries - **Explosion Protection**: Smart protection against explosions in regions <details> <summary>Video demonstration</summary> <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/USYVtHd05s8" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/_j7wchRQnXI" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> </details> - **Command Restrictions**: Block specific commands in regions where players can't build - for example you can block commands like "sethome" or "setwarp" for intruders. # Configuration ```yaml # BetterRegions Configuration # Modern WorldGuard extension with economy and advanced region management features: # Automatic vertical expansion of region selections vertical-expand: enabled: false # Block limits for region creation # # Also remember that WorldGuard has its own limits, this is just an additional layer, # for example, max-claim-volume, max-region-count-per-player (-1 for unlimited) block-limits: # Minimum size for a region to be valid. # Horizontal - both X and Z dimensions, vertical - Y dimension # Prevents tiny regions that can be abused min-horizontal: 20 min-vertical: 20 # Automatic flag setting on region creation auto-flags: show-messages: false # Flags to automatically set on new regions # Format: flag-name: value flags: # greeting: "Welcome to your region!" # farewell: "Thanks for visiting!" # pvp: "deny" # mob-spawning: "deny" # creeper-explosion: "deny" # tnt: "deny" # Enhanced region protection # # TIP: # It is recommended to set "regions.protect-against-liquid-flow" # to true in WorldGuard config.yml to prevent liquid flow into regions, # so it will be impossible to grief regions by flowing water/lava # region-protection: # Prevent fire spread between regions and from wilderness into regions fire-spread: true # Prevent block burning in regions block-burn: true # Changes how explosions work in regions. Here are the modes: # # UNTOUCHED - No explosion protection (default WorldGuard behavior) # • All explosions work normally # # ENTITY_DAMAGE_ONLY - Prevent block damage but allow entity damage # • TNT/creepers/withers damage players/mobs but don't destroy blocks # • Dispensers still spawn TNT but blocks are protected # # BUILDER_ONLY - Only users who can build in the region can cause explosions # • Player-lit TNT: works if lighter can build in region # • Dispenser TNT: works if dispenser placer can build in region # • Projectile-triggered TNT: inherits owner from projectile/shooter # • Explosion-chained TNT: inherits owner from triggering explosion # • Withers: work if spawner can build