Minecraft:Instrument definition - Revision history

SyncBot: Sync: updated from Minecraft

2026-09-16T11:22:32Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:22, 16 September 2026
Line 14:		Line 14:
	** {{nbt\|string}}{{nbt\|compound\|sound_event}}: {{json_ref\|server-side sound event\|inline=1}}		** {{nbt\|string}}{{nbt\|compound\|sound_event}}: {{json_ref\|server-side sound event\|inline=1}}
	*** {{nbt inherit/sound event}}		*** {{nbt inherit/sound event}}
	** {{nbt\|float\|use_duration}}: A non-negative float for how long the use cooldown is. ~~Can't be {{cd\|0}}.{{until\|26.3}}~~ Can be {{cd\|0}} for no cooldown.~~{{upcoming\|26.3}}~~		** {{nbt\|float\|use_duration}}: A non-negative float for how long the use cooldown is. Can be {{cd\|0}} for no cooldown.
	** {{nbt\|int\|durability_damage~~}}{{upcoming\|26.3~~}}: An optional non-negative integer for the amount of durability to consume on each use.		** {{nbt\|int\|durability_damage}}: An optional non-negative integer for the amount of durability to consume on each use.
	** {{nbt\|float\|range}}: A non-negative float for the range of the sound.<section end="json format" />		** {{nbt\|float\|range}}: A non-negative float for the range of the sound.<section end="json format" />
	</div>		</div>
Line 70:		Line 70:
	\|{{HistoryLine\|java}}		\|{{HistoryLine\|java}}
	\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|Added instruments to [[Minecraft:data pack]]s, used only for [[Minecraft:goat horn]]s.}}		\|{{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\|Added the {{cd\|durability_damage}} field - optional non-negative integer, amount of durability to consume on each use.		\|{{HistoryLine\|\|26.3\|dev=snap1\|Added the {{cd\|durability_damage}} field - optional non-negative integer, amount of durability to consume on each use.
	\|Updated the {{cd\|use_duration}} field - can now be {{cd\|0}} for no cooldown.}}		\|Updated the {{cd\|use_duration}} field - can now be {{cd\|0}} for no cooldown.}}

SyncBot: Sync: updated from Minecraft

2026-09-07T11:08:37Z

Sync: updated from Minecraft

@@ Line 3: / Line 3: @@
 == Definition ==
 Instruments can be defined in [[Minecraft:data pack]]s, as part of the directory structure below.
@@ Line 19: / Line 18: @@
 ** {{nbt|float|range}}: A non-negative float for the range of the sound.<section end="json format" />
 </div>
 == History ==
@@ Line 28: / Line 74: @@
 |Updated the {{cd|use_duration}} field - can now be {{cd|0}} for no cooldown.}}
 }}
 == Navigation ==

SyncBot: Sync: updated from Minecraft

2026-07-23T11:03:32Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:03, 23 July 2026
Line 15:		Line 15:
	** {{nbt\|string}}{{nbt\|compound\|sound_event}}: {{json_ref\|server-side sound event\|inline=1}}		** {{nbt\|string}}{{nbt\|compound\|sound_event}}: {{json_ref\|server-side sound event\|inline=1}}
	*** {{nbt inherit/sound event}}		*** {{nbt inherit/sound event}}
	** {{nbt\|float\|use_duration}}: A non-negative float for how long the use ~~duration~~ is.		** {{nbt\|float\|use_duration}}: A non-negative float for how long the use cooldown is. Can't be {{cd\|0}}.{{until\|26.3}} Can be {{cd\|0}} for no cooldown.{{upcoming\|26.3}}
			** {{nbt\|int\|durability_damage}}{{upcoming\|26.3}}: An optional non-negative integer for the amount of durability to consume on each use.
	** {{nbt\|float\|range}}: A non-negative float for the range of the sound.<section end="json format" />		** {{nbt\|float\|range}}: A non-negative float for the range of the sound.<section end="json format" />
	</div>		</div>
Line 24:		Line 25:
	\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|Added instruments to [[Minecraft:data pack]]s, used only for [[Minecraft:goat horn]]s.}}		\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|Added instruments to [[Minecraft:data pack]]s, used only for [[Minecraft:goat horn]]s.}}
	\|{{HistoryLine\|upcoming java}}		\|{{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.}}		\|{{HistoryLine\|\|26.3\|dev=snap1\|Added the {{cd\|durability_damage}} field - optional non-negative integer, amount of durability to consume on each use.
			\|Updated the {{cd\|use_duration}} field - can now be {{cd\|0}} for no cooldown.}}
	}}		}}

SyncBot: Sync: updated from Minecraft

2026-07-20T11:47:59Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:47, 20 July 2026
Line 13:		Line 13:
	* {{nbt\|compound}} The root object.<section begin="json format" />		* {{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\|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\|string}}{{nbt\|compound\|sound_event}}: {{json_ref\|server-side sound event\|inline=1}}
	*** {{nbt inherit/sound event}}		*** {{nbt inherit/sound event}}
	** {{nbt\|float\|use_duration}}: A non-negative float for how long the use duration is.		** {{nbt\|float\|use_duration}}: A non-negative float for how long the use duration is.

SyncBot: Sync: updated from Minecraft

2026-07-04T11:06:18Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:06, 4 July 2026
Line 24:		Line 24:
	\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|Added instruments to [[Minecraft:data pack]]s, used only for [[Minecraft:goat horn]]s.}}		\|{{HistoryLine\|\|1.21.2\|dev=24w33a\|Added instruments to [[Minecraft:data pack]]s, used only for [[Minecraft:goat horn]]s.}}
	\|{{HistoryLine\|upcoming java}}		\|{{HistoryLine\|upcoming java}}
	\|{{HistoryLine\|\|26.3\|dev=~~snapshot1~~\|The format of elements in the instrument registry have been updated: added the {{cd\|durability_damage}} field, updated the {{cd\|use_duration}} field.}}		\|{{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.}}
	}}		}}

SyncBot: Sync: new page from Minecraft

2026-06-25T11:14:24Z

Sync: new page from Minecraft

New page

{{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=snapshot1|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:山羊角乐器定义格式]]