Tiled 图像集合瓦片集(Image Collection Tileset)实战:Sticker Knight 横版平台跳跃示例深度解析

原创2026-09-22 17:05:001,354 阅读
文章标签:游戏开发桌面应用

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 的优秀示例)。这意味着整个示例可以用来演示两个关键特性:

  1. 图像集合瓦片集:每个瓦片引用自己独立的图片文件,允许瓦片尺寸各不相同,非常适合角色、道具、建筑等"不规整"素材;
  2. 瓦片对象:对象图层中的对象直接引用瓦片集的某个瓦片(通过 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 中 "Added columns attribute to the tileset element" 条目);
  • 每个瓦片通过 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 之所以全用对象图层,正是为了把"瓦片对象 + 属性 + 模板"这一套能力完整演示出来。

动手实践建议

  1. 用 Tiled 打开 examples/sticker-knight/sticker-knight.world,从世界视图进入 map/sandbox.tmx,打开 Tilesets 面板观察 objs 瓦片集——注意每个瓦片的尺寸各不相同;
  2. 新建一张地图,用 Add External Tileset 引入 map/objs.tsx,选择任意瓦片后使用 插入瓦片工具(Insert Tile) 在对象图层上点击,即可复现示例中的"瓦片对象"摆放流程;对图像集合瓦片集,Object Alignment 属性(见 docs/manual/editing-tilesets.rst)会影响瓦片对象相对其原点的对齐方式;
  3. 尝试在 Templates 视图中拖拽 block.tx 到场景,观察它自动携带的 bodyType/density/friction 属性;
  4. 修改 objs.tsx 的 Columns 属性(仅图像集合瓦片集可编辑),体会它如何改变瓦片集在面板中的显示排布;
  5. 将 sandbox.tmx 另存为 JSON 格式(File > Save As),对比 title.json 的数据结构,理解两种格式的对应关系。

本示例全部素材由 @ponywolf 制作并已释放至公有领域,可在遵循其来源声明的前提下自由用于游戏项目——这正是它在 Tiled 官方仓库中长期作为"图像集合瓦片集 + 瓦片对象"教学范本的原因。

登录后查看全文
tiled