> 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/configuration.md).

# Configuration

Default config.yml file for CrownTools and option explanations.

## Default config.yml

```yaml
license: paste-here

unbreakable-blocks:
  - BEDROCK
  - BUDDING_AMETHYST
  - DRAGON_EGG
  - TRIAL_SPAWNER
  - VAULT
  - REINFORCED_DEEPSLATE
  - END_PORTAL_FRAME
  - SPAWNER

drill:
  material: NETHERITE_PICKAXE
  uses:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false
  time:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false

excavator:
  material: NETHERITE_SHOVEL
  uses:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false
  time:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false

multitool:
  material: NETHERITE_PICKAXE
  material-axe: NETHERITE_AXE
  material-pickaxe: NETHERITE_PICKAXE
  material-shovel: NETHERITE_SHOVEL
  material-hoe: NETHERITE_HOE
  uses:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false
  time:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false

instantaxe:
  material: NETHERITE_AXE
  limit: 20
  uses:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false
  time:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false

infinityrocket:
  material: FIREWORK_ROCKET
  uses:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false
  time:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false

endlessbucket:
  material: WATER_BUCKET
  uses:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false
  time:
    repair-price: 10000000
    repairable: false
    remove-on-destruction: false
```

## What these values mean

### General Settings

* `license`: Your CrownPlugins license key. Can be generated in our Discord server ([dsc.gg/crownplugins](https://dsc.gg/crownplugins)).
* `unbreakable-blocks`: A list of block materials that cannot be broken by custom tools (e.g. Drill, Excavator, Instant Axe). This protects administrative and structure blocks such as Bedrock, Spawners, and End Portal Frames.

***

### Tool Settings (`drill`, `excavator`, `multitool`, `instantaxe`, `infinityrocket`, `endlessbucket`)

Each tool configuration defines its visual item material and behavior for both `uses` and `time` usage modes:

* `material`: The Minecraft material used when generating the tool item stack.
* `limit` *(Instant Axe only)*: The maximum number of connected log blocks that can be broken in a single tree vein-mining action (default: `20`).
* `material-axe`, `material-pickaxe`, `material-shovel`, `material-hoe` *(Multi Tool only)*: The materials the Multi Tool transforms into depending on the target block being mined or interacted with.

***

### Usage & Repair Sub-Configurations (`uses` and `time`)

Each tool supports distinct settings for `uses` (count-based) and `time` (duration-based) modes:

* `repair-price`: The cost in money (via Vault economy) required to repair the tool when it breaks.
* `repairable`: Controls whether players can repair the tool when broken (`true` or `false`).
* `remove-on-destruction`: If set to `true`, the item is permanently removed from the player's inventory when it runs out of uses or time. If set to `false`, the item enters a `[Broken]` state and can be repaired if `repairable` is `true`.