The Blueprint Format

Locators

Locators are used to execute commands at a specific position / rotation relative to the Rig Instance.

# Creating a Locator

To create a locator, locate the Add Locator button above the outliner.

If this button isn't there, you can press h and then search for Add Locator.

# Config Options

• # Use Entity

  If enabled, the locator will have an entity associated with it.

• # Entity Type

  The entity type of the locator's entity.

  Requires Use Entity to be enabled.

• # Summon Commands

  The commands that will be executed when the locator is summoned.

  Requires Use Entity to be enabled.

• # Ticking Commands

  Custom commands that will be executed every tick.

  If Use Entity is enabled, the commands will be executed as the locator's entity.

# Animating Locators

# Position / Rotation

Locators must be a child of a Bone in order to be positioned / rotated.

# Command Keyframes

When selecting a Locator in Animate Mode, you can add Command Keyframes to it's Timeline to play commands at specific times during an animation.

# Command Keyframe Options

• # Command

  The command(s) that will be executed. Supports multiple commands (one per line) similar to a mcfunction, and supports MC-Build syntax.

• # Repeat?

  If enabled, the command will be executed every Repeat Frequency ticks until the next keyframe.

• # Repeat Frequency

  The amount of ticks between each repeated command execution. A value of 1 will execute the command every tick.

  Repeat Frequency is relative to the animation, and will pause / play with the animation.

  If your animation's length is not evenly divisible by the Repeat Frequency, the time between the last command execution and the end of the animation will be less than the Repeat Frequency.

• # Execute Condition

  A condition that must be met in order for the command to be executed.

  Expects a chain of execute sub-commands without execute or run.

  Example

  A Simple Execute Condition

          if entity @s[tag=my_tag]
  
        

  A More Complex Execute Condition

          aligned xyz positioned ~.5 ~ ~.5 if entity @n[tag=my_tag,distance=..0.1]
  
        

# Excuting Commands as / at Locators Externally.

Sometimes you may want to execute commands at a specific locator's position / rotation from an external function. This can be done by getting the locator's information using the data entity's data.locators.<locator_name> NBT.

        execute as <root> on passengers if entity @s[tag=aj.data] run \
  function foo:position with entity @s data.locators.<locator_name>

      

        $execute positioned $(posx) $(posy) $(posz) rotated $(roty) $(rotx) run ...

      

        execute as <root> on passengers if entity @s[tag=aj.data] run \
  function foo:select with entity @s data.locators.<locator_name>

      

        $execute as $(uuid) run ...

      

        execute as <root> run \
  function animated_java:<export_namespace>/as_own_locator_entities \
  {command:'function foo:as_locator'}

      

        say Hello, World!