— — — — —
— — — — —
— — — — —
— — — — —
— — — — —
— — — — —
— — — — —
— — — — —
This is an old revision of the document!
A tile is the primary building block of a map in RPG in a Box. Tiles are typically used to construct the ground, buildings, and other structures/architecture, and can be independently placed at any XYZ coordinate within the map. A tile's coordinate is unique among other tiles in the same map, as only one tile is permitted per XYZ coordinate. As the player character and NPCs move around the map, any tiles they step onto will act as terrain and determine the vertical positioning of the characters.
Refer to the table below for a list of tile properties that can be accessed from a script. If the property's value can be changed using an assignment statement, it will be noted in the description.
Property | Description |
---|---|
<tile>.id | Entity ID of the tile, as set in the Map Editor from the Entity Properties panel. This can be used to either retrieve or change the ID of the tile. |
<tile>.type | Type of entity, in this case the constant value TILE. |
<tile>.coord | Coordinate of the tile. |
<tile>.direction | Cardinal direction (NORTH, SOUTH, WEST, EAST) in which the tile is rotated. The default direction of an entity is SOUTH. |
<tile>.characters | An array of characters currently occupying the tile, or null if there are none. |
<tile>.groups | An array of groups to which the tile is assigned. The array will be empty if the tile is not assigned to any groups. |
<tile>.tags | An array of tags (as strings) for the tile, as set in the Voxel Editor from the Model Properties panel. |
<tile>.interact_cursor | Interaction cursor for the tile, as set in the Map Editor from the Entity Properties panel. This can be used to either retrieve or change the interaction cursor for the tile. Valid values include “default”, “walk”, “interact”, “speak”, “attack”, or any custom cursor defined in your game configuration. |
<tile>.property[“x”] | Custom property stored on the tile, where “x” is a string containing the name of the property. This can be used to either retrieve or change the property's value. |
<tile>.model | Name of the tile's model (e.g. “grass”). |
<tile>.frame | Current animation frame (as a number, the first frame being 1). This can be used to either retrieve or change the model's current frame. If an animation is playing, it will be stopped. |
<tile>.animations | An array of animation names defined for this tile. The names will be string values. |
<tile>.terrain_type | Terrain type assigned to the tile (as a string, or null if none is assigned). |
<tile>.attach_points | An array of attach point names defined for this tile (across all animation frames). The names will be string values. The array will be empty is no attach points are defined. |
<tile>.waypoints | An array of waypoint names defined for this tile. This property will be null if the tile isn't currently configured as a moving platform. |