> For the complete documentation index, see [llms.txt](https://obey.gitbook.io/wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://obey.gitbook.io/wiki/tools/features/custom-tools.md).

# Custom Tools

Detailed overview of all 6 custom tools available in CrownTools.

CrownTools offers 6 specialized custom tools designed to enhance gameplay and resource gathering on Minecraft servers.

***

## 1. Drill ⛏

* **Default Material**: `NETHERITE_PICKAXE`
* **Primary Function**: 3x3 Mining.
* **Mechanics**:
  * When breaking a block, the Drill calculates the player's target block face and breaks surrounding solid blocks in a 3x3 plane.
  * Drops items naturally at block locations.
  * Displays a line of `SOUL_FIRE_FLAME` particle trails from the player to the origin block.
  * Plays the custom `drill-block-break` sound effect.
* **Secondary Metric**: Total blocks broken (`%secondary%`).

***

## 2. Excavator 🔱

* **Default Material**: `NETHERITE_SHOVEL`
* **Primary Function**: 3x3 Excavation.
* **Mechanics**:
  * Designed for digging dirt, sand, gravel, and solid ground blocks in a 3x3 area based on targeted block orientation.
  * Spawns particle effects and drops item loot for all affected blocks.
  * Plays the custom `excavator-block-break` sound effect.
* **Secondary Metric**: Total blocks broken (`%secondary%`).

***

## 3. Multi Tool ⚑

* **Default Materials**: `NETHERITE_PICKAXE`, `NETHERITE_AXE`, `NETHERITE_SHOVEL`, `NETHERITE_HOE`
* **Primary Function**: Auto-Shapeshifting Tool.
* **Mechanics**:
  * Automatically detects the block material tag the player is hitting or interacting with (`Tag.MINEABLE_AXE`, `Tag.MINEABLE_PICKAXE`, `Tag.MINEABLE_SHOVEL`, `Tag.MINEABLE_HOE`).
  * Instantly transforms the held item into the optimal tool for the job.
  * Maintains its custom tool identity, PDC metadata, and durability across transformations.
* **Secondary Metric**: Total blocks broken (`%secondary%`).

***

## 4. Instant Axe 🪓

* **Default Material**: `NETHERITE_AXE`
* **Primary Function**: Tree Vein-Mining.
* **Mechanics**:
  * Breaking any log block (`Tag.LOGS`) triggers a breadth-first search (BFS) algorithm to detect adjacent connected log blocks.
  * Instantly chops down the entire tree up to the configured limit (`limit: 20` in `config.yml`).
  * Emits `WHITE_SMOKE` particles and plays `instantaxe-block-break`.
* **Secondary Metric**: Total logs broken (`%secondary%`).

***

## 5. Infinity Rocket ☄

* **Default Material**: `FIREWORK_ROCKET`
* **Primary Function**: Infinite Flight Rocket.
* **Mechanics**:
  * Allows players to fly indefinitely with Elytra without consuming fireworks from inventory.
  * **While Gliding**: Boosts player velocity forward by `1.5x`.
  * **On Ground**: Spawns a Power 2 Firework entity for a lift-off boost.
  * Plays `infinity-rocket-launch` sound.
* **Secondary Metric**: Total boost uses (`%secondary%`).

***

## 6. Endless Bucket 🪣

* **Default Material**: `WATER_BUCKET` (also adapts to `LAVA_BUCKET` or `BUCKET`)
* **Primary Function**: 3x3 Liquid Soaking & Placement.
* **Mechanics**:
  * **Soaking Liquid**: Right-clicking water or lava soaks up liquids in a 3x3 area, storing liquid metadata (`%liquid%` and `%amount%`) on the item. Plays `endlessbucket-soak`.
  * **Placing Liquid**: Right-clicking solid surfaces places stored liquid across a 3x3 radius. Plays `endlessbucket-place`.
* **Secondary Metrics**: Total liquid operations (`%secondary%`), stored liquid type (`%liquid%`), and stored liquid amount (`%amount%`).