UD5工具箱
常见问题
什么是2D瓦片地图？
2D瓦片地图是一种将大地图分解为许多小尺寸图片（瓦片）来构建的地图技术。每个瓦片是一个固定大小的图片（如32x32像素），代表一种地形或物件类型。大量瓦片按照网格排列，拼接出完整的游戏场景地图。例如，一片森林地图可能由草地瓦片铺底、树木瓦片点缀、岩石瓦片作为障碍物。瓦片地图的核心思想是复用：同一类型的瓦片只需一张纹理图片，通过重复排列就能构建大面积的地图。这种技术内存占用低、渲染效率高、编辑方便，是2D游戏开发中最经典的地图构建方案。
JSON和CSV导出有什么区别？该用哪个？
JSON和CSV是两种不同的数据格式，各有特点。JSON格式是结构化的键值对数据，可以包含地图尺寸、图层信息、瓦片索引等完整的元数据，数据结构清晰，是大多数2D游戏引擎和框架（如Phaser、Unity、Cocos2d）推荐使用的格式。JSON格式的缺点是文件稍大、不易直接在电子表格中查看。CSV格式是纯文本表格数据，每行代表地图的一行，瓦片索引用逗号分隔。CSV格式简单直观，可以在Excel等电子表格软件中直接打开查看和编辑，方便进行数据分析和批量修改。推荐使用JSON格式用于游戏项目，CSV格式用于数据查看和编辑。
双图层系统是如何工作的？
编辑器的双图层系统将地图内容分为地面层（Ground Layer）和物体层（Object Layer）两个独立的图层。地面层用于绘制地图的基础地形，如草地、沙地、水域等；物体层用于放置地图上的物件，如树木、岩石等。两个图层独立存储和编辑，切换当前活动图层后，绘制操作只会影响该图层。在渲染时，地面层先绘制，物体层叠加在上方，形成有层次感的地图效果。在游戏引擎中，这种分层设计便于对不同图层应用不同的逻辑：例如地面层用于寻路计算，物体层用于碰撞检测。
绘制工具有哪些？如何切换？
编辑器提供4种核心绘制工具：画笔工具（Brush）用于逐格绘制瓦片，是最常用的工具；橡皮擦工具（Eraser）用于清除指定位置的瓦片；填充桶工具（Fill）用于快速填充一片连续的相同类型区域；吸管工具（Eyedropper）用于快速拾取当前位置的瓦片类型并自动切换到画笔模式。切换工具可以通过点击工具栏上的对应按钮，也可以使用快捷键快速切换。画笔工具是默认选择，适合精细绘制；填充桶适合大面积铺设；吸管适合快速复制已有瓦片；橡皮擦用于修正错误。
导出的JSON数据结构是什么样的？
导出的JSON地图数据通常包含以下结构：顶层对象包含地图的基本信息（width宽度、height高度，以瓦片数为单位）、瓦片尺寸（tileSize）、图层数据（layers数组）。每个图层对象包含图层名称（name）、图层类型（type，如ground或object）、以及二维数组形式的瓦片数据（data或tiles）。二维数组中每个元素是一个数字索引，对应瓦片类型（如0为空地、1为草地、2为墙壁等）。这种结构化的数据格式便于在游戏引擎中加载和解析，通过索引映射到对应的瓦片纹理即可渲染出完整的游戏地图。
如何调整地图尺寸？
地图尺寸的调整取决于编辑器提供的设置选项。通常在创建新地图时需要指定地图的宽度和高度（以瓦片数为单位），例如20x15表示20列15行的地图。如果编辑器支持地图尺寸调整功能，可以在地图属性面板中修改宽度和高度值。增大尺寸会在现有地图的右侧和下方扩展空白区域，减小尺寸会裁剪超出范围的地图内容。建议在开始绘制前就确定好地图尺寸，避免后期调整导致的重复劳动。在游戏引擎中使用地图时，确保JSON数据中的宽高值与游戏场景的大小相匹配。
编辑器支持移动端操作吗？
部分2D瓦片地图编辑器提供了触屏设备的支持，包括单指点击绘制、双指缩放画布、拖拽平移视图等手势操作。但由于瓦片地图编辑需要精确的网格定位操作，手机等小屏幕设备上的操作体验可能不够理想。建议在平板电脑或桌面电脑上使用编辑器以获得最佳的编辑体验。如果必须在移动端使用，较大的屏幕尺寸和触控笔等辅助工具可以帮助提升操作精度。编辑器的大部分功能（瓦片选择、工具切换、撤销重做等）通过触摸交互也能正常使用。