WorldMetadataRegistry

Registry and validator for multi-layer world maps, semantic tiles, elevation, and zones.

Constructor

new WorldMetadataRegistry()

Classes

WorldMetadataRegistry

Methods

addLayer(layer) → {Object}

Add a layer to the world metadata registry.

Parameters:
NameTypeDescription
layerObject
Properties
NameTypeAttributesDefaultDescription
idstring

Unique layer ID

namestring<optional>

Display name

typestring<optional>
"visual"

'visual'|'collision'|'elevation'|'zones'|'materials'

elevationnumber<optional>
0

Base elevation for layer

zIndexnumber<optional>
0

Drawing / evaluation priority

widthnumber<optional>
10
heightnumber<optional>
10
dataArray.<Array.<number>><optional>

2D grid of tile IDs

Returns:

Layer record

Type: 
Object

addZone(zoneConfig) → {Object}

Register a semantic zone (e.g. safe area, dungeon entrance, hazard field).

Parameters:
NameTypeDescription
zoneConfigObject
Properties
NameTypeAttributesDefaultDescription
idstring

Unique zone ID

namestring<optional>
typestring<optional>
"region"
boundsObject

{ left, right, top, bottom }

elevationnumber<optional>
0
heightnumber<optional>
2
metadataObject<optional>
{}
Returns:

Registered zone

Type: 
Object

getComposedMetadataAt(x, y) → {Object}

Resolve composite metadata at coordinate (x, y) across all layers with override conflict resolution. Higher zIndex layers override lower zIndex layers for collision/walkability and material. Explicit collision layer takes precedence over visual layer.

Parameters:
NameTypeDescription
xnumber

Grid X

ynumber

Grid Y

Returns:

Composite tile metadata

Type: 
Object

getLayer(layerId) → {Object}

Get a layer by ID. Throws if layer does not exist.

Parameters:
NameTypeDescription
layerIdstring
Returns:
Type: 
Object

getTile(tileId) → {Object}

Get tile metadata definition. Throws an Error if tileId is unknown.

Parameters:
NameTypeDescription
tileIdnumber | string
Returns:
Type: 
Object

getZonesAt(x, y, elevationopt) → {Array.<Object>}

Get all zones containing world position (x, y) with matching elevation interval.

Parameters:
NameTypeAttributesDefaultDescription
xnumber
ynumber
elevationnumber<optional>
0
Returns:
Type: 
Array.<Object>

hasTile(tileId) → {boolean}

Check if a tile ID is registered.

Parameters:
NameTypeDescription
tileIdnumber | string
Returns:
Type: 
boolean

registerTile(tileId, metadata) → {Object}

Register semantic metadata for a tile type.

Parameters:
NameTypeDescription
tileIdnumber | string
metadataObject
Properties
NameTypeAttributesDefaultDescription
namestring<optional>
walkableboolean<optional>
true
materialstring<optional>
"stone"

SIM-01 material name

traversalCostnumber<optional>
1.0
elevationnumber<optional>
0
climbableboolean<optional>
false
hazardObject<optional>
null
interactionObject<optional>
null
Returns:

Registered definition

Type: 
Object

setTileAt(layerId, x, y, tileId)

Set a tile in a layer at specific grid coordinate.

Parameters:
NameTypeDescription
layerIdstring
xnumber

Grid X

ynumber

Grid Y

tileIdnumber | string | null