Tile 元数据层

GFTileMetadataLayer 在 GFTileMapCache 的格子字典基础上提供更直接的元数据读写、批量绘制、字段擦除、按值查询和可选 schema。

它适合支撑编辑器画刷、运行时标记、导出预处理或调试覆盖层，但仍只保存 Vector2i -> Dictionary，不解释字段语义。

var metadata := GFTileMetadataLayer.new()
metadata.set_schema_entry(&"cost", {
    "type": TYPE_INT,
    "default": 1,
})
metadata.paint_cells([Vector2i(1, 1), Vector2i(2, 1)], &"blocked", true)
metadata.merge_cell_data(Vector2i(3, 1), {
    "cost": 5,
    "tag": "road",
})

for cell in metadata.get_cells_with_value(&"blocked", true):
    # 项目层自行决定 blocked 影响寻路、渲染还是编辑器显示。
    pass

schema 只是给项目或编辑器 UI 使用的元数据字典。GF 不内置字段类型校验、TileSet 写回或业务规则。需要和基础缓存交换数据时，可用 to_tile_map_cache() / from_tile_map_cache()。