Skip to content

Tool Configuration

Complete reference for configuring individual tools.

Configuration Structure

Each tool has its own configuration section:

tools:
  pickaxe:
    # Tool settings
  axe:
    # Tool settings
  bucket:
    # Tool settings
  hoe:
    # Tool settings

Common Settings

All tools share these common configuration options:

Basic Settings

  • enabled - Enable/disable the tool (default: true)
  • nbt-key - NBT identifier (default: "sigmatools:toolname")
  • item-material - Base material (e.g., DIAMOND_PICKAXE)
  • display-name - Display name with color codes

Operation Settings

  • per-tick-limit - Blocks processed per server tick
  • per-player-concurrent-ops - Max concurrent operations per player
  • check-protection - Enable protection checks (default: true)

World Restrictions

worlds:
  - world
  - world_nether
  - world_the_end

Empty list = works in all worlds.

Tool-Specific Settings

Pickaxe

tools:
  pickaxe:
    radius: 1  # 1 = 3x3, 2 = 5x5, 3 = 7x7
    max-blocks-per-use: 80

Axe

tools:
  axe:
    max-logs: 100

Bucket

tools:
  bucket:
    allow-water: true
    allow-lava: false

Hoe

tools:
  hoe:
    replant:
      consume-seed: true
      auto-replant: true

Cooldown System

cooldown:
  enabled: true
  max-charges: 3
  charge-duration: 2  # seconds
  message: "&cNo charges remaining! &fRecharging..."

Durability System

durability:
  type: "custom"  # custom, vanilla, none
  max: 1500
  drain-per-block: 1
  drain-per-use: 0
  break-on-empty: true
  prevent-repair: true

Visual Effects

visuals:
  particles: true
  sound: true
  particle-type: "EXPLOSION_NORMAL"
  particle-count: 5
  particle-spread: 0.5
  sound-type: "BLOCK_STONE_BREAK"
  sound-volume: 1.0
  sound-pitch: 1.0

Examples

See Tools Feature Page for detailed examples.

Next Steps