Entity Definitions

Entity Definitions

Entities are the reusable interactive objects placed on maps — NPCs, enemies on the field, doors, switches, treasure chests, signposts, moving platforms, and any other map element that needs to react, move, or run logic. An entity defines its appearance, its movement behavior, the scripts that run in response to events, and the conditions that decide when each script page is active.

Entities defined here in the database act as templates: a single Entity can be placed on any number of maps, and each placement inherits the template's behavior unless overridden. This is what allows the same shopkeeper, guard, or treasure chest to appear in multiple locations without re-authoring it for each one.


Note: Entities are organized into Script Pages — each page has its own activation conditions, movement settings, and script. The active page is whichever one's conditions currently pass, which is how an entity can change behavior based on switches, variables, party state, or progress through the game without ever needing to be replaced.

Properties

System

Name	Explanation	Type
Category	The category of the entity, for organizational purposes in the editor.	String
ID	The numeric ID of the entity on the map.	Number
Is All Data Persisted	Whether all runtime data (position, state, local data) persists across map transitions.	Toggle
Is Local Data Persisted	Whether local switches and variables persist across map transitions.	Toggle
Locals	The local switches and variables belonging to this entity.	Local and Global Data
Name	The display name of the entity.	String
Position	The X, Y, and Z coordinates of the entity on the map.	Vector
Scripts	The scripts attached to the entity, each with their own conditions, interactions, and commands.	Entity Script
Tags	Key-value pairs for extensible data on the entity.	Tags
Unique ID	The unique identifier.	Unique ID

Entity Script

Entity scripts define the visual appearance, physics, movement behavior, conditions, and interactions of an entity on a map.

Properties

System

Name	Explanation	Type
Collider	The settings for the dimensions of the entity collider. Values are measured in tiles.	Collider
Commands	The commands to execute when the script runs.
Cycle Animation	Whether to animate the entity automatically.	Toggle
Delay (milliseconds)	The delay between movement actions.	Number
Direction	The direction the entity is facing.	Direction
Face On Interaction	Whether the entity will face the player on interaction.	Toggle
Fix Direction	Whether to keep the entity facing its current direction.	Toggle
Ignore Entity Collision	Whether to ignore collision between other entities.	Toggle
Ignores Gravity	Whether the entity ignores the effects of gravity.	Toggle
Ignores Obstacles	Whether the entity ignores terrain obstacles.	Toggle
Interaction Suspends Movement	Whether to suspend the movement pattern when interaction occurs.	Toggle
Is Clipping	Whether the entity operates independently of physics.	Toggle
Is Direction Updated	Whether direction updates during movement.	Toggle
Is Pushable	Whether the entity can be pushed.	Toggle
Light	The light attached to the entity.	Light
Movement Type	The type of movement the entity will perform.	Entity Movement Type
Name	The display name.	String
Never Sleeps	Whether the object never sleeps during physics updates.	Toggle
Prevent Collision	Whether the entity tries to avoid occupying the same tile as another entity.	Toggle
Prevent Falling	Whether the entity tries to avoid falling.	Toggle
Recycle Animation	Whether to continuously animate the entity.	Toggle
Register Ignored Collisions	Whether to register collisions even when ignored.	Toggle
Rotation	The rotation of the entity model.	Vector
Shape	The shape of the entity in 3D.	Sprite Shape
Speed	The speed multiplier of the entity.	Number
Sprite / Model	The sprite or model of the entity on maps.	Sprite or Model

Entity Movement Type

Name	Explanation
None	The entity does not move on its own.
Random	The entity moves randomly in available directions.
Path	The entity follows a predefined movement path.