Skip to content

useGameboardPatrolAgent

useGameboardPatrolAgent(entity): { active: boolean; currentWaypointIndex: number; loop: boolean; pauseTicks: number; roundsCompleted: number; routeId: string; segmentCosts: number[]; targetWaypointIndex: number; waitTicksRemaining: number; waypointKeys: string[]; } | undefined

Defined in: src/react/react.ts:942

Read patrol agent configuration for one actor entity.

Entity | null | undefined

{ active: boolean; currentWaypointIndex: number; loop: boolean; pauseTicks: number; roundsCompleted: number; routeId: string; segmentCosts: number[]; targetWaypointIndex: number; waitTicksRemaining: number; waypointKeys: string[]; }

active: boolean = true

Whether the patrol agent is active.

currentWaypointIndex: number = 0

Current waypoint index.

loop: boolean = true

Whether the route loops back to the first waypoint.

pauseTicks: number = 0

Ticks to wait after reaching each waypoint.

roundsCompleted: number = 0

Number of completed route rounds.

routeId: string = ''

Route id followed by this patrol.

segmentCosts: number[]

Optional movement budget per route segment.

targetWaypointIndex: number = -1

Target waypoint index for an in-flight segment.

waitTicksRemaining: number = 0

Remaining wait ticks before the next segment.

waypointKeys: string[]

Ordered route waypoint tile keys.


undefined