Skip to content

Forward+ and Mobile Renderers on the Web ​

Official Godot renders web exports with the Compatibility renderer only. 2dog also brings the Forward+ and Mobile renderers to the browser, through its experimental WebGPU driver.

RendererOn the webGraphics API
CompatibilityOfficial Godot and 2dog; the defaultWebGL
Mobile2dog onlyWebGPU
Forward+2dog onlyWebGPU

New template projects keep using Compatibility until you opt in. The showcase uses Forward+.

Browsers without WebGPU still fall back to Compatibility, so your game content must also work with that renderer.

Replace Compatibility on the web ​

Edit project.godot manually. In its [rendering] section, usually near the bottom of the file, set the web renderer to forward_plus or mobile:

ini
[rendering]

renderer/rendering_method.web="forward_plus"

The Godot Editor does not offer this web override in its renderer selector. The setting sticks unless you explicitly clear it in Project Settings.

During bundling, Forward+ and Mobile select WebGPU when the native payload includes it; other settings select WebGL. Use a single-precision browser payload. See WebGPU for threaded package support, host overrides, fallback behavior, and adapter limits.

Bake shaders before exporting ​

Enable shader baking in each web export preset. Browsers compile both the WASM and the shaders. Without baking, translating every Forward+ shader variant on the browser's main thread can take 5-10 minutes on first load and trigger an unresponsive-page prompt. Baking ships the translated shaders in the pack to reduce that work; GPU pipeline compilation still happens at runtime.

In export_presets.cfg, enable baking in the options section of each web preset. Replace 3 with the number of your web export preset, and repeat for any additional web presets:

ini
[preset.3.options]

shader_baker/enabled=true

Publishing then runs the headless export with a window-less rendering device (Vulkan, or Metal on macOS), so it needs a GPU or a software adapter such as lavapipe, but no display. Baked shaders make the pack larger, by about 18 MB compressed for a small Forward+ project.

Choosing between Forward+ and Mobile ​

Forward+ features depend on the adapter. On adapters that cannot run it, 2dog falls back to Mobile. See adapter and shader limits for that fallback and the restrictions on SDFGI, VoxelGI, depth of field, and SSIL.

2dog is Free and Libre Open Source under the MIT License.
2dog is not affiliated with or endorsed by the Godot Foundation.
Godot is licensed under the MIT License; the Godot logo is by Andrea Calabró under CC BY 4.0. @icons made by Voxy under the MIT License.
Continuous Integration compute graciously supported by Blacksmith.