Skip to content

Custom sounds for resource pack creators

stashymane edited this page Dec 12, 2021 · 3 revisions

Automatically generated sounds

The majority of sounds in this mod are generated automatically based on their classes or properties. All of the sounds' names follow a simple convention - item.click.[namespace].[item id]. Some examples can be found in the included sounds.json that has entries for items that cannot be automatically generated.

This would replace the stick's click sound to a villager dying:
sounds.json

{
  "item.click.minecraft.stick": {
    "sounds": [
      {
        "name": "minecraft:entity.villager.death",
        "type": "event"
      }
    ],
    "replace": true
  }
}

To get a full list of all sounds, including the ones that were generated automatically, you may run Minecraft with the -Dextrasounds.debug=true argument added to your Java options. This will create a debug folder containing a sounds.json. The JSON is compacted, so you might also want to automatically reformat it to be more readable.

Sound categories

For the sake of organization, ExtraSounds adds sound categories for item clicks - that is, items that share the same sound just point to the same category. All of the categories you can find here starting with item.category.*

This would make all records play stal when clicked:
sounds.json

{
  "item.category.music_disc": {
    "sounds": [
      {
        "name": "minecraft:music_disc.stal",
        "type": "event"
      }
    ],
    "replace": true
  }
}

Sound JSON schema

To verify the JSON file (and have autofill if your editor supports it), you may use the provided sound-schema.json with your code editor.