Skip to content
Developer Docs

Godot Web Quickstart

Export, test, add SDK features, package, and upload a Godot Web game.

Summary: Building for Buncha Games

  • Get set up: request or activate developer access, then choose Developer Dashboard upload or create a Buncha Games CLI token if you are using CLI.
  • Add the Buncha Games Godot SDK when you want player identity, analytics, Buncha Credits, wallet/IAP, entitlements, ads, or sandbox test flows. Deployment can proceed without SDK hooks.
  • Export a Godot Web build folder, not the Godot project folder. Prefer non-threaded exports unless your build specifically needs threaded runtime support.
  • Prepare listing media and metadata: title, descriptions, controls, thumbnail, hero image, screenshots or video, and any connected services.
  • Upload the ZIP through the Developer Dashboard or Buncha Games CLI after index.html, .js, .wasm, .pck, and generated assets are at the ZIP root.
  • Manage the game after upload: preview Sandbox, fix validation issues, update media/info, submit for review, and check analytics after the game is live.

What to package

  • Keep index.html, .js, .wasm, .pck, audio worklet files, and generated compressed files together.
  • Do not upload the full Godot source project, editor config, private keys, or unrelated folders.
  • Keep the ZIP under 200 MB and verify the game loads from a static server.
Good Godot ZIP shape:
my-godot-game.zip
  index.html
  index.js
  index.wasm
  index.pck
  index.audio.worklet.js
  index.worker.js
  *.br or *.gz if Godot generated compressed files

Godot export steps

  • Install Godot export templates if the editor prompts you.
  • Open Project > Export, add a Web preset, and set the export path to an empty folder with an index.html filename.
  • Use Export Project to create the playable web export. Do not use Export PCK/ZIP for Buncha Games uploads; that is not a playable browser export by itself.
  • Test the exported files over HTTP before upload.
  • For Godot 4, prefer the Compatibility renderer for broad WebGL 2 browser support unless your game has already validated another renderer.
  • Godot 4 C#/.NET projects cannot currently export to Web; use GDScript or a Godot version/workflow that supports your target.
  • Threaded web exports may require cross-origin isolation. Prefer non-threaded exports for the first Buncha Games upload unless you have already confirmed the build needs threads.
  • Common Godot Web failures are wrong ZIP root, missing .pck, missing .wasm, MIME/header issues, audio waiting for a click, and fullscreen or pointer lock needing a user gesture.

SDK install

Add the Godot SDK when your game needs Buncha Games account-aware features or in-game monetization flows. Deployment can proceed without SDK hooks.

Godot addon ZIP:
https://bunchagames.com/sdk/downloads/buncha-games-godot-sdk-0.1.0.zip

Copy addons/buncha_games_sdk into your project.
Enable Buncha Games SDK in Project Settings > Plugins.

Upload choices

  • Doing it yourself: export a Godot Web build, test it locally, ZIP the export contents, then upload through the Developer Dashboard.
  • Using repeatable commands: use /developers/docs/cli after your exported ZIP and listing media are ready.
  • Using an AI coding agent: start from /developers/docs with the AI workflow selected so you get the right prompt library.

Godot agent prompt

You are preparing my Godot Web game for Buncha Games.

Read:
- https://bunchagames.com/developers/docs/godot-web-quickstart
- https://bunchagames.com/developers/docs/uploading-games
- https://bunchagames.com/developers/docs/sdk

Tasks:
- Inspect this repo and confirm whether a Godot Web export already exists.
- If no export exists, tell me exactly how to export for Web from Godot. Do not package the Godot source project.
- If an export exists, test the exported folder from a local static server.
- Create a ZIP from the export contents so index.html, .js, .wasm, .pck, and generated assets are at the ZIP root.
- Exclude source project folders, .godot caches, .env files, secrets, editor files, and unrelated files.
- If I ask for SDK integration, use the Buncha Games Godot addon ZIP and keep SDK calls fail-soft.

Return the export folder, ZIP path, top-level ZIP tree, local smoke result, and any blockers.