tileAt: (SceneDomain, WorldPoint) -> Tile?
What stands on one tile: the Tile of the top-level scene.
The other scene reads are queries; this is the other question. nil when the tile is outside the loaded scene, which is ordinary -- a plugin walking a path runs off the edge routinely.
tile- Which tile.
objects: (SceneDomain) -> ObjectQuery
A query over every scene object: walls, decorations, doors, resources. Every loc in the LOADED SCENE, not a window around the player. Narrow it with :within(n) if you only care about what is nearby -- that filters the full answer rather than truncating the question.
The terminals hand out TileObject handles (a GameObject, WallObject, DecorativeObject or GroundObject). The alternative to walking Scene:getTiles() in Luau, which builds a handle per tile: scene:objects():ids(ids):collect() reads the whole scene once, in the host.
hazardField: (SceneDomain, HazardFieldSpec) -> HazardField?
Expand a set of scheduled hazards over the scene: which tiles are lethal on which ticks.
The hazards are DECLARED as data rather than tested by a callback, because the expansion is where the cost is -- a predicate called once per tile per tick is a hundred thousand crossings into the VM inside a native loop, with no deadline that can fire. Declared, it is one call in and one handle out whatever the scene size.
spec- The hazards, the horizon, and which tick is now.
- Returns
nil when there is no scene to expand over.
timedSearch: (SceneDomain, HazardField, TimedSearchOpts?) -> TimedSearch?
Flood against a hazard field, asking it about the tick you ARRIVE at each tile rather than the tick the flood was built.
This is scene:reachability() for anything that moves on a schedule, plus the three things a timed route needs and an untimed one does not: shortcut edges, the grace traversing one grants, and the landed-tile departure check.
field- The field to consult.
opts- Source, run cadence, shortcuts, grace and dwell.
- Returns
nil when there is no scene, or the source is off-plane.
aggressionRemainingTicks: (SceneDomain) -> number?
Ticks left before NPCs in the area lose interest.
- Returns
nil when no aggression timer is running.
npcMayAggro: (SceneDomain, number, WorldPoint) -> boolean
Whether an NPC can still aggro the local player: never once the area is tolerant, and otherwise the level rule (an NPC with a combat level does not aggro a player more than twice its level, except in the Wilderness).
level- The NPC's combat level.
tile- The tile the NPC stands on.