用途:在 Phaser 4 中使用 Tiled 地图文件(JSON)构建关卡。推荐流程为:在 Tiled 设计 → 导出 JSON → Phaser 加载 → 创建图层 → 设置碰撞。
主要能力:支持正交与等距地图、CSV/Base64 瓦片层格式;通过 Tiled 图块集属性 collides=true 配合 setCollisionByProperty 设置碰撞,也可用 setCollisionBetween 或 setCollisionByExclusion;支持对象层读取命名对象、按类型筛选对象及自定义属性;支持多图层深度控制、视差滚动(setScrollFactor)、多图块集、相机与世界边界、运行时瓦片增删查改及碰撞调试渲染。
使用方式:在 Tiled 中新建地图并设置方向、瓦片尺寸与地图尺寸;添加图块集时名称需与 map.addTilesetImage() 第一参数完全一致(区分大小写);导出时启用 Embed tilesets。加载用 this.load.tilemapTiledJSON('level1', 'assets/tilemaps/level1.json') 与 this.load.image('terrain', 'assets/images/terrain.png');创建用 this.make.tilemap({ key: 'level1' })、addTilesetImage、createLayer;碰撞用 groundLayer.setCollisionByProperty({ collides: true }) 配合 physics.add.collider。
适用场景:2D 平台、俯视 RPG、策略等需要瓦片关卡的游戏。
限制:地图不显示常见原因是图块集名称不匹配;资料未提供收费、平台或效果信息。