Minecraft:Mob variant definitions: Difference between revisions

Latest revision as of 11:18, 14 October 2026

Mob variants are variants of Minecraft:mobs. They define the assets and models used and define the conditions in which this variant spawns.

Mob sound variants are sound variants distinct from regular variants. They define sounds used by this sound variant.

Definition

Mob variants can be defined in Minecraft:data packs, as part of the directory structure below.

JSON Format

Cat

Minecraft:Cat variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: The Minecraft:resource location of the texture to use.
- Template:Nbt: The Minecraft:resource location of the baby texture to use.
- Template:Nbt: The spawn conditions of this variant, see Template:Slink

Cat sounds

Minecraft:Cat sound variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: Sounds to use for adult cats.
- Template:Nbt: Sounds to use for baby cats.
  - Same fields as Template:Nbt

Chicken

Minecraft:Chicken variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: The Minecraft:resource location of the texture to use.
- Template:Nbt: The Minecraft:resource location of the baby texture to use.
- Template:Nbt: The chicken model to use. Has to be Template:Cd or Template:Cd.
- Template:Nbt: The spawn conditions of this variant, see Template:Slink

Chicken sounds

Minecraft:Chicken sound variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: Sounds to use for adult chickens.
- Template:Nbt: Sounds to use for baby chickens.
  - Same fields as Template:Nbt

Cow

Minecraft:Cow variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: The Minecraft:resource location of the texture to use.
- Template:Nbt: The Minecraft:resource location of the baby texture to use.
- Template:Nbt: The cow model to use. Has to be Template:Cd, Template:Cd or Template:Cd
- Template:Nbt: The spawn conditions of this variant, see Template:Slink

Cow sounds

Minecraft:Cow sound variants are defined using the following format:

Frog

Minecraft:Frog variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: The Minecraft:resource location of the texture to use.
- Template:Nbt: The spawn conditions of this variant, see Template:Slink

Pig

Minecraft:Pig variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: The Minecraft:resource location of the texture to use.
- Template:Nbt: The Minecraft:resource location of the baby texture to use.
- Template:Nbt: The pig model to use, has to be Template:Cd or Template:Cd. Defaults to Template:Cd
- Template:Nbt: The spawn conditions of this variant, see Template:Slink

Pig sounds

Minecraft:Pig sound variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: Sounds to use for adult pigs.
- Template:Nbt: Sounds to use for baby pigs.
  - Same fields as Template:Nbt

Wolf

Minecraft:Wolf variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: The assets to use for this variant:
  - Template:Nbt: The Minecraft:resource location of the texture to use when the wolf is angry.
  - Template:Nbt: The Minecraft:resource location of the texture to use when the wolf is wild.
  - Template:Nbt: The Minecraft:resource location of the texture to use when the wolf is tamed.
- Template:Nbt: The assets to use for the baby of this variant:
  - Template:Nbt: The Minecraft:resource location of the texture to use when the wolf is angry.
  - Template:Nbt: The Minecraft:resource location of the texture to use when the wolf is wild.
  - Template:Nbt: The Minecraft:resource location of the texture to use when the wolf is tamed.
- Template:Nbt: The spawn conditions of this variant, see Template:Slink

Wolf sounds

Minecraft:Wolf sound variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: Sounds to use for adult wolves.
- Template:Nbt: Sounds to use for baby wolves.
  - Same fields as Template:Nbt

Zombie Nautilus

Minecraft:Zombie nautilus variants are defined using the following format:

Template:Nbt The root object.
- Template:Nbt: The Minecraft:resource location of the texture to use.
- Template:Nbt: The nautilus model to use, has to be Template:Cd or Template:Cd. Defaults to Template:Cd
- Template:Nbt: The spawn conditions of this variant, see Template:Slink

Spawn condition

Spawn conditions are used to determine which variant to spawn. Each variant contains a list of conditions with attached priorities. The selection of a variant happens in 3 steps:

Each condition is evaluated. The matching condition with the highest priority determines the priority of the variant. If no condition matches the variant is discarded.
Of all remaining variants, all except those with the highest priority are discarded.
Of the remaining variants, a random variant is chosen.

Spawn conditions are specified using the following format:

Template:Nbt: List of spawn conditions with priority
- Template:Nbt: A single spawn condition
  - Template:Nbt: The priority of the variant if this spawn condition matches
  - Template:Nbt: Condition to match. Always matches if omitted
    - Template:Nbt: The type of the condition, see below for valid options
    - Additional fields based on Template:Nbt, see below

biome

Tests if the spawn position is inside one of the specified Minecraft:biomes.

Template:Nbt
- Template:Nbt: Template:Cd
- Template:Nbt Template:Nbt: Template:Json ref/biome — The biomes to match

structure

Tests if the spawn position is inside at least one of the specified Minecraft:structures.

Template:Nbt
- Template:Nbt: Template:Cd
- Template:Nbt Template:Nbt: Template:Json ref/structure — The structures to match

moon_brightness

Matches the Minecraft:moon brightness at the time of the spawn.

Template:Nbt
- Template:Nbt: Template:Cd
- Template:NbtTemplate:Nbt: The moon brightness values to match — If specified as Template:Nbt: matches a single moon brightness value
  - Template:Nbt: The minimum moon brightness to match
  - Template:Nbt: The maximum moon brightness to match

History

Template:HistoryTable

Navigation

Template:Navbox Java Edition technical

Minecraft:de:Kreaturvariantendefinition Minecraft:fr:Définition de variante de créature Minecraft:ja:エンティティの亜種のカスタマイズ Minecraft:pt:Definição de variantes de criatura

@@ Line 55: / Line 55: @@
 * {{nbt|compound}} The root object.
 ** {{nbt|compound|adult_sounds}}: Sounds to use for adult cats.
-*** {{nbt|string}}{{nbt|compound|ambient_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|ambient_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|beg_for_food_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|beg_for_food_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|death_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|death_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|eat_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|eat_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|hiss_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|hiss_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|hurt_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|hurt_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|purr_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|purr_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|purreow_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|purreow_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|stray_ambient_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|stray_ambient_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
 ** {{nbt|compound|baby_sounds}}: Sounds to use for baby cats.
@@ Line 92: / Line 92: @@
 * {{nbt|compound}} The root object.
 ** {{nbt|compound|adult_sounds}}: Sounds to use for adult chickens.
-*** {{nbt|string}}{{nbt|compound|ambient_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|ambient_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|death_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|death_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|hurt_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|hurt_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|step_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|step_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
 ** {{nbt|compound|baby_sounds}}: Sounds to use for baby chickens.
@@ Line 118: / Line 118: @@
 <div class="treeview">
 * {{nbt|compound}} The root object.
-** {{nbt|string}}{{nbt|compound|ambient_sound}}: {{json_ref|server-side sound event|inline=1}}
+** {{nbt|string}}{{nbt|compound|ambient_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 *** {{nbt inherit/sound event}}
-** {{nbt|string}}{{nbt|compound|death_sound}}: {{json_ref|server-side sound event|inline=1}}
+** {{nbt|string}}{{nbt|compound|death_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 *** {{nbt inherit/sound event}}
-** {{nbt|string}}{{nbt|compound|hurt_sound}}: {{json_ref|server-side sound event|inline=1}}
+** {{nbt|string}}{{nbt|compound|hurt_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 *** {{nbt inherit/sound event}}
-** {{nbt|string}}{{nbt|compound|step_sound}}: {{json_ref|server-side sound event|inline=1}}
+** {{nbt|string}}{{nbt|compound|step_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 *** {{nbt inherit/sound event}}
 </div>
@@ Line 151: / Line 151: @@
 * {{nbt|compound}} The root object.
 ** {{nbt|compound|adult_sounds}}: Sounds to use for adult pigs.
-*** {{nbt|string}}{{nbt|compound|ambient_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|ambient_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|death_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|death_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|eat_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|eat_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|hurt_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|hurt_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|step_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|step_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
 ** {{nbt|compound|baby_sounds}}: Sounds to use for baby pigs.
@@ Line 185: / Line 185: @@
 * {{nbt|compound}} The root object.
 ** {{nbt|compound|adult_sounds}}: Sounds to use for adult wolves.
-*** {{nbt|string}}{{nbt|compound|ambient_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|ambient_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|death_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|death_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|growl_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|growl_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|hurt_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|hurt_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|pant_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|pant_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
-*** {{nbt|string}}{{nbt|compound|whine_sound}}: {{json_ref|server-side sound event|inline=1}}
+*** {{nbt|string}}{{nbt|compound|whine_sound}}: Optional{{upcoming|JE 26.4}}; {{json_ref|server-side sound event|inline=1}}
 **** {{nbt inherit/sound event}}
 ** {{nbt|compound|baby_sounds}}: Sounds to use for baby wolves.
@@ Line 271: / Line 271: @@
 |The textures for baby mobs can now be defined for cow, pig, chicken, wolf, and cat variants.}}
 |{{HistoryLine|||dev=snap7|Added cat, pig, cow and chicken sounds variants; including definitions in data packs.}}
+|{{HistoryLine|java upcoming}}
+|{{HistoryLine||26.4|dev=snap4|Numerous sound variants for chickens, cows, cats, pigs and wolves are now optional.}}
 }}