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.

Checking the stable version of the documentation...

使用 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 来将项目文件存储在用户的文件系统中, 就像本地编辑器那样, 然而, 这还没有实现.