Installation

1. Download the latest release from the releases page
2. Place BetterRegions.jar in your server's plugins folder
3. Ensure WorldGuard and WorldEdit (or FastAsyncWorldEdit) are installed
4. Install Vault 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

  Video demonstration

• Permission-based Pricing: Control prices with permissions

• Smart Calculations: Only charge for new blocks when expanding regions

  Video demonstration

🛡️ Enhanced Protection

• Fire Spread Protection: Stop fire from spreading across region boundaries

• Explosion Protection: Smart protection against explosions in regions

  Video demonstration

• 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

# 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 in region
    #   • Wither skulls: inherit owner from launching wither
    #   • Creepers: work if triggered by someone who can build
    #   • Works for offline players (owner data stored on entities/blocks with PDC)
    #
    # MEMBER_ONLY - Only region owners/members can cause explosions
    #   • Same as BUILDER_ONLY but checks region membership instead of build permission
    #   • More restrictive than BUILDER_ONLY
    #
    # NO_EXPLOSIONS - No explosions at all in regions
    #   • Blocks all explosion damage (blocks and entities)
    #   • All explosion sources blocked regardless of ownership
    #
    # !!! IMPORTANT !!!
    #    To make TNT explode in regions depending on an owner,
    #    you should set tnt flag on global region: /rg flag __global__ tnt allow
    #    otherwise blocks explosions in regions will not work
    #
    explosion-mode: BUILDER_ONLY

    # Command restrictions in regions for players that can't build there
    restrict-commands:
      commands:
        - "/setwarp"
        - "/essentials:setwarp"
        - "/tpa"
        - "/tpahere"

# Economy integration with separate horizontal and vertical pricing,
# only charges for NEW blocks are not covered by existing regions.
#
# Values heavily depend on your server's economy and balance,
# make sure to adjust them to fit your server's needs if you enable an economy.
#
# Note: replaces WorldGuard's claim, redefine, and define commands.
economy:
  enabled: false

  # Horizontal pricing (base cost per ground-level block)
  # This applies to the footprint area of the region
  horizontal-price-per-block: 0.1

  # Vertical pricing (cost per additional height layer)
  # Much cheaper since it's just extending upward/downward
  vertical-price-per-block: 0.00005

  # Time players have to confirm buying a new region
  confirmation-timeout-seconds: 120

  # Permission-based pricing tiers
  # Players get the BEST pricing from all permissions they have
  # Format: permission-node: { horizontal: price, vertical: price }
  price-permissions:
    # betterregions.pricing.vip
    vip:
      horizontal: 0.09
      vertical: 0.00004

    # betterregions.pricing.premium
    premium:
      horizontal: 0.08
      vertical: 0.00003