Skip to main content

Archivedoor

Based on game build 714014 | Last updated: 2026-02-28

Overview

This file defines a static layout for the archived door area in the Caves. It is a Tiled map data file (.lua format) used by DST's world generation system to instantiate the physical geometry and object placement of a specific room — the archived door chamber. It contains grid-based tile layers (e.g., floor tiles), an object group for placing entities like pillars, and metadata required by the engine to correctly reconstruct the layout during map generation. As a static layout, it is not a component in the ECS sense (i.e., not dynamically attached to entities), but rather a declarative configuration asset consumed by map/room generation scripts.

Usage example

This file is not instantiated or used directly in mod code. Instead, it is referenced indirectly by world generation systems such as map/tasksets/caves.lua or map/levels/caves.lua. A typical internal usage pattern looks like:

local archivedoor_layout = require "map/static_layouts/archivedoor"
-- The engine or worldgen code loads this data, parses tile layers and object groups,
-- and places appropriate prefabs and tile layers in the world.

Modders should not instantiate this file manually. Instead, they should extend or override static layouts via the WORLDGEN_OVERRIDES or by adding new room/task definitions.

Dependencies & tags

Components used: None (this is a data file, not an ECS component). Tags: None identified.

Properties

The following properties are defined in the layout data table. These are configuration values used by the world generation system, not entity properties:

PropertyTypeDefault ValueDescription
versionstring"1.1"Tiled export format version.
luaversionstring"5.1"Lua interpreter version expected for parsing.
orientationstring"orthogonal"Map projection type. DST only supports orthogonal.
widthinteger36Width of the map in tiles.
heightinteger36Height of the map in tiles.
tilewidthinteger16Width of each tile in pixels.
tileheightinteger16Height of each tile in pixels.
propertiestable{}Reserved for future metadata (currently unused).
tilesetsarray of tablesTileset definitions including image path, gid, dimensions.
layersarray of tablesTile layers (e.g., BG_TILES) and object groups (e.g., FG_OBJECTS).

Main functions

This file exports a single data table and does not define any functions.

Events & listeners

Not applicable — this is a static data file, not a runtime component. No events are registered or dispatched by this file.