使用 Web 编辑器

从 Godot 3.3 开始，你可以用 Web 编辑器来处理新的或现有的项目。

备注

Web 编辑器处于初级阶段。虽然其功能集可能足以满足教学目的，但目前不建议用于生产工作。见下文 限制。

浏览器支持

Web 编辑器需要支持 WebAssembly 的 SharedArrayBuffer。这也是支持浏览器中做多线程的必要条件。以下桌面浏览器支持 WebAssembly 多线程，因此可以运行 Web 编辑器：

  • Chrome 68 或更高版本

  • Firefox 79 或更高版本

  • Edge 79 或更高版本

目前还不支持 Opera 和 Safari。一旦加入适当的线程支持，Safari 可能会在未来支持。

目前不支持移动浏览器。

由于浏览器支持兼容性的渲染方法，所以目前没有办法再浏览器中使用 Vulkan 渲染器。

备注

如果你使用的是 Linux，由于 Firefox 的 WebGL 性能较差，建议使用基于 Chromium 的浏览器而不是 Firefox。

限制

由于受到 Godot 或 Web 平台端的限制，目前缺少以下特性：

  • 不支持 C#/Mono。

  • 不支持 GDExtension。

  • 没有调试支持。这意味着 GDScript 调试/分析、场景编辑、远程场景树栏目和其他依赖调试器支持功能将无法工作。

  • 没有项目导出。作为变通，你可以使用项目 > 工具 > 下载项目源文件, 然后使用原生版本的 Godot 编辑器导出。

  • 当关闭带有未保存更改的选项卡时，编辑器不会警告你。

  • 不支持光照贴图烘焙。你仍然可以使用现有的光照贴图，如果它们是用原生版本的 Godot 编辑器烘焙的（例如，通过导入现有的项目）。

由于 Web 平台的固有局限，不太可能支持以下特性：

  • 不支持外部脚本编辑器。

  • 不支持 Android 一键部署。

参见

参见 GitHub 上与 Web 编辑器相关的公开问题列表了解已知的 Bug 列表。

导入项目

要导入一个现有的项目, 目前的流程如下:

  • 使用 Preload project ZIP [预载项目ZIP]输入指定一个ZIP文件以预载到HTML5文件系统.

  • 点击 Start Godot editor [启动Godot编辑器]来运行编辑器。一段时间后应出现 Godot 项目管理器。

  • 在窗口中间出现的对话框中，为要创建的文件夹指定一个名称，然后单击创建文件夹按钮（不必与 ZIP 存档的名称相一致）。

  • 点击安装并编辑，项目将在编辑器中打开。

注意

将项目文件夹放在 /home/web_user/ 中很重要. 如果你的项目文件夹放在 /home/web_user/ 之外, 当你关闭编辑器时, 将失去项目!

当你按照上述步骤操作时, 项目文件夹将始终位于 /home/web_user/projects 中, 以保证其安全.

编辑和运行一个项目

与原生版本的Godot不同,web编辑器只限于一个窗口. 因此, 当运行项目时, 它不能打开一个新窗口. 当你通过点击运行按钮或按 F5 运行项目时, 它将出现 “替换” 编辑器窗口.

web编辑器提供了另一种处理编辑器和游戏窗口的方式(现在是 “选项卡” ). 你可以使用顶部的按钮在 编辑器 和 游戏 选项卡之间切换. 你也可以通过点击这些选项卡旁边的 × 按钮来关闭正在运行的游戏或编辑器.

我的项目文件在哪里？

由于浏览器的安全限制, 编辑器会将项目文件保存到浏览器的IndexedDB存储中. 这个存储在你的机器上并不能以普通文件夹的形式访问, 而是被抽象在数据库中.

你可以通过项目 > 工具 > Download Project Source，将项目文件下载为 ZIP 档案。这可以用来使用原生 Godot 编辑器导出项目，因为还不支持从 Web 编辑器导出。

将来可能会使用 HTML5 FileSystem API 来将项目文件存储在用户的文件系统中, 就像本地编辑器那样, 然而, 这还没有实现.