Tutorials

Stacking Rigs

Learn how to stack rigs on top of each other to create dynamic models.

# Introduction

"Stacking" is a term used to describe the process of mounting multiple entities on top of eachother.

Using Locators and their Use Entity and On-Summon Commands properties, you can stack multiple rigs on top of each other to add dynamic parts to your model.

# Tutorial

Let's take an existing rig (body) and stack our head rig (head) on top of it.

1. Inside of your body rig, create a new Locator named head_locator. Position this Locator where you want the head to be mounted.

2. Open up head_locator's config and configure the following properties:

   1. Enable Use Entity

   2. Set the Entity Type to minecraft:item_display

   3. Set On-Summon Commands to

              	function animated_java:head/summon {args:{}}
      	ride @n[type=item_frame,tag=aj.head.root] mount @s
      
            

3. Save and Export both rigs.

4. In Minecraft, reload your Data Pack and Resource Pack.

5. Run /execute rotated 0 0 run function animated_java:body/summon {args: {}} to summon your body rig.

6. You should see the head rig mounted on top of the body rig.

From here, you can use your own commands to adjust the head rig's rotation as needed.

        rotate @s ~ ~

      

        rotate @s ~180 ~

      

# Common Issues

# The head rig falls behind the body rig when moving.

1. Open up the exported Data Pack, and locate datapack/animated_java/data/animated_java/tags/function/global/root/on_tick.json.
2. Make sure the head rig's on_tick function is listed after the body rig's on_tick function.
3. You can manually reorder the functions in this file, or rename the head rig to z_head to force it to be listed last.