User Tools

Site Tools


tile

Tile


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.

Scripting

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.

PropertyDescription
<tile>.idEntity 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>.coordCoordinate of the tile.
<tile>.directionCardinal direction (NORTH, SOUTH, WEST, EAST) in which the tile is rotated. The default direction of an entity is SOUTH.
<tile>.charactersAn array of characters currently occupying the tile, or null if there are none.
<tile>.groupsAn array of groups to which the tile is assigned. The array will be empty if the tile is not assigned to any groups.
<tile>.tagsAn array of tags (as strings) for the tile, as set in the Voxel Editor from the Model Properties panel.
<tile>.interact_cursorInteraction 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.txt · Last modified: 2021/04/30 11:22 by justin