> For the complete documentation index, see [llms.txt](https://itemsadder.devs.beer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://itemsadder.devs.beer/japanese/plugin-usage/adding-content/advanced-block-properties/enabling-custom-blocks-sounds.md).

# Enabling custom blocks sounds

{% hint style="warning" %}
You have to run `/iazip` each time you change any of these settings to regenerate the resourcepack.
{% endhint %}

To enable custom blocks sounds you have to enable these options in `config.yml`.

```yaml
  custom_blocks_sounds_patch:
    enabled: true
    step:
      enabled: true
      allow_non_player: true
    other: true
```

### `enabled`

This enables the whole module.

### `step.enabled`

* `true`
  * This option will enable playing the custom `step` sound each time an entity walks on a custom block.\
    \
    Note: it will also replace the vanilla `step` sound of wood and stone in your resourcepack.\
    (This information is useful only for expert users).
* `false`
  * This option won't enable playing the custom step sound when an entity walks on a custom block.\
    \
    Note: it won't replace the vanilla wood and stone sounds in your resourcepack.\
    (This information is useful only for expert users).

### `other.enabled`

* `true`
  * This option will enable playing the custom sounds on various occasions: `break`, `fall`, `hit`, `place`.\
    \
    Note: it will also replace the vanilla `break`, `fall`, `hit`, `place` sounds of wood and stone in your resourcepack.\
    (This information is useful only for expert users).
* `false`
  * This option won't enable playing the custom sounds on various occasions: `break`, `fall`, `hit`, `place`.\
    \
    Note: it won't replace the vanilla wood and stone sounds in your resourcepack.\
    (This information is useful only for expert users).

### `step.allow_non_player`

* `true`
  * This option will enable playing the custom `step` sound for any non-player entity.\
    You should disable this if you are afraid of server performance drops due to the high frequency of which this code is called.\
    The feature was benchmarked and coded with performance in mind but some servers might have issues or admins might be paranoid, so I coded this option.
* `false`
  * This option won't enable playing the custom `step` sound for any non-player entity.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://itemsadder.devs.beer/japanese/plugin-usage/adding-content/advanced-block-properties/enabling-custom-blocks-sounds.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.