Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

使用 Web 编辑器

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

备注

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

浏览器支持

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

  • Chrome 68 或更高版本

  • Firefox 79 或更高版本

  • Edge 79 或更高版本

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

目前不支持移动浏览器。

The web editor only supports the Compatibility rendering method, as there is no stable way to run Vulkan applications on the web yet.

备注

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

限制

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

  • 不支持 C#/Mono。

  • No GDExtension support.

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

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

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

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

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

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

  • 不支持 Android 一键部署。

参见

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

导入项目

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

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

  • Run the editor by clicking Start Godot editor. The Godot Project Manager should appear after 10-20 seconds. On slower machines or connections, loading may take up to a minute.

  • 在窗口中间出现的对话框中,为要创建的文件夹指定一个名称,然后单击创建文件夹按钮(不必与 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 来将项目文件存储在用户的文件系统中, 就像本地编辑器那样, 然而, 这还没有实现.