Teleport To Location (Entity Action Type)

Teleports the entity back to a position recorded by apoli:save_location, including its dimension and the rotation it was facing.

Type ID: apoli:teleport_to_location

Fields#

Field	Type	Default	Description
id	String	required	The name the position was saved under.
keep_rotation	Boolean	false	Whether the entity keeps the way it is currently facing instead of the rotation it saved.
clear	Boolean	false	Whether the saved position is forgotten once it has been used, making it a one-shot recall.
success_action	Entity Action Type	optional	Runs on the entity once it has arrived.
fail_action	Entity Action Type	optional	Runs on the entity when nothing is saved under that name, when the saved dimension no longer exists, or when apoli:prevent_teleport refuses the move.

Examples#

{
    "type": "apoli:action_on_key_press",
    "cooldown": 600,
    "entity_action": {
        "type": "apoli:teleport_to_location",
        "id": "example:recall",
        "success_action": {
            "type": "apoli:spawn_particles",
            "particle": "minecraft:portal",
            "count": 32
        },
        "fail_action": {
            "type": "apoli:execute_command",
            "command": "title @s actionbar {\"text\": \"Nowhere to recall to.\", \"color\": \"red\"}"
        }
    }
}

A ten-second-cooldown recall to a saved anchor, with a message when there isn’t one.

Pair with apoli:has_location when the answer should be known before the key is pressed — to grey out a HUD icon, or to make the power’s own condition false while nothing is saved.