Godot 使用图块集 (Using TileSets) 教程

前言

图块地图 (TileMap) 是一种以图块为单位的网格，用来制作游戏场景。使用 TileMapLayer 节点设计关卡有几个优点。首先，你可以直接在网格上“涂画”图块，比起一个一个放置 Sprite2D 节点效率高很多。其次，图块地图针对大量图块绘制做过优化，可用于更大规模的场景。最后，你还可以为图块加上碰撞、遮蔽与导览等功能。

要使用 TileMapLayer 节点，你需要先建立一个 TileSet。 一组 TileSet 是可以放在 TileMapLayer 节点上的图块集合。建立 TileSet 后，你就可以透过 TileMap 编辑器 来使用它们。

依照本教学操作时，你需要准备一张包含多个图块、且每个图块大小相同的图片（大型物件可以切分成多个图块）。这种图片称作 图块表 （tilesheet）。图块不一定要是正方形，矩形、六角形，甚至等轴（类 3D 视角）都可以。

建立 TileSet

使用图块表

本教学使用来自 Kenney“Abstract Platformer”美术包的图块。完整资源包可于 这里 取得，范例仅使用其中部分图块表。

新增一个 TileMapLayer 节点，然后在属性面板中建立新的 TileSet 资源：

建立 TileSet 资源后，点击该属性值可在属性面板展开相关设定。预设图块形状为“正方形”，也可根据图块图像选择“等轴”、“半偏移正方形”或“六边形”。若使用非方形图块，可能还需调整 Tile Layout**（图块排列）与 **Tile Offset Axis**（图块偏移轴）。最后，如果希望依据图块座标裁切图块，可启用 **Rendering > UV Clipping，避免图块绘制超出台块表分配区域。

在属性面板将图块大小设为 64×64，以符合范例图块表：

如果要使用自动建立图块（如本教学范例）， 必须先 设定图块大小，然后再建立 图块集（atlas） 。图块集会根据设定的大小，决定哪些区块能加入 TileMapLayer（并非图片每个区块都会生成图块）。

打开编辑器下方的 TileSet 面板，将图块表图像直接拖曳到面板上。系统会询问是否自动建立图块，请选择 是：

这会根据你在 TileSet 资源指定的图块大小，自动建立所有图块，大大加快初期设定流程。

备注

使用自动产生图块时，图块表中*完全*透明的区域将不会建立图块。

如果有不希望出现在图块集中的图块，可以在图块预览区上方选择橡皮擦工具，点击欲删除的图块：

也可以直接按右键选择 删除 来移除图块，无需使用橡皮擦工具。

小诀窍

和 2D 及 TileMap 编辑器一样，可以用鼠标中键或右键平移 TileSet 面板，用鼠标滚轮或左上角按钮缩放预览。

若要将多张图块表中的图块纳入同一个 TileSet，请先建立多个图块集（atlas）并分别指定材质。虽然也能每个图块都用独立图档，但建议还是使用图块表以方便管理。

你可以在中间字段调整图块集（atlas）的属性：

图块集支援下列属性调整：

• ID： 此图块集内唯一的识别码，用于排序。

• 名称： 图块集的自订名称，建议用于描述用途（例：地形、装饰等）。

• 边界： 图块表边缘不作为图块的像素宽度。若你的图块表有边界（如标示作者），可适当增加此值。

• 间隔： 每个图块之间的像素距离。若图块表每格间有辅助线或间隔，请适当设定此值。

• 纹理区域大小： 每个图块的像素尺寸。通常建议与 TileMapLayer 设定的图块大小一致（但不是强制）。

• 使用纹理边界： 勾选后会在每个图块四周加 1 像素透明边，避免开启过滤时出现纹理渗色。建议预设启用，除非边界导致算绘问题。

请注意，调整纹理边界、间隔及区域大小可能导致部分图块无法正确分割。若需要重新自动产生图块，可在 TileSet 编辑器顶部的“三点选单”下选择 在非透明纹理区域建立图块。

使用场景集合

自 Godot 4.0 起，你可以将实际的 场景 作为图块放置。这表示你可以将任意节点集合用作图块。例如，场景图块可以用来放置游戏要素，像是玩家可以互动的商店，也能用于放置 AudioStreamPlayer2D（环境音效）、粒子特效等。

警告

场景图块比图集图块有更高的效能负担，因为每个放置的图块都会个别产生一个场景实例。

建议仅在必要时才使用场景图块。如果只需要在图块中绘制精灵且不需进阶操作，请改用图集。

本范例会先建立一个以 CPUParticles2D 为根节点的场景，将它存档（与包含 TileMapLayer 的场景分开存），然后切换回包含 TileMapLayer 的场景。打开 TileSet 编辑器，在左侧栏新增一个 场景集合：

建立场景集合后，你可以在中间字段输入描述名称。选择该场景集合，再新增一个场景槽：

在右侧栏选择这个场景槽，然后点击 快速载入**（或 **载入）来载入含粒子的场景档案：

此时你的 TileSet 已有一个场景图块。切换到 TileMap 编辑器后，就能从场景集合中选用并像其他图块一样绘制它。

将多个图集合并成单一图集

在同一个 TileSet 资源中用多个图集有时很方便，但某些情况下（例如每个图块用一张图）会变得很难管理。Godot 提供了将多个图集合并为单一图集的功能，让整理更容易。

要执行此操作，你必须在 TileSet 资源里先建立至少两个图集。然后在图集列表下方点选“三个垂直点”功能表，选择 开启图集合并工具：

这会开启一个对话视窗，你可以按住 Shift 或 Ctrl 键点击多个图集来选取：

选择 合并 会把选取的图集合并成一个图集（即 TileSet 内只剩一个图集）。未合并的图集会从 TileSet 中移除，但*原始图集影像仍会保留在档案系统*。如果不想移除未合并的图集，请选择 合并（保留原图集）。

向 TileSet 新增碰撞、导览和遮挡

我们现在已经成功建立了一个基本的图块集。我们现在可以在 TileMapLayer 节点中使用它了，但它目前缺乏任何形式的碰撞侦测。这表示玩家及其他物件会直接穿过地板或墙壁。

如果使用 2D 导览，还需要为图块定义导览多边形，以生成导览网格，供代理用于寻路。

最后，如果你使用 2D 灯光和阴影 或 GPUParticles2D，你可能还希望 TileSet 能够投射阴影并与粒子碰撞。这就需要为 TileSet 上的 “实体” 图块定义遮挡多边形。

若要能够定义每个图块的碰撞、导航和遮挡形状，您首先需要为图块集资源建立一个物理、导航或遮挡图层。若要这么做，请选取 TileMapLayer 节点，在属性检视器中按一下图块集属性值进行编辑，然后展开 物理图层 并选择 新增元素：

如果你还需要导览辅助，可以建立导览层：

如果你需要支援光照多边形遮挡器，可以建立遮挡层：

备注

本教学的后续步骤专门用于建立碰撞多边形，但导览和遮挡的步骤非常相似。它们各自的多边形编辑器行为方式相同，因此为简洁起见不再重复这些步骤。

唯一需要注意的是，图块的遮挡多边形属性是合集属性检视器中 算绘 分节的一部分。请确保展开该部分，以便编辑多边形。

建立实体层后，你可以存取 TileSet 合集属性检视器中的 实体层 部分：

你可以在聚焦 TileSet 编辑器时按 F 快速建立矩形碰撞形状。如果键盘快捷键不起作用，请尝试按一下多边形编辑器周围的空白区域使其聚焦：

在这个图块碰撞编辑器中，你可以使用所有二维多边形编辑工具：

• 使用多边形上方的工具列可在建立新多边形、编辑现有多边形和删除多边形上的点之间切换。“三个竖点”功能表按钮提供了其他选项，例如旋转和翻转多边形。

• 通过按一下并拖动两点之间的直线来建立新点。

• 按右键一个点（或使用上述移除工具并左键按一下）将其移除。

• 通过中键或右键在编辑器中平移。(右键平移只能用于附近没有点的区域）

你可以使用预设的矩形形状，通过移除其中一个点来快速建立三角形碰撞形状：

你还可以通过新增更多点，将矩形用作更复杂形状的基础：

小诀窍

如果你有一个大的图块集，为每个图块单独指定碰撞可能会花费很多时间。尤其是在 TileMaps 中往往有许多具有常见碰撞模式（如实心块或 45 度斜坡）的图块。要快速将类似的碰撞形状应用到多个图块，请使用 一次为多个图块指定属性 的功能。

为 TileSet 的图块分配自订中继资料

你可以使用*自订资料层*来为各个图块分配自订资料。可以用来储存游戏过程中所需的特定资讯，例如玩家接触该图块时应该受到的伤害，以及是否能够使用物理将图块摧毁。

资料是在 TileSet 中与图块进行关联的：放置的所有图块使用的都是相同的自订资料。如果你需要建立拥有不同自订资料的变体图块，可以通过 建立备选图块 并为该备选图块更改自订资料来实作。

改变自订资料的顺序不会损坏现有的中继资料：TileSet 编辑器会在自订资料属性的顺序发生改变后自动进行更新。

使用上面显示的自订资料图层范例，我们正在指派一个图块，使其具有设定为 25 的 damage_per_second 中继资料，以及设定为 false 的 destructible 中继资料：

自订资料也可以进行 图块属性的绘制：