使用 TileSet

前言

A tilemap is a grid of tiles used to create a game's layout. There are several benefits to using TileMapLayer nodes to design your levels. First, they let you draw a layout by "painting" tiles onto a grid, which is much faster than placing individual Sprite2D nodes one by one. Second, they allow for larger levels because they are optimized for drawing large numbers of tiles. Finally, they allow you to add greater functionality to your tiles with collision, occlusion, and navigation shapes.

To use TileMapLayer nodes, you will need to create a TileSet first. A TileSet is a collection of tiles that can be placed in a TileMapLayer node. After creating a TileSet, you will be able to place them using the TileMap editor.

要跟随这个指南进行操作，你需要一张包含若干图块的图片，每个图块的大小都应该相同（较大的对象可以拆成若干个图块）。这种图片叫做图块表（Tilesheet）。图块不一定必须是正方形的：可以是矩形图块、六边形图块、等轴图块（伪 3D 透视）。

新建 TileSet

使用图块表

这个演示使用的是从 Kenney 的“抽象平台跳跃”包中选取的图块。我们会使用该集合中的这个图块表：

图块表示例，64×64 图块 — 64×64 图块的图块表。作者：Kenney

Create a new TileMapLayer node, then select it and create a new TileSet resource in the inspector:

Creating a new TileSet resource within the TileMapLayer node

创建 TileSet 资源后，在检查器中点击该值可以将其展开。默认图块形状是 Square（正方形），但是你也可以根据图块图像中的形状去选择 Isometric（等轴）、Half-Offset Square（半偏移正方形）、Hexagon（六边形）。如果使用了 Square 以外的图块形状，你可能还需要调整 Tile Layout（图块布局）和 Tile Offset Axis（图块偏移轴）等属性。最后，如果你想要让图块被图块坐标裁剪，还可以启用 Rendering > UV Clipping（渲染 > UV 裁剪）属性。这样就能够保证图块无法绘制到它们在图块表上分配的区域之外。

在检查器中将图块大小设置为 64×64，与示例图块表相匹配：

If relying on automatic tiles creation (like we're about to do here), you must set the tile size before creating the atlas. The atlas will determine which tiles from the tilesheet can be added to a TileMapLayer node (as not every part of the image may be a valid tile).

打开编辑器底部的 TileSet 面板，然后将图块表图像拖放到该面板中。这里会询问你是否要自动创建图块。请回答是：

这将根据你之前在 TileSet 资源中指定的图块尺寸自动创建图块。这将大大加快初始图块设置的速度。

备注

使用基于图像内容的自动图块生成功能时，图块表中完全透明的部分将不会生成图块。

如果不希望图集中出现图块表中的图块，请选择图块组预览顶部的橡皮擦工具，然后单击希望删除的图块：

你也可以右键单击图块，选择删除，作为橡皮擦工具的替代。

小技巧

与 2D 和 TileMap 编辑器一样，你可以使用鼠标中键或右键平移整个 TileSet 面板，并使用鼠标滚轮或左上角的按钮进行缩放。

如果你想在一个 TileSet 中使用好几张 tilesheet 来选择图块，新建几个图块集，并为每个图块集配置纹理再继续。你也可以用这种方法把单张图片作为一个图块来使用。（但是用 tilesheet 会方便得多）。

你可以调整中间的列中图集的属性：

可以在图集上调整以下属性：

ID： 标识符（在该 TileSet中每个图块集的标识符是唯一的），用于排序。
名称： 图集的人类可读名称。在此处使用描述性的名称来方便管理（例如“地形”，“装饰”等）。
边距： 图像边缘上的边距不应选择为图块（以像素为单位）。当你下载的图块表图像的边缘有边距（例如，用于表明归属），则增加这个值可能会很有用。
间距： 以像素为单位的地图集上的每个图块之间的间距。如果你使用的图块表图像包含辅助线（例如每个图块之间的轮廓），则增加间距可能会很有用。
Texture Region Size: The size of each tile on the atlas in pixels. In most cases, this should match the tile size defined in the TileMapLayer property (although this is not strictly necessary).
使用纹理内边距： 如果选用，则在每个图块周围添加一个1像素的透明的边缘，以防止启用过滤时纹理渗出（bleeding）。建议默认将其启用，除非你由于纹理内边距而遇到渲染问题。

请注意，更改纹理边距，间距和区域大小都有可能会导致图块丢失（其中一些将位于图集图片的坐标之外）。如要自动从图块表中再生图块，请使用图块集编辑器顶部的三个垂直点菜单按钮，然后选择 在不透明纹理区域创建图块 ：

使用场景合集

自 Godot 4.0 以来，你可以将实际的场景放置为图块。这允许你将任何节点集合用作图块。比如说，你可以使用场景图块来放置游戏元素，例如玩家可以与之互动的商店。还可以使用场景图块来放置 AudioStreamPlayer2D （用于环境声音）、粒子效果等。

警告

与图集相比，场景图块具有更大的性能开销，因为每个场景都是为每个放置的图块单独实例化的。

It's recommended to only use scene tiles when necessary. To draw sprites in a tile without any kind of advanced manipulation, use atlases instead.

For this example, we'll create a scene containing a CPUParticles2D root node. Save this scene to a scene file (separate from the scene containing the TileMapLayer), then switch to the scene containing the TileMapLayer node. Open the TileSet editor, and create a new Scenes Collection in the left column:

创建场景合集之后，你就可以根据自己的需要在中间栏内为场景合集输入描述名称。选中这个场景合集，然后创建一个新的场景槽：

在右栏中选中这个场景槽，然后使用快速加载（或加载）来加载包含粒子的场景文件：

现在你的 TileSet 中就有了一个场景图块。切换到 TileMap 编辑器之后，你就可以在场景合集中选择则个场景图块，然后和其他图块一样进行绘制。

将若干图集合并为单个图集

在单个 TileSet 资源中使用多个图集有时可能很有用，但在某些情况下可能会变得繁琐（特别是如果你每个图块使用一个图像）。Godot 允许你将多个图集合并成一个单独的图集，以便更轻松地组织。

如果要这样做，你必须在TileSet资源处创建了不止一个atlas。在atlas列表下找到“三个垂直排列的点”的菜单按钮，然后选择**打开图集合并工具**:

这将打开一个对话框，在该对话框中，你可以通过按住 Shift 或 Ctrl 键并同时点击多个元素来选择多个图集：

选择合并将以选择的图集合并成一个图集图片（在 TileSet 的单个图集）。没有合并的图集将会在 TileSet 被移除，但是 原来的 tilesheet 图片会被保留在文件系统里 。如果你想在TileSet 资源保留没有合并的图集，选择 合并（保留原来的图集） 。

小技巧

TileSet 具有一个 图块代理 系统。图块代理是一张映射表，它允许通知使用了给定 TileSet 的 TileMap，以便将一组给定的图块标识符替换为另一组图块标识符。

合并不同图集时会自动设置图块代理，但也可以通过 管理图块代理 对话框手动设置，你可以使用上面提到的“三个竖点”菜单访问该对话框。

当你更改了图集 ID 或想用另一个图集的图块替换一个图集的所有图块时，手动创建图块代理可能会很有用。请注意，编辑 TileMap 时，你可以用相应的映射值替换所有网格。

向 TileSet 添加碰撞、导航和遮挡

We've now successfully created a basic TileSet. We could start using it in the TileMapLayer node now, but it currently lacks any form of collision detection. This means the player and other objects could walk straight through the floor or walls.

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

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

To be able to define collision, navigation and occlusion shapes for each tile, you will need to create a physics, navigation or occlusion layer for the TileSet resource first. To do so, select the TileMapLayer node, click the TileSet property value in the inspector to edit it then unfold Physics Layers and choose Add Element:

Creating a physics layer in the TileSet resource inspector (within the TileMapLayer node)

如果你还需要导航辅助，可以创建导航层：

Creating a navigation layer in the TileSet resource inspector (within the TileMapLayer node)

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

Creating an occlusion layer in the TileSet resource inspector (within the TileMapLayer node)

备注

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

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

创建物理层后，你可以访问 TileSet 图集检查器中的 物理层 部分：

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

按 :kbd:`F` 键使用默认矩形碰撞形状 — 按 `F` 键使用默认矩形碰撞形状

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

使用多边形上方的工具栏可在创建新多边形、编辑现有多边形和删除多边形上的点之间切换。“三个竖点”菜单按钮提供了其他选项，例如旋转和翻转多边形。
通过单击并拖动两点之间的直线来创建新点。
右键单击一个点（或使用上述移除工具并左键单击）将其移除。
通过中键或右键在编辑器中平移。(右键平移只能用于附近没有点的区域）

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

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

小技巧

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

为 TileSet 的图块分配自定义元数据

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

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

Creating a custom data layer in the TileSet resource inspector (within the TileMapLayer node)

改变自定义数据的顺序不会损坏现有的元数据：TileSet 编辑器会在自定义数据属性的顺序发生改变后自动进行更新。

With the custom data layers example shown above, we're assigning a tile to have the damage_per_second metadata set to 25 and the destructible metadata to false:

自定义数据也可以进行图块属性的绘制：

创建地形集（自动图块）

备注

这个功能和 Godot 3.x 中的自动图块使用了不同的实现方式。地形系统能够完全替代自动图块，功能也更强大。与自动图块不同，地形系统支持不同地形之间的过渡，这样就可以为同一个图定义多个地形。

与以前不同的是，自动图块是一种特定类型的图块，而地形只是分配给图集图块的一组属性。使用专门的 TileMap 绘制模式时就会用到这些属性，该模式能够对带有地形数据的图块进行智能选择。这意味着地形图块既可以作为地形绘制，也可以像其他图块一样作为单个图块绘制。

“完善”的图块集中通常会包含很多变体图块，适用于平台、地板等位置的角落和边缘。这种图块虽然可以手动放置，但是很快就会感觉非常麻烦。在程序式生成的关卡中如果要处理这种情况也很困难，需要编写大量的代码。

Godot offers terrains to perform this kind of tile connection automatically. This allows you to have the "correct" tile variants automatically used.

地形按照地形集分组。地形集有固定的模式，包括 Match Corners and Sides、Match Corners、Match sides（匹配角落和边缘、匹配角落、匹配边缘）。模式决定了地形集中的地形如何相互匹配。

备注

上述模式在 Godot 3.x 中对应的自动图块位掩码模式为 2×2、3×3、3×3 Minimal。也和 Tiled 编辑器中使用的模式类似。

Select the TileMapLayer node, go to the inspector and create a new terrain set within the TileSet resource:

Creating a terrain set in the TileSet resource inspector (within the TileMapLayer node)

创建地形集后，你必须在地形集中再创建若干地形：

在 TileSet 编辑器中，切换到“选择”模式并单击图块。在中间一栏展开地形部分，为图块分配地形集 ID 和地形 ID。-1 表示“没有地形集”和“没有地形”，因此你必须先将地形集设置为大于等于 0 的值，然后才能将地形设置为大于 0 的值。

备注

地形集 ID 和地形 ID 互相独立。从 0 开始，不从 1 开始。

完成此操作后，你现在可以配置地形邻接值（Terrain Peering Bits）部分，该部分在中间一列中可见。邻接值决定了根据相邻图块的情况放置哪个图块。-1 是一个特殊值，表示空白空间。

例如，如果一个地砖的所有位都设置为 0 或更大，那么只有在所有 8个相邻图块都使用具有相同地形 ID 的图块时，它才会出现。如果图块的位设置为“0”或更大，但左上、上和右上的位设置为“-1”，则只有在其顶部（包括对角线）有空位时才会出现。

完整图块表的配置示例如下：

一次为多个图块指定属性

有两种方法可以同时为多个图块分配属性。根据你的使用情况，一种方法可能比另一种方法更快：

使用多个图块选择

If you wish to configure various properties on several tiles at once, choose the Select mode at the top of the TileSet editor:

完成此操作后，你可以按住 Shift 键，然后单击图块，在右侧栏中选择多个图块。你还可以按住鼠标左键然后拖动鼠标来执行矩形选择。最后，你可以按住 Shift 然后单击选定的图块，取消选择已选中的图块（不会影响选择的其他部分）。

然后，你可以使用 TileSet 编辑器中间一列的检查器分配属性。只有在此更改的属性才会应用到所有选定的图块。与编辑器的检查器一样，在你编辑之前，所选图块上的不同属性将保持不同。

对于数值和颜色属性，编辑完成后还能在图集中的所有图块上看到属性值的预览：

使用图块属性绘制

如果要一次将单个属性应用于多个图块，则可以使用*属性绘制*模式来实现此目的。

在中间一列配置要绘制的属性，然后点击右列中的图块（或按住鼠标左键）以将属性“绘制”到图块上。

对于手动设置耗时的属性（例如碰撞形状），图块属性绘制特别有用：

创建备选图块

有时，你想使用单一的图块图像（在图集中只能找到一次），但要以不同的方式进行配置。例如，你可能想使用相同的图块图像，但对它进行旋转、翻转或调制成不同的颜色。这就可以使用 备选图块 来实现。

小技巧

从 Godot 4.2 开始，你将不再必须通过创建替代图块来旋转或翻转图块。你可以使用 TileMap 编辑器工具栏中的旋转/翻转按钮，在任何图块放置进 TileMap 编辑器中时旋转它。

要创建备选图块，请右键单击 TileSet 编辑器显示的图集中的基本图块，然后选择 创建备选图块：

如果当前处于“选择”模式，则可编辑已选中的备选图块。如果当前不在“选择”模式下，你仍然可以创建备选图块，但需要切换到“选择”模式并选择备选图块进行编辑。

如果看不到备选图块，请平移到图集图像的右侧，因为在 TileSet 编辑器中，备选图块总是出现在给定图集基础图块的右侧：

选择备选图块后，你可以使用中间一列更改任何属性，就像在基础图块上一样。但暴露的属性列表与基础图块不同：

备用 ID： 此可选图块的唯一数字标识符。更改它会破坏现有的瓦片地图，所以要小心！此 ID 还控制在编辑器中显示的可选图块列表中的排序。
渲染 > 水平翻转： 如果 启用 ，则图块水平翻转。
渲染 > 垂直翻转： 如果 启用 ，则图块垂直翻转。
渲染 > 转置： 如果 启用 ，则图块将 逆时针 旋转 90 度，然后再垂直翻转。实际上，这意味着要将图块顺时针旋转 90 度而不翻转它，你应该启用 水平翻转 和转置。要将图块顺时针旋转 180 度，请启用 水平翻转 和 垂直翻转 。要将图块顺时针旋转 270 度，请启用 垂直翻转 和转置。
渲染 > 纹理原点：绘制图块时使用的原点。可以用来将图块进行相对于基础图块的视觉偏移。
渲染 > 调制：渲染图块时的颜色乘数。
渲染 > 材质： 当前图块使用的材质。可以使用此选项为单个图块应用不同的混合模式或自定义着色器。
Z 索引： 当前图块的排序。数值大的图块会渲染在同一层中的其他图块之上。
Y Sort Origin: The vertical offset to use for tile sorting based on its Y coordinate (in pixels). This allows using layers as if they were on different height for top-down games. Adjusting this can help alleviate issues with sorting certain tiles. Only effective if Y Sort Enabled is true on the TileMapLayer node under CanvasItem > Ordering

你可以通过点击在备选图块旁的大 “+” 图标来创建额外的备选图块变体。这相当于选择基本图块并右键点击它以再次选择创建备选图块。

备注

当创建一个备选图块时，其基本图块的任何属性将不会被继承下来。如果你希望备选图块与基本图块的属性相同，那么你需要在备选图块中重新设置这些属性。