Configuration

The plugin is controlled by three main files: config.yml, blocks.yml, and regions.yml.

config.yml (Main Settings)

This file controls the global behavior of the plugin.

• wand: Customize the material and name of the selection wand.

• sounds: Set the default sounds for breaking and regenerating blocks. These can be overridden on a per-block basis in blocks.yml.

• worlds: Choose to enable the plugin in all worlds or specify a list of enabled worlds.

• options: Toggle the action bar countdown and the update checker.

• worldguard: Enable/disable WorldGuard integration.

• particles: Globally enable/disable particles and set the default particle effects for breaking and regenerating blocks.

• messages: Customize every user-facing message, including the prefix and help menu.

blocks.yml (The Core Configuration)

This is the most important file. Here you define which blocks regenerate and how they behave.

Each block you want to regenerate is a top-level key.

DIAMOND_ORE:
  # The block that DIAMOND_ORE will be replaced with temporarily after being broken.
  replace-with: "BEDROCK"
  
  # The time in seconds it takes for the block to regenerate.
  regen-delay: 60
  
  # --- Tool Requirements ---
  tool-requirements:
    enabled: true
    # A list of tools that are allowed to break this block.
    list:
      - "DIAMOND_PICKAXE"
      - "NETHERITE_PICKAXE"
    # A list of required enchantments. Format: "ENCHANTMENT_NAME:LEVEL"
    enchantments:
      - "SILK_TOUCH:1"
      
  # --- Drops Configuration ---
  drops:
    # If true, the default drop (a diamond) will be cancelled.
    clear-default-drops: true
    
    # A list of custom items that can drop.
    custom-drops:
      # This is just a unique key for the drop.
      rare_gem:
        # The probability (out of 100) that this item will drop.
        chance: 25.0
        # The material of the item to drop.
        material: "EMERALD"
        # Custom display name and lore for the dropped item.
        name: "&aRare Gem"
        lore:
          - "&7A very special gem."
        # The amount of the item to drop.
        amount: 1
        # Commands to execute when this item drops.
        # Use {player} for the player's name.
        commands:
          - "eco give {player} 100"
          - "broadcast &e{player} &afound a Rare Gem!"

      # --- ItemsAdder/MMOItems Example ---
      magic_sword:
        chance: 5.0
        # To drop an ItemsAdder item, use 'itemsadder:ITEM_ID'
        material: "itemsadder:magic_sword"
        amount: 1
        
  # --- Overrides for global settings ---
  sounds:
    break-sound: 'BLOCK_GLASS_BREAK:1.0:1.0'
    regen-sound: 'ENTITY_PLAYER_LEVELUP:1.0:1.0'
  particles:
    on-break: true
    on-regen: true
    break-particle: "EXPLOSION_NORMAL:5:0.5"
    regen-particle: "HEART:5:0.5"

regions.yml

This file stores the location data for all the regions you create with the wand. It is not recommended to edit this file manually. Use the in-game commands (/blockregen save, /blockregen remove) to manage your regions.