Skip to main content

Tools

SigmaTools provides four specialized tools.

ToolFunctionDefault MaterialKey Feature
PickaxeArea miningDiamond PickaxeBreaks a configurable radius (default 3x3 = 9 blocks) per swing
AxeTree choppingDiamond AxeBreaks all connected logs in a tree, stops at leaves/non-logs
BucketInfinite liquidsBucketUnlimited water/lava placement without consuming the bucket
HoeAuto-replantingDiamond HoeHarvests crops and automatically replants if seeds are available

All tools apply durability, cooldown, economy, and protection checks on use (where enabled), and run async per the Performance settings.

Per-Tool Settings​

SettingToolsDescription
radiusPickaxeMining radius: 1 = 3x3, 2 = 5x5, 3 = 7x7
max-blocks-per-usePickaxeMax blocks broken per swing
max-logsAxeMax logs broken per tree
allow-water / allow-lavaBucketEnable infinite placement per liquid type
replant.consume-seedHoeConsume a seed from inventory when replanting
replant.auto-replantHoeAutomatically replant after harvest
per-tick-limitPickaxe, AxeBlocks processed per server tick
per-player-concurrent-opsAllMax concurrent operations per player
check-protectionAllWhether protection plugin checks apply
worldsAllWorlds the tool is allowed to function in

Hoe supports wheat, carrots, potatoes, beetroot, and nether wart.

Example Configuration (Pickaxe)​

tools:
  pickaxe:
    enabled: true
    nbt-key: "sigmatools:pickaxe"
    item-material: DIAMOND_PICKAXE
    display-name: "&6SigmaTools Pickaxe"
    radius: 1
    max-blocks-per-use: 80
    per-tick-limit: 20
    per-player-concurrent-ops: 1
    check-protection: true
    worlds: [world, world_nether, world_the_end]
    cooldown:
      enabled: true
      max-charges: 3
      charge-duration: 2  # seconds
    durability:
      type: "custom"
      max: 1500
      drain-per-block: 1
      drain-per-use: 0
      break-on-empty: true
      prevent-repair: true
    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

Other tools (axe, bucket, hoe) follow the same structure under tools.<name> with different defaults - see Configuration for the full key reference and per-tool defaults.

Shared Subsystems​

  • Cooldown (cooldown.enabled, max-charges, charge-duration, message) - charge-based; charges recharge individually over charge-duration seconds.
  • Durability (durability.type, max, drain-per-block, drain-per-use, break-on-empty, prevent-repair) - type can be custom, vanilla, or none.
  • Visuals (visuals.particles, sound, particle-type, particle-count, particle-spread, sound-type, sound-volume, sound-pitch) - see Visual Effects.

Tool Identification​

Tools are identified via NBT (PersistentDataContainer) data, not item name or display name - they can't be duplicated by renaming, and continue working if renamed.

See Also​