AI Targets - gamehunt/CustomNPCs GitHub Wiki

AIFindPlayerTarget

Sets Player target for the next AI targets

Arguments:

range - range of search

role_whitelist - comma-separated allowed role names Ex.: ClassD,Scientist

role_blacklist - comma-separated disallowed role names Ex.: Tutorial,Spectator

allow_self_select - if true, NPC can target itself

filter - if it equals to scp939, search will ignore silent players. common is for human-like vision. scp096 for SCP-096 target-based search.

target_godmode - if true, NPC can target godmoded players

target_npc - if true, NPC can target other NPC

AIFollowTarget

Follows selected Player target

Arguments:

target_lost_behaviour - has three valid values:

STOP - NPC will stop if target lost

TELEPORT - NPC will teleport to target

SEARCH - NPC will try to find target (Navigates NPC to the latest known target's room, experimental and untested feature)

AINavigateToRoom

Navigates NPC to specified room

Arguments:

room - room id or random for random room

safe - if true, NPC will try to avoid LCZ after round time exceeds 10 minutes

AIAttackTarget

Tells NPC to attack target

Arguments:

accuracy - 0-100 - NPC's accuracy when shooting

hitboxes - hitbox:percent format, specifies how often NPC will hit each hitbox

firerate - firerate multiplier (higher = lower firerate)

damage - damage (0 or less for default weapon's damage)

use_ammo - if true, NPC will reload it's weapon

AIFindItemTarget

Find and pick up item

Arguments:

smart - if true, NPC will search, for example, better keycard than it has.

type - keycard for keycards, weapon for weapons, anything else for any

AIConditionalJump

Skips next targets based on conditions

Arguments:

offset - how many targets should we skip

conditions - space-separated condition string Ex: "!has_weapon !has_keycard"

Available conditions:

has_player_target

has_room_target

has_item_target

has_follow_target

has_nav_queue

has_weapon

has_keycard

If condition has ! prefix, it's result will be inverted. For example: !has_weapon means if no weapon in NPC's inventory