Skip to content

Exclude Include Entities

Tschipcraft edited this page Jan 21, 2025 · 3 revisions

This project supports adding or removing the currently existing animations to any entity in the game.

Since Mojang decided to rename the registries for Minecraft 1.21, there are two locations:

Minecraft 1.17x-1.20.6 Minecraft 1.21+
/data/spawnanimations/tags/entity_types/ /data/spawnanimations/tags/entity_type/

Data Pack version

  1. Unzip the data pack and navigate to the directory.
    Here you will find the files dig_up_animation.json, always_poof_animation.json, can_wear_armor.json, exclude.json and the particles subfolder.

  2. To add the dig up animation to an entity, simply append the entity ID to the dig_up_animation.json file. To use the poof animation instead, append it to both dig_up_animation.json and always_poof_animation.json (Will be changed in the future).
    To give it nether or end particles, also append it to the end_mob.json and/or nether_mob.json files in the particles subfolder.
    If the entity supports wearing armor, add it to the can_wear_armor.json file.
    The exclude.json file is primarily used for technical entities. To exclude an entity, simply remove it from the other files instead of adding it here.
    Make sure that the files are properly formatted according to the JSON specifications.

  3. Re-zip the data pack if needed.

Take a look at the files here on GitHub.

Mod version

  1. Unzip the mod using tools like 7-zip (or forks of it like NanaZip) and navigate to the directory.
    Here you will find the files dig_up_animation.json, always_poof_animation.json, can_wear_armor.json, exclude.json and the particles subfolder.

  2. To add the dig up animation to an entity, simply append the entity ID to the dig_up_animation.json file. To use the poof animation instead, append it to both dig_up_animation.json and always_poof_animation.json (Will be changed in the future).
    To give it nether or end particles, also append it to the end_mob.json and/or nether_mob.json files in the particles subfolder.
    If the entity supports wearing armor, add it to the can_wear_armor.json file.
    The exclude.json file is primarily used for technical entities. To exclude an entity, simply remove it from the other files instead of adding it here.
    Make sure that the files are properly formatted according to the JSON specifications.

  3. Re-zip the mod and change the file extension back to .jar.

Take a look at the files here on GitHub.

Tip

If you want to add a failsafe (e.g. when adding modded or version dependent entities), wrap the entries inside a {"id": "<id>", "required": false} block.

As an alternative to installing third-party tools for unpacking the mod version, you can also build the project from source.

For Developers

To summon a mob that won't be affected by Spawn Animations, you can give it the tag exclude (I should change this to a more unique tag in the next update...).

/summon zombie ~ ~ ~ {Tags:[exclude]} or tag @s add exclude


If you have any questions, need help or want to suggest changes, feel free to open an issue here on GitHub.