> 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/chinese/cha-jian-shi-yong-fang-fa/adding-content/advanced-block-properties/enabling-custom-blocks-sounds.md).

# 启用自定义方块声音

{% hint style="warning" %}
每次更改这些设置时，您都必须运行 `/iazip` 以重新生成资源包。
{% endhint %}

要启用自定义方块声音，您必须在 `config.yml` 中启用这些选项。

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

### `enabled`

启用整个模块。

### `step.enabled`

* `true`
  * 此选项将启用每次实体走在自定义方块上时播放自定义 `step` 声音。\
    \
    注意：它还会替换资源包中木材和石头的原版 `step` 声音。\
    (此信息仅对专业用户有用).
* `false`
  * 此选项不会启用当实体走在自定义方块上时播放自定义 `step` 声音。\
    \
    注意：它不会替换资源包中木材和石头的原版 `step` 声音。\
    (此信息仅对专业用户有用).

### `other.enabled`

* `true`
  * 此选项将在各种情况下启用播放自定义声音：`break`, `fall`, `hit`, `place`.\
    \
    注意：它还会替换资源包中木材和石头的原版 `break`, `fall`, `hit`, `place` 声音。\
    (此信息仅对专业用户有用).
* `false`
  * 此选项不会启用在各种情况下播放自定义声音：`break`, `fall`, `hit`, `place`.\
    \
    注意：它不会替换资源包中木材和石头的原版 `break`, `fall`, `hit`, `place` 声音。\
    (此信息仅对专业用户有用).

### `step.allow_non_player`

* `true`
  * 此选项将启用任何非玩家实体播放自定义 `step` 声音。\
    如果您担心由于调用此代码的频率高而导致服务器性能下降，您应该禁用此选项。\
    该功能经过基准测试和性能优化，但某些服务器可能会有问题，或者管理员过于谨慎，因此我编写了此选项。
* `false`
  * 此选项不会启用任何非玩家实体播放自定义 `step` 声音。


---

# 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/chinese/cha-jian-shi-yong-fang-fa/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.