Skip to content

five-on-it / packages/ai/src/system / NpcState

Interface: NpcState ​

Defined in: packages/ai/src/system.ts:166

Everything an NPC remembers between ticks.

Properties ​

aimJitter ​

aimJitter: number

Defined in: packages/ai/src/system.ts:210

The aim jitter of the current burst (rad).


assigned ​

assigned: number

Defined in: packages/ai/src/system.ts:178

A character it was told to go after (the player who spawned it), or −1.


carEpisodes ​

carEpisodes: number

Defined in: packages/ai/src/system.ts:223

Stalls in a row within the episode window, and the tick of the last.


carRecoverDir ​

carRecoverDir: number

Defined in: packages/ai/src/system.ts:221


carRecoverUntil ​

carRecoverUntil: number

Defined in: packages/ai/src/system.ts:220

Reversing out of a stall until this tick, wheels turned this way (±1).


climb ​

climb: ClimbState | undefined

Defined in: packages/ai/src/system.ts:186

Taking a link of its path (a ladder, a lift, a drop, a hop, narrow stairs: steer-climb.ts), if it is.


doing? ​

optional doing?: PoseOrder

Defined in: packages/ai/src/system.ts:251

Told to hold a pose where it stands (poses.ts: a mission's npcDo).


eid ​

eid: number

Defined in: packages/ai/src/system.ts:168

Its character entity.


firePause ​

firePause: number

Defined in: packages/ai/src/system.ts:208

No new burst before this tick.


fireUntil ​

fireUntil: number

Defined in: packages/ai/src/system.ts:206

The trigger is held until this tick.


heard ​

heard: { tick: number; x: number; z: number; } | undefined

Defined in: packages/ai/src/system.ts:182

The last noise it heard.


holdup? ​

optional holdup?: HoldupState

Defined in: packages/ai/src/system.ts:249

Held up (holdup.ts): by whom, since when, when a gun was last on it; or when it last refused.


home ​

home: SpawnPoint

Defined in: packages/ai/src/system.ts:202

Where it came from: where it returns to, where it comes back after dying.


jumpCooldown ​

jumpCooldown: number

Defined in: packages/ai/src/system.ts:200

The tick it may jump again.


lastCar ​

lastCar: number

Defined in: packages/ai/src/system.ts:239

The car it sat in at its last update, or −1: a carjack of that car makes it flee.


lastCarStuck ​

lastCarStuck: number

Defined in: packages/ai/src/system.ts:224


lastSeen ​

lastSeen: { tick: number; vx: number; vz: number; x: number; y?: number; z: number; } | undefined

Defined in: packages/ai/src/system.ts:180

Where its target was last seen (y: the height of its body's centre, when known), and how it moved.


lastStuck ​

lastStuck: number

Defined in: packages/ai/src/system.ts:194

The tick of the last recovery.


leaveCar ​

leaveCar: boolean

Defined in: packages/ai/src/system.ts:233

Getting out of its car as soon as it may.


mode ​

mode: NpcMode

Defined in: packages/ai/src/system.ts:172

What it is doing.


modeSince ​

modeSince: number

Defined in: packages/ai/src/system.ts:174

The tick it started doing it.


nextRepath ​

nextRepath: number

Defined in: packages/ai/src/system.ts:188

The tick it may plan again.


nextReroute ​

nextReroute: number

Defined in: packages/ai/src/system.ts:216

The tick it may plan a route again.


ownCar ​

ownCar: number

Defined in: packages/ai/src/system.ts:204

The car it was spawned in, or −1; removed with it.


path ​

path: NpcPath | undefined

Defined in: packages/ai/src/system.ts:184

The path it follows, if any.


profile ​

profile: BehaviourProfile

Defined in: packages/ai/src/system.ts:170

How it behaves.


ramBackUntil ​

ramBackUntil: number

Defined in: packages/ai/src/system.ts:229

Backing off a car it has just rammed until this tick, to line up the next blow.


recoverDir ​

recoverDir: number

Defined in: packages/ai/src/system.ts:198

Which way the next sidestep goes (±1).


recoverUntil ​

recoverUntil: number

Defined in: packages/ai/src/system.ts:196

Sidestepping until this tick.


remove ​

remove: boolean

Defined in: packages/ai/src/system.ts:235

To be removed at the end of the tick.


role? ​

optional role?: RoleState

Defined in: packages/ai/src/system.ts:243

A role NPC (a driver, a target, a VIP) has its brain's state here (roles.ts).


route ​

route: NpcRoute | undefined

Defined in: packages/ai/src/system.ts:214

The route it drives, if any.


schedule? ​

optional schedule?: ScheduleState

Defined in: packages/ai/src/system.ts:245

An NPC with a schedule has its hours here (schedule.ts).


searchAt ​

searchAt: number

Defined in: packages/ai/src/system.ts:212

The tick it reached the spot it searches, or −1 on the way there.


seat? ​

optional seat?: SeatBotState

Defined in: packages/ai/src/system.ts:247

A seat bot (a run's AI player, seat-bot.ts) has its brain's state here.


sentry? ​

optional sentry?: SentryState

Defined in: packages/ai/src/system.ts:241

A sentry of stealth (a guard, a civilian) has its alert phases and rounds here; a chaser none.


stallTicks ​

stallTicks: number

Defined in: packages/ai/src/system.ts:218

Ticks its car has asked for speed and got none.


stuckEpisodes ​

stuckEpisodes: number

Defined in: packages/ai/src/system.ts:192

Recoveries in a row within the episode window.


stuckTicks ​

stuckTicks: number

Defined in: packages/ai/src/system.ts:190

Ticks it has wanted to move without moving.


target ​

target: number

Defined in: packages/ai/src/system.ts:176

The character it is after, or −1.


threat ​

threat: number

Defined in: packages/ai/src/system.ts:237

The character it flees (who carjacked it), or −1.


turnDir ​

turnDir: number

Defined in: packages/ai/src/system.ts:227


turnUntil ​

turnUntil: number

Defined in: packages/ai/src/system.ts:226

Backing round until this tick, wheels turned this way (±1).


wantsCar ​

wantsCar: number

Defined in: packages/ai/src/system.ts:231

The free car it walks to, to take, or −1.