游戏引擎 / 系统课时
用 TiledMap 拼出 2D 关卡
用 TiledMap 拼出 2D 关卡
瓦片地图能把重复地块组织成关卡,但地图网格、图层和游戏碰撞不是同一套数据。本节以有限正交地图为范围,导入一个小地图,查询其尺寸与图层,并明确从瓦片到游戏规则仍需哪些步骤。
学习目标
- 成套导入地图与关联图集资源
- 读取地图尺寸和指定图层
- 区分瓦片坐标、显示位置与碰撞配置
准备一张可核对的地图
使用 Tiled 创建有限的正交地图,尺寸为 4×3,每格 32×32,建立名为 Ground 的瓦片图层并画上少量地块。保存 TMX 文件及它引用的 TSX、图片,保持相对路径关系,一起放入 Creator 3.8.8 的资源目录。不要只复制 TMX 后忽略外部图集依赖。
将地图资源加入场景,使节点具有 TiledMap 组件并绑定 TiledMapAsset。导入失败时先检查图片路径、文件名大小写与地图格式支持,而不是通过脚本给不存在的图层补一个同名节点。这里不使用无限地图、六边形地图或等距坐标。

查询资源是否按预期加载
保存为 MapProbe.ts,挂在拥有 TiledMap 的节点上。读取发生在场景组件初始化后,避免把尚未绑定资源的空组件当成有效地图。
ts
import { _decorator, Component, TiledMap } from 'cc';
const { ccclass } = _decorator;
@ccclass('MapProbe')
export class MapProbe extends Component {
start(): void {
const map = this.getComponent(TiledMap);
if (!map || !map.tmxAsset) {
console.error('MapProbe: TiledMap asset is missing');
return;
}
const size = map.getMapSize();
const tile = map.getTileSize();
const ground = map.getLayer('Ground');
// 图层名来自资源,拼写错误应直接暴露
console.log('cells:' + size.width + 'x' + size.height);
console.log('tile:' + tile.width + 'x' + tile.height);
console.log('ground:' + (ground !== null));
}
}预期输出:
text
cells:4x3
tile:32x32
ground:true从地图数据接到游戏逻辑
瓦片索引通常以列、行定位;地图节点的局部坐标还涉及行方向、原点、锚点以及地图类型,不能把索引直接传给世界位置。需要角色站在格子中心时,应使用对应图层的坐标接口,并经过节点变换,先用四个角格进行对照验证。
地图显示出墙壁不会自动为它生成正确的刚体与碰撞器。可在 Tiled 中用对象层标记墙区,再由游戏代码读取并生成约定的碰撞结构;应明确使用 2D 物理体系,并独立测试碰撞边界。视觉上连贯的地块也可能在物理上有缝隙。
大地图要按图层数量、可见区域、动态更新和物理对象数分别评估成本。先让小地图的尺寸、图片和图层名全部匹配,再扩大范围。官方 TiledMap 资源说明 可用于核对导入依赖与格式边界。
按自己的节奏,确认真正理解。