Skip to main 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) - Used if no bound item
  • display-name - Display name with color codes
  • bound-item - Custom item binding (set via /sigmatools bind <tool>)

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

Item Binding​

Tools support custom item binding via the /sigmatools bind <tool> command:

tools:
  pickaxe:
    bound-item:
      type: "vanilla"  # or "itemsadder"
      material: "IRON_PICKAXE"
      # itemsadder-id: "namespace:id"  # Only for ItemsAdder items

Note: Bound items take priority over item-material. If no bound item is set, item-material is used.

See Item Binding Feature for detailed information.

Examples​

See Tools Feature Page for detailed examples.

Next Steps​