EditorExportPlatformWeb in Godot – Complete Guide

Embarking on the journey of game development is an exciting quest filled with creativity, engineering, and endless possibility. Within this journey lies the power of tools like Godot Engine, a versatile and accessible game engine that empowers developers to bring their visions to life. Today, we’re diving into a feature that puts the cherry on top of your game development efforts: exporting your creation to the web. With the rise of online gaming, understanding how to deliver your projects directly to players through their browsers is not only valuable but essential. That’s where the magic of Godot’s EditorExportPlatformWeb class enters the scene.

What is EditorExportPlatformWeb?

The EditorExportPlatformWeb class in Godot 4 is a conduit between your Godot projects and the web. This class belongs to the powerful suite of Godot’s export tools, which enable developers to package and deploy their games across various platforms.

What is it for?

Specifically, EditorExportPlatformWeb provides the functionality needed to export games as web-ready packages. This means you can turn your Godot creations into playable experiences on web browsers, reaching players around the globe with nothing more than a link.

Why should I learn it?

Learning to effectively use the EditorExportPlatformWeb can immensely broaden your game’s audience and simplify the distribution process. By mastering web exports, you unlock the potential to rapidly share prototypes, conduct playtests, and even release full titles. Moreover, knowing the ins and outs of this class means you can customize your exports to ensure the best performance and user experience possible on the web. Let’s explore this feature and discover how Godot 4 can help your games take the leap from your development environment to the worldwide stage of the internet.

CTA Small Image

Setting Up the Export Templates

Before we dive into writing code, we need to ensure that we have the export templates set up in Godot. These templates are required to create the final game package that can run in the web browser.

Editor > Manage Export Templates

Here, make sure you download and install the web export templates for your version of Godot. Once this is done, you’re ready to proceed with configuring your project for web export.

Configuring Your Project for Web Export

To begin the process of exporting your game to the web, you first need to set up an export preset specifically for the web.

Project > Export > Add...

Select `HTML5` from the list of available platforms. This will create a new preset for the HTML5 web platform. Within this preset, you can define specific parameters for your game’s web export.

Essential Export Settings

Customizing your export settings is crucial for optimal game performance and compatibility with various web browsers.


<canvas> id="canvas"</canvas>


You will notice settings such as:

– **Handheld mode**: Define whether the game should consider mobile optimizations.
– **Executable Name**: Define the main Javascript filename for your game.
– **HTML/Shell**: Adjust the HTML page your game is embedded in.

Let’s configure our preset to optimize for desktop browsers:

Handheld Mode: Off
Executable Name: my_game
HTML/Shell: default

Once you’ve adjusted these settings to match your game’s needs, your game is nearly ready for the web.

Customizing the HTML Shell

To make our game stand out, we can modify the default HTML shell to include custom styling or additional features like branding.


<!DOCTYPE html>
<html lang="en">
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>My Awesome Game</title>
  <!-- Add custom styles or scripts here -->
  <canvas id="canvas"></canvas>
  <!-- Add more elements like divs for UI elements if needed -->


Apply these changes by exporting your HTML/Shell to a custom HTML file, then point the export preset to use this file instead of the default shell.

HTML/Shell: path/to/custom_shell.html

Exporting Your Game

With all the export settings configured, we are now ready to export the game. Click on the “Export Project” button and choose a location to save the exported files. Remember to give the package a descriptive name, making it easier to identify among other exports:

Export Project > Select "HTML5" > Export Project > Save As: MyAwesomeGame.html

Your game is now packaged and ready to be hosted on a website or played locally for testing. Remember that for security reasons, you may not be able to run your game locally due to browser restrictions on file:// URLs, so it’s often best to test on a local or remote server.

In the next section, we will discuss more advanced topics, such as optimizing loading times and managing asset exports for the web. Stay tuned as we help ensure your game makes a grand entrance to the world wide web with Godot 4.Optimizing your game for web export not only enhances the player experience but can also significantly reduce loading times. The key is to effectively manage your assets and leverage Godot’s tools to ensure a smooth performance. Let’s explore some techniques and code examples to optimize our game export.

Optimizing Loading Times

One aspect of optimizing loading times is to reduce the size of your game package. This can be done by compressing assets and using more efficient formats. We also need to ensure that we only export the necessary resources. Here’s how to mark resources for export:

var resource = preload("res://my_resource.png")
resource.exported = true

In the export preset settings, you can choose to export only selected resources:

Export Project > Resources > Export Mode: Selected Resources

Another approach is to split your game into multiple PCK files, which allows splitting the load between initial and periodic content downloads. You can create a PCK file using the following command in Godot:

var packer = PCKPacker.new()
packer.add_resource("res://scene.tscn", "res://scene.tscn")

And then, to load this content dynamically in your game:


Handling Assets for Web Export

For web exports, it’s important to manage how assets are loaded and handled during gameplay. Streamlining asset loading can reduce performance hits and improve user experience. Let’s look at asynchronously loading an image to be used as a texture:

var image = Image.new()
var texture = ImageTexture.new()


This ensures assets are loaded without halting the game, providing a smoother experience for players.

When dealing with many assets, you may consider using ResourceInteractiveLoader to manage loading progress:

var loader = ResourceLoader.load_interactive("res://big_scene.tscn")
while not loader.poll():
    print("Loading: ", loader.get_stage(), " / ", loader.get_stage_count())
var resource = loader.get_resource()

This code piece allows you to display a custom loading bar or screen based on actual loading progress.

Optimizing Game Scripts

Beyond asset management, optimizing game logic and scripts can have a significant impact on the performance. Profiling and identifying bottlenecks are essential steps. Take this example of a function optimized to decrease its complexity:

Before optimization:

for entity in entities:
    for other in entities:
        if entity.collides_with(other):

After optimization by eliminating unnecessary nested loop calculations:

for entity in entities:
    var collisions = get_colliding_entities(entity)
    for other in collisions:

Using methods like `get_colliding_entities`, which would ideally employ spatial partitioning, can reduce the total number of calculations and checks your game needs to perform every frame. This leads to increased performance, especially in complex scenes or with a large number of objects.

Next Steps

Remember that exporting to the web with Godot is an iterative process. Keep testing your game under different network conditions and on various browsers. Use the feedback from these tests to continually optimize and refine your game’s performance.

Finally, don’t forget to consult the comprehensive Godot documentation for advanced tips and tricks specific to HTML5 exports. With persistence and the right optimizations, your game will offer an enjoyable and smooth experience to players regardless of where they are playing from. With Godot and the web, the sky’s the limit!Expanding on our optimization strategies, let’s delve deeper into code examples that can help refine and elevate the web export experience of your Godot games.

Optimizing Network Usage

When dealing with online games, optimizing network usage is paramount. Efficient network communication ensures that your game remains responsive, even with slower internet connections. Here’s an example of how you can send compressed game state updates to reduce bandwidth usage:

var data_to_send = {'position': player.global_position, 'health': player.health}
var compressed_data = Marshalls.utf8_to_base64(JSON.print(data_to_send))

Minimizing Memory Allocation

Memory allocation can be a common source of performance issues. In Godot, you can often reuse objects rather than creating new ones on the fly. Here’s an example of reusing a Vector2 object instead of creating a new one every frame, to minimize memory allocation:

var temp_vector = Vector2()

func _process(delta):
    temp_vector.x = randf() * get_viewport_rect().size.x
    temp_vector.y = randf() * get_viewport_rect().size.y
    my_sprite.position = temp_vector

Optimizing Physics Calculations

Physics can be costly, so limiting the number of active physics bodies can improve the performance of your web export. Here’s how you could deactivate a physics body when it’s not needed:

func deactivate_physics_body(body: RigidBody2D):
    body.mode = RigidBody2D.MODE_STATIC  # or RigidBody2D.MODE_KINEMATIC for player-controlled bodies

func activate_physics_body(body: RigidBody2D):
    body.mode = RigidBody2D.MODE_RIGID

Using Web-Specific GDScript Features

Godot 4 includes GDScript features that are particularly handy for web target. As an example, calling JavaScript functions from within GDScript can offer opportunities to integrate with web APIs or perform other web-specific tasks:

var js_code = "console.log('Hello from Godot!')"

And if you want to receive a callback in GDScript from JavaScript:

JavaScript.create_callback(self, "my_gdscript_callback")

func my_gdscript_callback(result):
    print("Callback from JavaScript with result: ", result)

Dynamic Asset Loading

To further fine-tune your game’s loading performance, consider leveraging dynamic loading for large assets. This will reduce the initial load time, improving the ‘time to first play’. Here’s how to dynamically load a scene when needed:

var scene_path = "res://levels/level2.tscn"
var loaded_scene = null

func load_scene():
    loaded_scene = load(scene_path)  # Synchronous loading

func _on_button_pressed():
    if loaded_scene:
        var instance = loaded_scene.instance()

For asynchronous loading, you can use `ResourceLoader.load_interactive()` as mentioned before, which allows showing loading progress.

By implementing these optimization strategies and understanding the intricacies of web exports, you’ll be equipping yourself with the knowledge to make your Godot games not only functional but also well-adapted to the web environment. In essence, these techniques bridge the gap between a game that plays well locally and one that shines on any browser, keeping players engaged and eager for more of what you have to offer.

Continue Your Game Development Journey

Embarking on the path of game development with Godot is an ongoing quest filled with opportunities for growth and exploration. Even as you’ve learned to export your Godot projects to the web, remember that there’s a vast spectrum of game development skills waiting for you to master them. We at Zenva know the importance of continued learning, and we’re here to support your journey every step of the way.

If you’re eager to expand your knowledge further, our Godot Game Development Mini-Degree offers a wealth of information that covers a variety of essential topics. From the fundamentals of using assets and the GDScript programming language to the intricacies of UI systems, RPG mechanics, and more – this Mini-Degree is designed to elevate you from a beginner to a confident game developer.

For those looking for a broader selection of content, our array of Godot courses covers an extensive range of areas in game development. Take advantage of the flexibility to learn at your own pace, and before you know it, you’ll be crafting games that captivate and engage players across the globe. So why wait? Dive into our courses today and continue shaping your future in game development!


In our journey through the intricacies of exporting Godot games to the web, it becomes clear how mastering this skill can elevate your development game to new heights. As creators, our aim is to share our digital dreams with as wide an audience as possible, and web exporting is a key that unlocks this potential. With Godot, the power to craft cross-platform experiences that resonate with players far and wide is right at your fingertips.

As you continue to hone your craft and aspire to take your game development to the next level, we at Zenva are your steadfast allies. By learning with our Godot Game Development Mini-Degree, you’re not just investing in skills – you’re unlocking a community of education and support tailored to drive your passion forward. Forge the path of your game development adventure with us, and let’s bring your visionary games to life, together.

Python Blog Image

FINAL DAYS: Unlock coding courses in Unity, Godot, Unreal, Python and more.