Animated Java logo Animated Java

Locators

Locators are used to represent points in space that can be used as anchors for commands.

Locator example

Entity Creation

A Locator only creates an entity if the Use Entity option is enabled in the Locator Config.

Locator Config

A Locator’s config can be accessed by right-clicking the node, and selecting Locator Config.

  • Use Entity

    If enabled, the locator will create an entity when exported.

  • Entity Type

    The type of entity to create when Use Entity is enabled. This can be any valid Minecraft entity type, such as minecraft:armor_stand or minecraft:marker.

  • Sync Passenger Rotation

    If enabled, the rotation of any entities riding the entity created by this locator will be synced to its rotation.

  • On-Summon Function

    A list of commands to run as and at the entity created by this locator when it is summoned. These commands can use @s to target the entity created by this locator.

    Only available if Use Entity is enabled.

  • On-Remove Function

    A list of commands to run as and at the entity created by this locator when it is removed.

    Only available if Use Entity is enabled.

  • On-Tick Function

    A list of commands to run every tick. If Use Entity is enabled, these commands will be run as and at the entity created by this locator. If Use Entity is disabled, these commands will be run at the location of this locator relative to the Root Entity of the Rig.

Accessing Locators at Runtime

Use the locator utility functions to run commands at a locator’s world position:

Execute at the locator’s position

execute as @e[tag=my_pack.my_rig.root] run function my_pack:my_rig/at_locator {name: "hand", command: "particle minecraft:flame ~ ~ ~"}

Execute as the locator entity (requires Use Entity to be enabled)

execute as @e[tag=my_pack.my_rig.root] run function my_pack:my_rig/as_locator {name: "mount", command: "say Hello!"}

Plugin Mode

Locator configs are not available when Plugin Mode is enabled. All locator settings are hidden in plugin mode.