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
If enabled, the locator will have an entity associated with it.
The entity type of the locator's entity.
Requires
Use Entity
to be enabled.The commands that will be executed when the locator is summoned.
Requires
Use Entity
to be enabled.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
The command(s) that will be executed. Supports multiple commands (one per line) similar to a
mcfunction
, and supports MC-Build syntax.If enabled, the command will be executed every
Repeat Frequency
ticks until the next keyframe.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 theRepeat Frequency
.A condition that must be met in order for the command to be executed.
Expects a chain of execute sub-commands without
execute
orrun
.Example
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 at a specific locator's position
Execute as a specific locator's entity
Note that this method will only work if you have the Locator's Use Entity
config option enabled.
Executing commands at all of a Rig Instance's locators that have an entity associated with them.