Tiled 图像集合瓦片集(Image Collection Tileset)实战:Sticker Knight 横版平台跳跃示例深度解析
Tiled 图像集合瓦片集(Image Collection Tileset)实战:Sticker Knight 横版平台跳跃示例深度解析
本文围绕 Tiled 官方示例
examples/sticker-knight/展开,它由 @ponywolf 制作并已释放到公有领域(Public Domain)。该示例是学习 Tiled **图像集合瓦片集(Image Collection Tileset)与瓦片对象(Tile Object)**的绝佳范本:整个横版平台跳跃关卡——从背景、地面、城堡到 UI 界面——没有使用任何传统瓦片图层,而是全部由放置在对象图层上的瓦片对象构成。读完本文,你将掌握图像集合瓦片集的创建方式、TMX/JSON 两种文件格式下的数据结构、模板(Template)与对象图层的实战用法,以及视差(Parallax)和世界文件(World)的搭配技巧。
示例概览:一个全对象图层驱动的平台跳跃关卡
examples/sticker-knight/ 目录结构如下:
examples/sticker-knight/
├── README.md # 示例说明(本文解读对象)
├── preview.png # 示例预览图
├── sprites.png # 素材总览图
├── sticker-knight.world # 世界文件,串联三个地图
├── map/ # 游戏关卡
│ ├── objs.tsx # 核心:图像集合瓦片集(62 个瓦片,每个对应一张独立 PNG)
│ ├── sandbox.tmx # 主关卡地图
│ ├── sandbox2.tmx # 第二张关卡地图
│ └── templates/ # 对象模板
│ ├── block.tx # 可推动方块模板
│ ├── diamond.tx # 金币模板
│ └── hero.tx # 主角模板
└── ui/ # 游戏标题界面
├── title.png # 标题界面背景
├── title.json # 以 JSON 格式存储的 UI 地图
└── backgroundSet.png # UI 背景素材
README 中明确点出这个示例的核心价值:"It's a great example of using the flexible image collection tilesets with tiles on object layers, for both the map and the UI."(这是使用灵活的图像集合瓦片集、把瓦片放在对象图层上,同时应用于地图与 UI 的优秀示例)。这意味着整个示例可以用来演示两个关键特性:
- 图像集合瓦片集:每个瓦片引用自己独立的图片文件,允许瓦片尺寸各不相同,非常适合角色、道具、建筑等"不规整"素材;
- 瓦片对象:对象图层中的对象直接引用瓦片集的某个瓦片(通过
gid),从而在不需要传统瓦片图层的情况下"摆放"素材,还能叠加自定义属性、旋转、透明度等对象能力。
图像集合瓦片集:核心概念与创建方式
两种瓦片集类型
在 Tiled 中新建瓦片集时,可以选择两种类型(详见 docs/manual/editing-tilesets.rst):
- 基于瓦片集图片(Based on Tileset Image):所有瓦片大小固定,从一张大图中按网格裁剪,支持 margin(边距)与 spacing(间距)设置,适合规整的地形瓦片;
- 图像集合(Collection of Images):每个瓦片引用自己的图片文件,瓦片尺寸可以各不相同。官方文档明确说明它适用于"瓦片大小不一致,或纹理打包留到后续处理"的场景。
Sticker Knight 示例选择的正是第二种:map/objs.tsx 中 62 个瓦片分别引用了 map/ 目录下的独立 PNG 文件,尺寸从 32×32 的小地砖(如 grey.png、blue.png)到 384×128 的云朵(cloud.png)、192×192 的火光(flare.png)不一而足,充分体现了"灵活"二字的含义。
图像集合瓦片集的 TMX 结构
打开 examples/sticker-knight/map/objs.tsx 可以看到其典型结构:
<?xml version="1.0" encoding="UTF-8"?>
<tileset version="1.4" tiledversion="1.4.1" name="objs"
tilewidth="384" tileheight="332" tilecount="62" columns="0">
<tile id="0">
<image width="160" height="192" source="alter.png"/>
</tile>
<tile id="1">
<image width="96" height="64" source="blobBlue.png"/>
</tile>
<tile id="2">
<image width="96" height="64" source="blobGreen.png"/>
</tile>
<!-- ... 其余 59 个 tile 依此类推 ... -->
</tileset>
关键点解读:
<tileset>根元素上的tilewidth/tileheight在图像集合类型中没有实际意义(这里写 384×332 只是编辑器显示所需),真正决定瓦片大小的是每个<tile>内<image>元素的width/height;columns="0"表示该瓦片集不是从单张图片切割而来;TMX 文档格式中columns属性对图像集合瓦片集是可编辑的,仅用于控制瓦片集在编辑器中的显示列数(见 docs/reference/tmx-map-format.rst 与 tmx-changelog 中 "Addedcolumnsattribute to thetilesetelement" 条目);- 每个瓦片通过
source引用相对于该瓦片集文件所在目录的图片路径。在本示例中objs.tsx与所有 PNG 同处map/目录,所以直接用文件名即可;若图片在子目录中则需写相对路径; - 从 Tiled 1.0 起,官方推荐将瓦片集保存为独立文件(如这里的
.tsx),这样所有引用该瓦片集的地图都能共享瓦片元信息(如自定义属性、碰撞形状),避免重复维护; - 值得注意:示例中瓦片 ID 从 0 到 62 并非完全连续(跳过了 47),这正是 TMX 变更日志中提到的行为——图像集合瓦片集删除瓦片后不会改变其他瓦片的 ID,因此 ID 可以不连续。
在编辑器中,针对图像集合瓦片集的瓦片,其 Image 属性会显示该瓦片的图片文件并允许修改(见 docs/manual/editing-tilesets.rst),这是图像集合瓦片集独有的编辑能力。
瓦片对象:把瓦片"摆放"到对象图层
瓦片对象与 gid 机制
传统做法是把瓦片放进瓦片图层(Tile Layer),但 Sticker Knight 示例反其道而行:所有内容都以对象的形式放在对象图层(Object Group)中。对象图层中的每个 <object> 通过 gid(Global Tile ID,全局瓦片 ID)引用瓦片集中的某个瓦片,这类对象即"瓦片对象"(Tile Object)。
gid 的计算规则是:gid = firstgid + 瓦片在瓦片集中的 ID。在地图文件里,引用外部瓦片集时通过 firstgid 建立映射,例如 sandbox.tmx 第 3 行:
<tileset firstgid="1" source="objs.tsx"/>
这意味着 objs.tsx 中 ID 为 0 的瓦片(alter.png)在该地图中的 gid 为 1,ID 为 1 的 blobBlue.png 的 gid 为 2,依此类推。验证一下:sandbox.tmx 中 gid="16" 的对象对应瓦片 ID 15(flare.png,192×192),而该对象声明 width="192" height="192",完全吻合。
gid 的高位比特还被用于编码翻转(Flip)状态。以 examples/sticker-knight/map/sandbox.tmx 中的视差云层对象为例:
<objectgroup id="10" name="parallax clouds" parallaxx="0.5" parallaxy="0.5">
<object id="95" gid="7" x="-16.2424" y="452.394" width="384" height="128"/>
<object id="91" gid="2147483655" x="373.939" y="627.121" width="384" height="128"/>
...
</objectgroup>
2147483655 减去 2³¹(2147483648)等于 7,说明该对象使用的是与 ID 95 相同的云朵瓦片(gid 7 → 瓦片 ID 6,即 cloud.png),但带上了水平翻转标志。同理 sandbox.tmx 城堡层中的 2147483681 表示 gid 33 的瓦片(平台方块)做了水平翻转。这正是 TMX 规范中"GID 高位比特表示翻转"机制的实际应用(详见 docs/reference/tmx-map-format.rst 与 docs/reference/global-tile-ids.rst)。
瓦片对象的属性叠加能力
瓦片对象的优势在于:它既拥有瓦片本身的图片外观,又是一个完整的对象,可以附加自定义属性、旋转、透明度等。看 sandbox.tmx 的 ground 对象图层(第 30-44 行):
<objectgroup id="3" name="ground">
<object id="2" gid="31" x="0" y="1087" width="256" height="96">
<properties>
<property name="bodyType" value="static"/>
<property name="friction" type="float" value="1"/>
</properties>
</object>
<object id="4" gid="30" x="1216" y="895" width="256" height="96">
<properties>
<property name="bodyType" value="static"/>
<property name="floating" type="bool" value="true"/>
<property name="friction" type="float" value="1"/>
</properties>
</object>
...
</objectgroup>
每个地面瓦片对象都带有 bodyType=static、friction=1 等物理属性,悬空平台还额外标记 floating=true——这些属性在 Tiled 中只是普通自定义属性,但会被游戏引擎读取并解析为物理实体参数。这正是"编辑器摆画面,引擎读属性"的典型协作模式。
再比如 castledeco 层中的出口对象(第 187-191 行):
<object id="57" type="exit" gid="13" x="2016" y="991" width="160" height="192">
<properties>
<property name="map" value="scene/game/map/sandbox2.json"/>
</properties>
</object>
type="exit" 声明了对象类型,map 属性指定了切换到 sandbox2.json 的关卡路径,游戏逻辑据此实现关卡切换。另外 shading 层(第 193-211 行)使用了 opacity="0.36" 的对象图层并复用同一张阴影贴图瓦片来营造整体光影氛围,展示了对象图层级透明度控制的威力。
对象模板:复用带属性的"预制件"
对象模板(Object Template)允许把"瓦片 + 默认属性"打包成可复用的预制件,避免在多个对象上重复输入相同属性。Sticker Knight 在 map/templates/ 下提供了三个模板。
hero.tx:主角出生点
examples/sticker-knight/map/templates/hero.tx:
<?xml version="1.0" encoding="UTF-8"?>
<template>
<tileset firstgid="1" source="../objs.tsx"/>
<object name="hero" type="hero" gid="22" width="128" height="160"/>
</template>
引用模板时需要给出相对于模板文件自身位置的瓦片集路径(../objs.tsx)。gid 22 对应瓦片 ID 21,即 hero.png(128×160),与模板中声明的宽高一致。
diamond.tx:金币
examples/sticker-knight/map/templates/diamond.tx:
<?xml version="1.0" encoding="UTF-8"?>
<template>
<tileset firstgid="1" source="../objs.tsx"/>
<object type="coin" gid="17" width="64" height="64"/>
</template>
模板声明了 type="coin",gid 17 对应瓦片 ID 16(gemBlueStroked.png,64×64)。
block.tx:可推动方块
examples/sticker-knight/map/templates/block.tx 展示了模板最实用的场景——携带物理参数:
<?xml version="1.0" encoding="UTF-8"?>
<template>
<tileset firstgid="1" source="../objs.tsx"/>
<object name="block" gid="44" width="96" height="96">
<properties>
<property name="bodyType" value="dynamic"/>
<property name="density" type="float" value="2"/>
<property name="friction" type="float" value="0.45"/>
</properties>
</object>
</template>
它引用的是瓦片 ID 43(pushBlock3.png,96×96),并预设了 bodyType=dynamic(动态刚体)、density=2、friction=0.45 等物理属性。
在关卡中实例化模板
game 对象图层(sandbox.tmx 第 212-222 行)通过 template 属性实例化这些预制件,摆放时只需给出坐标:
<objectgroup id="7" name="game">
<object id="58" template="templates/hero.tx" x="45" y="979.5"/>
<object id="111" template="templates/block.tx" x="594" y="571"/>
<object id="190" template="templates/diamond.tx" x="238" y="947.5"/>
...
</objectgroup>
模板引用路径同样相对于地图文件所在目录(templates/hero.tx 相对于 map/)。使用模板后,关卡文件极为精简:一行坐标即一个游戏实体;若要统一调整金币的物理参数,只需修改 diamond.tx 一处。这正是对象模板在大型关卡工程中的价值——详见 docs/manual/using-templates.rst。
视差滚动:对象图层级的 Parallax 配置
sandbox.tmx 通过多个对象图层实现了层次丰富的视差背景,每层有独立的 parallaxx/parallaxy:
| 图层 | parallaxx / parallaxy | 内容 |
|---|---|---|
| static | 0 / 0 | 固定装饰(不随相机移动) |
| parallax clouds | 0.5 / 0.5 | 远景云层(半速滚动) |
| parallax background | 0.8 / 0.8 | 远景山脉、塔楼(八折速度) |
| background | 1 / 1 | 常规背景(满速) |
| ground / castle 等 | 1 / 1 | 游戏主体 |
对应代码(sandbox.tmx 第 4-22 行):
<objectgroup id="11" name="static" parallaxx="0" parallaxy="0">
<object id="90" gid="16" x="146.97" y="693.727" width="192" height="192"/>
</objectgroup>
<objectgroup id="10" name="parallax clouds" parallaxx="0.5" parallaxy="0.5">
...
</objectgroup>
<objectgroup id="1" name="parallax background" parallaxx="0.8" parallaxy="0.8">
...
</objectgroup>
parallaxx=0 的图层完全不随相机移动(常驻画面的静态层),0.5 表示相机移动 1 像素、该层只移动 0.5 像素,数值越小滚动越慢、感觉越远。地图根元素上的 parallaxoriginx/parallaxoriginy(示例中为 1264、720,即画布中心)定义了视差的原点。这种"图层级视差"(Layer Parallax Factor)是 Tiled 1.4 引入的能力,详见 docs/manual/layers.rst。
关卡串联:World 文件(.world)
examples/sticker-knight/sticker-knight.world 把三张"地图"组织进同一个世界,方便在编辑器中整体预览与跳转:
{
"maps": [
{
"fileName": "map/sandbox2.tmx",
"height": 992,
"width": 2560,
"x": 1824,
"y": 0
},
{
"fileName": "map/sandbox.tmx",
"height": 1440,
"width": 2528,
"x": 0,
"y": -1792
},
{
"fileName": "ui/title.json",
"height": 832,
"width": 1216,
"x": -1760,
"y": -1408
}
],
"onlyShowAdjacentMaps": false,
"type": "world"
}
要点:
- 每张地图通过
x/y在世界坐标系中定位,width/height声明其占据的像素范围; onlyShowAdjacentMaps: false表示同时显示所有地图(默认只渲染相邻地图以提升性能);- 有趣的是
ui/title.json也被当作一张地图挂入世界——用 JSON 格式存储的 UI 布局与游戏关卡在同一个世界文件中协同预览; - 世界文件支持相对路径,其路径基准是
.world文件所在目录(这里三张地图都在sticker-knight/之下)。
UI 的 JSON 实现:同一种技巧的另一种载体
ui/title.json 是 Tiled JSON 地图格式(见 docs/reference/json-map-format.rst)的实例:整个标题界面同样是"图像集合瓦片集 + 对象图层",只是换用了 JSON 语法。前 80 行已可窥其全貌:
{ "backgroundcolor":"#3b97d3",
"compressionlevel":-1,
"height":26,
"infinite":false,
"layers":[
{
"draworder":"topdown",
"id":1,
"name":"background-near",
"objects":[
{
"gid":7,
"height":262.666666666667,
"id":11,
"name":"ground",
"rotation":0,
"type":"",
"visible":true,
"width":1736,
"x":-256,
"y":920.666666666667
},
...
],
"opacity":1,
"type":"objectgroup",
"visible":true,
"x":0,
"y":0
},
{
"id":6,
"name":"background-far",
"objects":[ ... ],
"opacity":0.57,
"parallaxx":0.7,
"parallaxy":0.7,
"type":"objectgroup",
...
}
]
}
与 TMX 语法对照:
type: "objectgroup"对应 TMX 的<objectgroup>,"objects"数组对应其中的<object>列表;- 每个对象同样用
gid引用瓦片,用x/y/width/height定义位置与显示尺寸,rotation、visible、name一应俱全; parallaxx/parallaxy(如background-far层的 0.7)同样支持视差;opacity(0.57)实现图层半透明;compressionlevel: -1表示压缩级别由 Tiled 默认决定(-1 为无压缩的默认层级,详见 JSON 格式文档中的compressionlevel说明)。
可见,同一套"图像集合瓦片集 + 瓦片对象"工作流可以无缝跨越 TMX 与 JSON 两种格式,UI 与游戏场景共享同样的数据模型。
对象图层替代瓦片图层的取舍分析
从源码结构看(sandbox.tmx 的 12 个对象图层中没有一个 <layer> 瓦片图层),本示例把对象图层用到了极致。这种做法的取舍如下:
优势:
- 尺寸自由:每个瓦片对象独立指定宽高,同一张图片可以按需拉伸(如把 96×64 的平台连接件拉成任意长度);
- 属性丰富:对象天然支持自定义属性、旋转、透明度、类型名,可直接承载游戏逻辑(物理参数、关卡跳转、出生点标记);
- 模板复用:配合模板可批量维护"预制件"参数;
- 图层级控制:视差、透明度均可在对象图层层面整体调节。
代价:
- 对象图层不适合逐格绘制的密集地形(数千个对象会让文件臃肿且难以手绘编辑);
- 栅格对齐、自动图块(AutoMapping)等瓦片图层专用能力无法直接应用(Tiled 的自动映射是针对瓦片图层的,见 docs/manual/automapping.md)。
因此更典型的工程实践是"瓦片图层画地形 + 对象图层放实体"的混合方案;Sticker Knight 之所以全用对象图层,正是为了把"瓦片对象 + 属性 + 模板"这一套能力完整演示出来。
动手实践建议
- 用 Tiled 打开 examples/sticker-knight/sticker-knight.world,从世界视图进入
map/sandbox.tmx,打开Tilesets面板观察objs瓦片集——注意每个瓦片的尺寸各不相同; - 新建一张地图,用 Add External Tileset 引入
map/objs.tsx,选择任意瓦片后使用 插入瓦片工具(Insert Tile) 在对象图层上点击,即可复现示例中的"瓦片对象"摆放流程;对图像集合瓦片集,Object Alignment 属性(见 docs/manual/editing-tilesets.rst)会影响瓦片对象相对其原点的对齐方式; - 尝试在
Templates视图中拖拽block.tx到场景,观察它自动携带的bodyType/density/friction属性; - 修改
objs.tsx的 Columns 属性(仅图像集合瓦片集可编辑),体会它如何改变瓦片集在面板中的显示排布; - 将
sandbox.tmx另存为 JSON 格式(File > Save As),对比title.json的数据结构,理解两种格式的对应关系。
本示例全部素材由 @ponywolf 制作并已释放至公有领域,可在遵循其来源声明的前提下自由用于游戏项目——这正是它在 Tiled 官方仓库中长期作为"图像集合瓦片集 + 瓦片对象"教学范本的原因。