View source for Minecraft:Instrument definition

{{exclusive|java}}
An '''instrument''' consists of a sound with its corresponding range and use duration. They are currently only used for [[Minecraft:goat horn]]s.

== Definition ==

Instruments can be defined in [[Minecraft:data pack]]s, as part of the directory structure below.

{{Data pack directory|instrument|<nowiki><name>.json</nowiki>}}

== JSON Format ==
Instruments are defined using the following format:
<div class="treeview">
* {{nbt|compound}} The root object.<section begin="json format" />
** {{nbt|compound|description}}: A [[Minecraft:text component]] that is used as a description in tooltips.
** {{nbt|string}}{{nbt|compound|sound_event}}: {{json_ref|sound event|inline=1}}
*** {{nbt inherit/sound event}}
** {{nbt|float|use_duration}}: A non-negative float for how long the use duration is.
** {{nbt|float|range}}: A non-negative float for the range of the sound.<section end="json format" />
</div>

== History ==
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||1.21.2|dev=24w33a|Added instruments to [[Minecraft:data pack]]s, used only for [[Minecraft:goat horn]]s.}}
|{{HistoryLine|upcoming java}}
|{{HistoryLine||26.3|dev=snap1|The format of elements in the instrument registry have been updated: added the {{cd|durability_damage}} field, updated the {{cd|use_duration}} field.}}
}}

== Navigation ==
{{Navbox Java Edition technical|datapack}}

[[Minecraft:de:Bockshorninstrumentendefinition]]
[[Minecraft:fr:Définition d'instrument de corne de chèvre]]
[[Minecraft:pt:Definição de instrumento de chifre de cabra]]
[[Minecraft:zh:山羊角乐器定义格式]]