Skip to content

Actions

Name Type Description Possibilities
ask interaction Presents a question to the player with a set of possible responses. The result is the index of the chosen response. 2
beRescued behaviour Allows an NPC to be rescued by a player. The NPC will follow the player to a specified rescue position. 3
blockForceInteraction interaction Blocks an NPC from forcing an interaction with a specific character. 1
clear both Stops the NPC from performing any current tasks or animations. 1
combat behaviour Engages the NPC in combat with a specified target. 2
combatClosestPlayer behaviour Engages the NPC in combat with the closest player within a specified distance. 2
command interaction Executes a specified command on the client side. 1
cower both Makes the NPC cower in fear. 1
dice both Rolls a dice with the specified number of faces and returns a random result. 1
distanceCoordsClose both Checks if the NPC is within a specified distance from a given set of coordinates. 2
distanceEntityClose both Checks if the NPC is within a specified distance from a given entity. 2
do both Executes a behaviour tree. 1
driveToCoords behaviour Makes the NPC drive a vehicle to the specified coordinates. 2
driveToEntity behaviour Makes the NPC drive a vehicle towards a specified entity. 2
enterClosestVehicle behaviour Makes the NPC enter the closest vehicle within a specified distance. 3
enterVehicle behaviour Makes the NPC enter a specified vehicle. 2
flee behaviour Makes the NPC flee from a specified pedestrian if they are within a certain distance. 2
fleeCoords behaviour Makes the NPC flee from specified coordinates if they are within a certain distance. 2
forceInteraction behaviour Forces an interaction between the NPC and a nearby player. If blockForceInteraction has been used on a player, the NPC won't interact with that player until unblockForceInteraction is used. 2
getClosestPlayer behaviour Finds the closest player to the NPC within a specified distance and stores the player entity in a global variable. 2
getClosestVehicle behaviour Finds the closest vehicle to the NPC within a specified distance, optionally filtered by model and flag, and stores the vehicle entity in a global variable. 1
getCombatTarget behaviour Retrieves the NPC's current melee combat target and stores the target entity in a global variable. 2
getGlobalState both Retrieves a global state associated with the NPC and stores it in a global variable within the behavior tree." 1
getLocalState interaction Retrieves a local state associated with the NPC and the specific player, then stores it in a local variable within the behavior tree. 1
getNPC both Retrieves an NPC by its ID from the NPC repository and stores it in a global variable. 2
give interaction Gives a specified item and quantity from the NPC to the character. 2
giveUbication interaction Sets a new waypoint on the map at the specified coordinates. 1
globalCheck both Checks if a global state for the NPC is already marked. If not marked, it sets the state and returns 1; if already marked, it returns 2. 2
goToClosestPlayer behaviour Makes the NPC move towards the closest player within a specified distance and speed. 3
goToCoords behaviour Makes the NPC move towards the specified coordinates. 2
goToEntity behaviour Makes the NPC move towards a specified entity within a given distance and speed. 2
goToEntityOffset behaviour Makes the NPC move to a position offset from a specified entity by a given X and Y distance. 2
hasQuestCompleted interaction Checks if the character has completed a quest. 2
hasQuestStarted interaction Checks if the character has started a quest. 2
if both Evaluates a given value as a condition and returns a result based on whether the value is true or false. 2
input interaction Prompts the player to input a text value, which is then stored in a local variable. 2
knows interaction Checks if the NPC recognizes or knows the character. 2
localCheck interaction Checks if a local state for the NPC related to a specific player is already marked. If not marked, it sets the state and returns 1; if already marked, it returns 2. 2
log both Logs a message to the client's debug console. 1
lookCoords behaviour Makes the NPC turn to face a specific set of coordinates. 2
lookEntity behaviour Makes the NPC turn to face a specified entity. 2
me interaction Displays an action message from the NPC in the chat, typically used for roleplaying purposes. 1
nothing both Does nothing. 1
openCraftingTable interaction Opens a specified crafting table interface for the player. 1
openShop interaction Opens a specified shop interface for the player. 1
openStorage interaction Opens a specified storage interface for the player. 1
playAnimation behaviour Plays a specified animation on the NPC. 2
playingAnimation condition Checks if the NPC is currently playing a specified animation. 2
remove interaction Removes a specified item and quantity from the NPC to the character. 2
return both Ends the current action sequence and returns a specified result. 1
serverLog both Logs a message to the server console with the 'Action' tag for debugging purposes. 1
set both Sets multiple global variables within the behavior tree. 1
setCoords behaviour Sets the NPC's position to the specified coordinates. 2
setGlobalState both Sets a global state for the NPC. 1
setLocalState interaction Sets a local state for the NPC related to a specific player. 1
setWalk behaviour Sets the NPC's walking style to the specified animation set. 1
showPicture interaction Displays a picture. 1
spawnVehicle interaction Spawns a vehicle in the specified position. 3
startQuest interaction Initiates a quest for the NPC. This action handles starting, rewarding, or failing the quest depending on the player's progress. 7
surround behaviour Positions the NPC around a specified entity, calculating an offset based on the number of people surrounding and the NPC's position among them. 1
teleport behaviour Teleports the NPC to the specified entity if the entity is not within a certain distance. 2
tell interaction Displays a message to the player from the NPC. 1
unblockForceInteraction interaction Allows an NPC to force an interaction with a specific character again by unblocking it. 1
wait behaviour Pauses the NPC's behaviour for a specified duration. 2
wander behaviour Makes the NPC wander within a specified area, randomly moving around a central point. 1