Tool Configuration
Each tool (pickaxe, axe, bucket, hoe) has its own section under tools:.
Common Settings (all tools)
| Key | Type | Default | Description |
|---|---|---|---|
enabled | boolean | true | Enable/disable the tool. |
nbt-key | string | "sigmatools:toolname" | NBT identifier for the tool item. |
item-material | string | tool-specific | Base material (e.g. DIAMOND_PICKAXE). Used only if no bound item is set. |
display-name | string | - | Display name, supports color codes. |
bound-item | section | - | Custom item binding set via /sigmatools bind <tool>; takes priority over item-material. |
per-tick-limit | int | - | Blocks processed per server tick. |
per-player-concurrent-ops | int | - | Max concurrent operations per player. |
check-protection | boolean | true | Enable protection plugin checks. |
worlds | List<String> | empty | Worlds the tool works in; empty list = all worlds. |
Tool-Specific Settings
| Tool | Key | Description |
|---|---|---|
| Pickaxe | radius | Mining radius: 1 = 3x3, 2 = 5x5, 3 = 7x7 |
| Pickaxe | max-blocks-per-use | Max blocks broken per use (default 80) |
| Axe | max-logs | Max logs felled per use (default 100) |
| Bucket | allow-water | Allow filling/placing water (default true) |
| Bucket | allow-lava | Allow filling/placing lava (default false) |
| Hoe | replant.consume-seed | Consume a seed on auto-replant (default true) |
| Hoe | replant.auto-replant | Automatically replant harvested crops (default true) |
Cooldown System
| Key | Type | Default | Description |
|---|---|---|---|
cooldown.enabled | boolean | true | Enable the charge-based cooldown system. |
cooldown.max-charges | int | 3 | Number of uses before recharging is needed. |
cooldown.charge-duration | int (seconds) | 2 | Time to regenerate one charge. |
cooldown.message | string | "&cNo charges remaining! &fRecharging..." | Message shown when out of charges. |
Durability System
| Key | Type | Default | Description |
|---|---|---|---|
durability.type | string | "custom" | custom, vanilla, or none. |
durability.max | int | 1500 | Max durability points. |
durability.drain-per-block | int | 1 | Durability lost per block/operation. |
durability.drain-per-use | int | 0 | Durability lost per tool use. |
durability.break-on-empty | boolean | true | Tool breaks when durability reaches zero. |
durability.prevent-repair | boolean | true | Block repairing via anvil/other means. |
Visual Effects
| Key | Type | Default | Description |
|---|---|---|---|
visuals.particles | boolean | true | Show particle effects. |
visuals.sound | boolean | true | Play sound effects. |
visuals.particle-type | string | "EXPLOSION_NORMAL" | Particle effect type. |
visuals.particle-count | int | 5 | Number of particles spawned. |
visuals.particle-spread | double | 0.5 | Particle spread radius. |
visuals.sound-type | string | "BLOCK_STONE_BREAK" | Sound effect type. |
visuals.sound-volume | double | 1.0 | Sound volume. |
visuals.sound-pitch | double | 1.0 | Sound pitch. |
Example
tools:
pickaxe:
enabled: true
item-material: DIAMOND_PICKAXE
display-name: "&bMega Pickaxe"
radius: 1
max-blocks-per-use: 80
worlds: []
cooldown:
enabled: true
max-charges: 3
charge-duration: 2
durability:
type: "custom"
max: 1500
drain-per-block: 1
break-on-empty: true
visuals:
particles: true
sound: true
bound-item:
type: "vanilla" # or "itemsadder"
material: "IRON_PICKAXE"
# itemsadder-id: "namespace:id" # Only for ItemsAdder items