User Tools

Site Tools


set_entity_script

Set Entity Script


Sets the script of the specified tile or object. An empty string value can be specified for the script name in order to remove the entity's script. The script name is case-sensitive.

Signature:

set_entity_script(entity, script_name, trigger_type, triggerable_by_npc)
ArgumentDescriptionTypeRequired
entityEntity to update the script for.EntityYes
script_nameName of the new script.StringYes
trigger_typeWhen to trigger the script. This argument is only applicable to tiles (possible values are ENTER_TILE, STOP_ON_TILE, and EXIT_TILE, with a default value of ENTER_TILE).Trigger TypeNo
triggerable_by_npcDetermines whether or not NPCs can trigger the script.BooleanNo

Example:

set_entity_script(entity["chest01"], "empty_chest");

Results: The script for entity “chest01” is removed and replaced with the “empty_chest” script.

Use the Set Entity Script function to change the behavior of an object after it has been interacted with or to remove its script so it can no longer be interacted with, for example a door that the player cannot close once opened.


Editor Node:

Visual Demo:

set_entity_script.txt · Last modified: 2022/05/07 14:24 by justin