dwell
dwell: boolean?Require every landed tile to also be clear one tick after arrival: the tick you still occupy while the next move resolves. Without it a plan reaches tiles the executor refuses, so nothing is ever committed.
A value shape that methods take or return.
| Field | Type | Description |
|---|---|---|
from | WorldPoint? | Where to flood from. Defaults to the local player's tile. |
run | boolean? | Move two tiles per tick, charging weight only on landed tiles. |
shortcuts | { ShortcutEdge }? | Zero-ground-cost edges: warps, shortcuts, stairs, anything that moves you without walking. |
graceTicks | number? | Ticks of hazard grace traversing a shortcut grants. |
dwell | boolean? | Require every landed tile to also be clear one tick after arrival: the tick you still occupy while the next move resolves. Without it a pla… |
dwellExempt | { WorldPoint }? | The landed tiles the dwell check waives. Omitted, every shortcut's from tile is waived, because the shortcut moves you off it before the… |
gracedForTicks | number? | Ticks the mover is ALREADY graced for. A mover mid-invulnerability plans differently from one about to enter it. |
blockGroups | HazardGroups? | Which hazard groups block on arrival. Omitted means all of them. |
dwellGroups | HazardGroups? | Which hazard groups block at departure, for the dwell check. A hazard that matters on the way through need not matter while standing. |
excluded | { WorldPoint }? | Tiles that block regardless of tick. |
maxTicks | number? | Stop expanding past this many ticks. Omitted means the field's horizon. |
dwelldwell: boolean?Require every landed tile to also be clear one tick after arrival: the tick you still occupy while the next move resolves. Without it a plan reaches tiles the executor refuses, so nothing is ever committed.
dwellExemptdwellExempt: { WorldPoint }?The landed tiles the dwell check waives. Omitted, every shortcut's from tile is waived, because the shortcut moves you off it before the next move resolves. Given, exactly these tiles are waived, shortcut sources or not, and {} waives none: name the one warp source you commit to stepping this tick, and any other you land on is checked like any other tile.
maxTicksmaxTicks: number?Stop expanding past this many ticks. Omitted means the field's horizon.
A value LARGER than the horizon keeps flooding, treating everything past the horizon as clear. That is how you reach a goal further away than you can see: the tail of the route is planned blind and refined next tick. Leave it out and any goal beyond the horizon is simply unreachable.