View source for Minecraft:Block sound set definition

{{Exclusive|java}}
{{in development|Java||26.4}}
{{wip|Explain in more detail how sounds are used in the game (especially what volume percentage is used in each case, normally 15%).}}

A '''block sound set''' defines the regular sound of [[Minecraft:block]]s.

== Usage ==

Each block in the game is associated with a unique block sound set. The list of sound types, which blocks are associated with them, and their values can be viewed in [[Minecraft:block sound type]].

Use when they are broken, placed, hit, fallen on or stepped on.

=== Horses ===
[[Minecraft:Donkey]]s, [[Minecraft:lamma]]s, [[Minecraft:trader llama]]s, [[Minecraft:mule]]s, [[Minecraft:horse]]s, [[Minecraft:skeleton horse]]s, and [[Minecraft:zombie horse]]s use a sound block set to define your sound when walking or galloping.

When they are not galloping and walking on blocks whose sound set is within the tag {{tag link|block sound set|sounds_wooden}} emit the sound event {{cd|entity.horse.step_wood}}. When they are walking on blocks with other sound sets emit {{cd|entity.horse.step}} or {{cd|entity.baby_horse.step}} if it is a baby. In both cases, the volume is given by 15% of the volume of the block sound set, and the pitch is the same as the block sound set.

When they are galloping, emit the sound event {{cd|entity.horse.step_wood}} in the first 5 ticks. After that, they have a 10% chance of emitting the sound event {{cd|entity.horse.gallop}}. In both cases, the volume is given by 15% of the volume of the block sound set, and the pitch is the same as the block sound set. 

If it is a horse, each time it emits the sound {{cd|entity.horse.gallop}}, it has a 10% chance of emitting an additional sound {{cd|entity.horse.breathe}} or {{cd|entity.baby_horse.breathe}} (if it is a baby), with volume is given by 60% of the volume of the block sound set, and the same pitch.

== Definition ==
Decorated pot pattern can be defined in [[Minecraft:data pack]]s, as part of the directory structure below.

<div class="treeview">
*{{File|archive|''data pack name''.zip}} or {{File|directory|''data pack name''}}
**{{File|file|[[#pack.mcmeta|pack.mcmeta]]}}
**{{File|directory|data}}
***{{File|directory|''namespace''}}
****{{File|directory|'''block_sound_set'''}}
*****{{File|file|'''{{ph|name}}.json'''}}
****[[Minecraft:Data pack#Folder_structure|More directories&hellip;]]
</div>

== JSON format ==
Block sound set have the following format, all fields are optional:

<div class="treeview">
* {{nbt|compound}} The root object.
** {{nbt|float|volume}}: Between {{cd|0.00001}} and {{cd|10.0}}, defaults {{cd|1.0}}. The relative volume at which all sounds will be played.
** {{nbt|float|pitch}}: Between {{cd|0.00001}} and {{cd|2.0}}, defaults {{cd|1.0}}. The relative pitch at which all sounds will be played.
** {{nbt|string|break_sound}}: {{json ref|sound event}}, the sound that will be played when the block gets broken.
** {{nbt|string|step_sound}}: {{json ref|sound event}}, the sound that will be played when an entity walks on top of the block.
** {{nbt|string|place_sound}}:  {{json ref|sound event}}, the sound that will be played when the block gets placed.
** {{nbt|string|hit_sound}}: {{json ref|sound event}}, the sound that will be played while the block is being destroyed.
** {{nbt|string|fall_sound}}: {{json ref|sound event}}, the sound that will be played when an entity falls onto the block.
</div>


== History ==
{{See also|Block sound type#Java Edition}}
{{HistoryTable
|{{HistoryLine|java}}
|{{HistoryLine||26.4|dev=snap3|Block sound set can now be defined in [[Minecraft:data pack]]s.}}
}}

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