Skip to content

Customization

vomiter edited this page Jun 2, 2026 · 1 revision

Customization

Noisy Armors can be customized with datapacks and resource packs.

Adding armor items to the noisy armor list

The mod uses item tags to decide which armor pieces should make noise.

To make an armor item use the default metal armor sound, add it to:

data/noisy_armors/tags/items/noisy_armors_metal.json

Example:

{
  "replace": false,
  "values": [
    "examplemod:copper_helmet",
    "examplemod:copper_chestplate",
    "examplemod:copper_leggings",
    "examplemod:copper_boots"
  ]
}

To make an armor item use the crystal armor sound, add it to:

data/noisy_armors/tags/items/noisy_armors_crystal.json

Example:

{
  "replace": false,
  "values": [
    "examplemod:amethyst_helmet",
    "examplemod:amethyst_chestplate",
    "examplemod:amethyst_leggings",
    "examplemod:amethyst_boots"
  ]
}

Do not use "replace": true unless you intentionally want to remove the default entries from the tag.

Custom sound category

The mod also provides custom armor sound tags. For example, to assign armor to the first custom sound category, add items to:

data/noisy_armors/tags/items/noisy_armors_custom1.json

Example:

{
  "replace": false,
  "values": [
    "examplemod:bone_helmet",
    "examplemod:bone_chestplate",
    "examplemod:bone_leggings",
    "examplemod:bone_boots"
  ]
}

The corresponding sound event is:

noisy_armors:armor_move_custom1

Replacing or adding sound files

Sounds are controlled through a resource pack.

The sound definitions are located at:

assets/noisy_armors/sounds.json

Example custom sound definition:

{
  "armor_move_custom1": {
    "subtitle": "subtitles.noisy_armors.armor_move_custom1",
    "sounds": [
      {
        "name": "noisy_armors:armor_move_custom1/clip_01",
        "stream": false
      },
      {
        "name": "noisy_armors:armor_move_custom1/clip_02",
        "stream": false
      }
    ]
  }
}

The referenced .ogg files should be placed here:

assets/noisy_armors/sounds/armor_move_custom1/clip_01.ogg
assets/noisy_armors/sounds/armor_move_custom1/clip_02.ogg

The "name" field does not include the .ogg extension.

Available built-in sound events

noisy_armors:armor_move
noisy_armors:armor_move_crystal
noisy_armors:armor_move_custom1
...

noisy_armors:armor_move_custom10

The default metal armor sound uses:

noisy_armors:armor_move

The crystal armor sound uses:

noisy_armors:armor_move_crystal

Config options

The common config file can be used to control the basic behavior of the mod.

Available options:

[noisy_armors]
playerArmorMakesSound = true
armorSoundAttractsHostileMobs = true

playerArmorMakesSound controls whether armor worn by players makes noise.

armorSoundAttractsHostileMobs controls whether armor noise made by players can attract hostile mobs.