sdk.transitions

Automatic entrances for pathing. Interactive blockers are discovered from Tibia's live map stack and approached by the caller; request() performs one brokered use and verifies the resulting teleport/open state.

local M = require("sdk.transitions")

key

function · key(door)

Stable key for a floor-change transition.

should_discover

function · should_discover(reason, away, talk_range, phase)

True when this tile should be probed as a transition.

is_entrance

function · is_entrance(door, item)

True when the tile is a known entrance.

live_entrance

function · live_entrance(door)

Return the exact live stack object that discovery selected. This is the fail-closed boundary before an entrance can be used: catalog heuristics by themselves never authorize an interaction after the map stack changed.

validate_activation

function · validate_activation(candidate, here)

Check that a transition can be used now.

choose

function · choose(candidates, here, dest, anchor, failed)

Pick the best known transition toward a goal.

approach

function · approach(here, door, opts)

Walk toward a transition tile.

discover

function · discover(here, dest, anchor, opts)

Record a newly observed floor change.

check_effect

function · check_effect(door, origin, here, opts)

Confirm a transition from a graphical effect.

activate

function · activate(candidate)

Use the transition (stair, teleport, or tool).

request

function · request(owner, candidate, origin, opts)

Returns a broker ticket. Call result(ticket) for nil/pending, true/effect, or false/error. The caller remains responsible for re-planning after true.

result

function · result(ticket)

Last activation result.