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

# Sounds

Default sounds.yml for CrownTools and sound key explanations.

## Default sounds.yml

```yaml
sounds:
  tool-broken: minecraft:entity.villager.no:0.5:3.0
  tool-broke: minecraft:block.chain.break:0.5:0.2
  tool-repaired: minecraft:entity.generic.explode:0.5:3.0
  tool-removed: minecraft:entity.generic.explode:0.5:3.0
  drill-block-break: minecraft:block.ancient_debris.fall:0.5:0.1
  excavator-block-break: minecraft:entity.generic.explode:0.5:3.0
  instantaxe-block-break: minecraft:block.growing_plant.crop:0.5:0.1
  infinity-rocket-launch: minecraft:entity.wind_charge.wind_burst:0.5:3.0
  endlessbucket-soak: minecraft:item.bucket.fill:0.5:1.0
  endlessbucket-place: minecraft:item.bucket.empty:0.5:1.0
```

## Sound Key Explanations

### System & State Sounds

* `tool-broken`: Played to the player when attempting to use a broken tool.
* `tool-broke`: Played when a tool exhausts its uses or time limit and enters the broken state.
* `tool-repaired`: Played when a player successfully repairs a broken tool.
* `tool-removed`: Played when a tool breaks and is permanently removed (`remove-on-destruction: true`).

### Action & Tool Sounds

* `drill-block-break`: Sound played at the block location when a Drill breaks blocks in a 3x3 area.
* `excavator-block-break`: Sound played at the block location when an Excavator breaks blocks in a 3x3 area.
* `instantaxe-block-break`: Sound played when an Instant Axe vein-mines connected tree logs.
* `infinity-rocket-launch`: Sound played when launching with an Infinity Rocket.
* `endlessbucket-soak`: Sound played when an Endless Bucket soaks up liquid in a 3x3 radius.
* `endlessbucket-place`: Sound played when an Endless Bucket places liquid in a 3x3 radius.

***

## Sound Format Explanation

> Values follow the format `minecraft_sound_name:volume:pitch`. For example, `minecraft:entity.villager.no:0.5:3.0` plays the villager "no" sound at `0.5` volume and `3.0` pitch.

## Disabling Sounds

> To disable any sound effect, set its YAML key to an empty string (e.g., `tool-broken: ""`).
