SuperAPI AI 工具集

godot-tilemap

编程与开发

查看项目

更新于 10-15 21:49

技能介绍

用途:在 Godot 4.7 中用 TileMapLayer 与 TileSet 设计基于瓦片的 2D 关卡,配置 TileSet(碰撞、导航、自定义数据、地形),或在代码中读写瓦片。也适用于把已弃用的单一 TileMap 节点迁移为多个 TileMapLayer 节点(每层一个)。不适用于:角色移动(见 godot-2d-movement)、通用物理体与射线(godot-physics)、程序化地图生成算法(procedural-gen)、关卡设计实践(level-design)。

主要能力:每个 TileMapLayer 节点承载一个视觉或逻辑层(背景、墙、前景);在 TileSet 编辑器中添加图集源,并将 TileSet 保存为外部 .tres 供多层多关卡复用;为瓦片添加物理层(碰撞多边形)、导航层、遮挡与自定义数据层(如 damage、is_ladder 等带类型的逐瓦片值);在底部面板用绘制、直线、矩形、填充等方式上色,自连接瓦片可定义地形集并用 Connect/Path 模式绘制;通过层的 collision_enabled / navigation_enabled 属性启用逐层碰撞与导航。

代码用法:用 local_to_map、set_cell、get_cell_source_id、get_cell_tile_data(...).get_custom_data(...) 进行读写;用 erase_cell 或 set_cell(cell, -1) 删除,用 clear() 清空该层;可用 set_cells_terrain_connect(cells, terrain_set, terrain, true) 按地形批量填充区域;用 get_used_cells() 遍历已放置瓦片。

限制与常见问题:TileMap 节点在 4.3 中已弃用,应改用每层一个的 TileMapLayer 节点并挂在父 Node2D 下,旧式带 layer 参数的调用不适用。local_to_map 需要局部坐标,鼠标或全局坐标须先用 to_local 转换。get_cell_tile_data 对空格或非图集源返回 null,取值前须判空。自定义数据有类型,读错类型或引用不存在的层名会报错,需先在 TileSet 中定义。地形需定义所有组合,否则自动拼接结果异常。运行时编辑会在帧末批量生效,若需立即读到更新后的内部数据要调用 update_internals()(开销较大,避免在循环中调用)。碰撞失效时检查层的 collision_enabled、瓦片是否含带多边形的物理层、以及 TileSet 物理层掩码是否与物体匹配。更多 TileSet 配置、场景瓦片、Y 排序与运行时瓦片数据覆盖见 references/tileset-and-terrains.md。

相关技能:godot-2d-movement、godot-physics、procedural-gen、level-design / roguelike。