瓦片地图

瓷砖地图系统允许你使用自动拼贴掩码、多层以及带内置碰撞生成的墙体挤出，绘制基于瓷砖的世界。

添加瓷砖地图

添加一个 Tilemap_Component（瓷砖地图组件） 到任意实体。瓷砖地图以实体位置为中心，并跨越一个块网格（每块 32×32 瓷砖）。瓷砖的总大小为 width_in_chunks × 32（以块宽度 ×32） 乘以 height_in_chunks × 32（以块高度 ×32）.

瓷砖地图属性

属性	说明
以块为单位的宽 / 高	瓷砖网格的大小。每个块为 32×32 瓷砖。10×10 的瓷砖地图则为 320×320 瓷砖。

在进入编辑模式后可以单独配置图层（见下文）。

编辑模式

选择瓷砖地图实体并点击检查器中的 编辑 按钮以进入瓷砖地图编辑模式。点击 取消 以退出。如果取消选择实体，编辑模式会自动停用。

在编辑时，红色边框会勾画出瓷砖地图边界，并在场景视图中绘制网格覆盖。

工具

瓷砖地图编辑器有三种工具模式，可通过快捷键切换：

工具	快捷键	说明
画笔	B/W	通过点击并拖动来绘制瓷砖。
橡皮擦	E	通过点击并拖动来移除瓷砖。
图章	S/R	选择一个区域进行复制，然后将其粘贴到其他位置。

你也可以 按住 Shift 在画笔模式下临时擦除。

画笔绘制

点击并拖动在选定的图层上绘制瓷砖。画笔在帧间使用 Bresenham 直线插值，因此即使移动很快也不会跳过瓷砖。

画笔大小 通过 [ 和 ] 调整（范围 1–32）。画笔为圆形——半径内的瓷砖都会受影响。

Alt+点击 从上一次点击位置到当前瓷砖绘制一条直线，适用于长直边缘。

Ctrl+拖动 切换到矩形填充模式——拖动以定义矩形，松开时区域内所有瓷砖都会被填充（如果同时按住 Shift 则为擦除）。

图层

每个瓷砖地图支持多个图层。点击检查器中的图层以选择用于绘制的图层。被选中的图层会以蓝色高亮显示。

添加和删除图层

• 点击 添加图层 底部以创建新图层。

• 点击 删除图层 在图层面板内以删除该图层。

图层属性

属性	说明
类型	地面 或 墙体。地面瓷砖为平面；墙体瓷砖则垂直挤出。
图层模式	默认 使用自动分层（玩家后面的地面，墙体按 Y 排序）。 手动 允许你设置固定的渲染图层值。
手动图层	仅在手动模式下显示。显式的渲染图层值。
瓷砖大小	每块瓷砖在世界单位中的可视大小。
纹理	一个或多个带权重的纹理以实现随机多样性。引擎对瓷砖坐标进行哈希，根据权重决定每个瓷砖的确定性纹理选择。
掩码	用于自动拼贴的 8×8 网格纹理。每个单元对应不同的相邻配置（边缘、角落、孤立等）。包含一个默认贴图 $AO/tile_mask.png（默认贴图）
轮廓	瓷砖轮廓颜色（alpha 为 0 = 无轮廓）。

多纹理多样性

每个图层可以具有多个带权重的纹理。瓷砖根据其网格坐标的哈希确定纹理变体，因此图案在保存后保持稳定，并且在添加/移除瓷砖时不会偏移。

调整 权重 在每个纹理旁的值以控制其相对于其它纹理出现的频率。

自动拼贴

瓷砖会基于其八方向邻居配置自动选择正确的掩码单元。系统会：

1. 检查所有 8 个邻居（N、NE、E、SE、S、SW、W、NW）。

2. 对角邻居仅在两个相邻的正交邻居都存在时才计数（防止角落处的视觉瑕疵）。

3. 将得到的 8 位邻接掩码映射到 8×8 掩码纹理中的 64 个单元之一。

这意味着你只需绘制瓷砖的存在——正确的边缘、角落和内部视觉效果会自动计算。

墙体图层

将图层的类型设置为 墙体 启用垂直挤出。墙体瓷砖像地面瓷砖一样放置在网格上，但每个已放置的瓷砖会生成一列向上延伸的主体瓷砖，高度为 墙体高度.

墙体属性

属性	说明
墙体高度	每个墙体列的瓷砖高度（最小值 2）。
顶部纹理	用于墙体顶行（“帽檐”）的单独纹理。
顶部掩码	墙顶的掩码纹理（使用与地面相同的 8 邻居自动拼贴）。
顶面轮廓	墙顶瓷砖的轮廓颜色。

墙体主体瓷砖使用图层的主纹理，并在每行的归属范围内计算单独的邻居掩码。墙顶则使用基底放置行的邻接情况，从而得到干净的帽檐边缘。

墙体按基底行进行 Y 排序，因此玩家会走到基底行以上的墙体后面，位于基底行以下的墙体前面。

墙体碰撞

属性	说明
碰撞	启用/禁用该墙体图层的物理碰撞生成。
内缩	将碰撞边缘从瓷砖边界向内收缩以获得更紧密的碰撞适配。
偏移	将所有碰撞边缘按固定量平移。
调试绘制	在场景视图中绘制绿色碰撞边缘以便调试。

当启用碰撞时，引擎会自动：

1. 沿暴露的瓷砖边界生成边段。

2. 合并共线边以最小化段数量。

3. 将连接的边分组为封闭形状。

4. 在运行时创建 Box2D 段形状（编辑器仅显示调试可视化）。

图章工具（复制与粘贴）

按下 S 切换到图章模式。这启用一个区域选择工作流程：

1. 选择: 点击并拖动以高亮矩形区域。选中的瓷砖会被复制到剪贴板。会弹出“已复制”提示以确认操作。

2. 粘贴: 按下 Ctrl+V 进入预览（幽灵）模式。剪贴板的半透明预览会跟随你的光标。

3. 旋转: 滚动鼠标滚轮以 90 度增量旋转幽灵预览。

4. 放置: 点击以图章粘贴瓷砖。点击时按住 Shift 可在不退出幽灵模式的情况下放置多个副本。

5. 取消: 按下 Esc（取消键） 以不放置退出幽灵模式。

按住 Ctrl 在开始图章选择时以同时从 所有图层 复制瓷砖，从而保留多层结构。

键盘快捷键摘要

快捷键	操作
B	切换到画笔工具
E	切换到橡皮擦工具
S	切换到图章工具
Shift （按住）	在画笔模式下临时擦除
[ / ]	减小 / 增大画笔大小
Ctrl+拖动	矩形填充（或与 Shift 一起为擦除）
Alt+点击	从上次点击绘制直线
Ctrl+V	进入粘贴/幽灵模式
滚轮	在幽灵模式下旋转幽灵预览
Shift+点击	放置多个副本（在幽灵模式下）
Esc（取消键）	取消幽灵模式