Godot Tiled导入器入门指南
从安装编辑插件、配置图块集到导入并运行Tiled地图,完整走通Godot与Tiled协作流程。
- 1
准备Tiled地图资源
在Tiled中新建地图,绘制图层并保存为.tmx文件;同时准备所用图块集,确保图片路径可正常读取。
- 2
安装导入器插件
克隆GitHub仓库或下载压缩包,将插件目录复制到Godot项目的addons文件夹,再在Godot编辑器中刷新文件列表。
- 3
启用Godot插件
打开“项目→项目设置→插件”,找到Godot Tiled Importer并启用。若插件未显示,检查目录结构及plugin.cfg是否完整。
- 4
配置导入选项
在插件设置中确认图块集、地图导入参数及目标目录;按项目规范设置缩放、碰撞和图层处理方式,必要时重新加载插件。
- 5
导入地图与图块集
在Tiled中保存地图后回到Godot,等待资源导入完成;随后将.tmx文件或图块集拖入场景,确认生成的对象与碰撞区域。
- 6
运行并检查地图
把导入的地图节点加入当前场景并运行,检查角色移动、碰撞、图层顺序与画面比例;修改源文件后保存并重新导入。
💡 实用技巧
- 使用相对路径,避免项目迁移后图块丢失
- 先制作小地图验证图块缩放设置
- 修改Tiled源文件后重新保存再导入
- 保留原始.tmx与图块集文件便于维护
⚠️ 常见坑
- 插件启用后无菜单,先检查plugin.cfg
- 图块显示异常多为缩放值或路径不一致
常见问题
Q:克隆后为什么找不到并启用插件?
确认插件目录已完整复制到项目的 addons 文件夹,并检查其中是否包含 plugin.cfg。回到 Godot 刷新文件列表,再打开“项目→项目设置→插件”查找 Godot Tiled Importer。
Q:导入后图块显示异常该怎么调整?
先检查 .tmx 文件与图块集素材的图片路径是否一致,再在插件设置中调整缩放参数。建议先导入一张小地图验证缩放效果,避免一次处理整张大地图。
Q:修改Tiled地图后游戏里没有变化怎么办?
在 Tiled 中修改图层或图块后,先保存源文件,再回到 Godot 等待资源导入完成。若仍未更新,可重新加载插件或重新导入该 .tmx 文件。