Skip to content

Releases: MakeGamesPlay/unity-webgl-build-host

WebGL Build Host 1.3.0

Choose a tag to compare

@jaredbrandjes jaredbrandjes released this 14 Jun 04:48

WebGL Build Host 1.3.0

Housekeeping and polish. The main change: the host now shuts itself down when you close Unity, so a forgotten server and its Cloudflare tunnel don't run forever.

What's new

  • Self-terminating server. Shuts down (and stops cloudflared) about 10 minutes after Unity closes. Closing just the window keeps it running while Unity is open.
  • Open-after-build prompt. After a WebGL build with no host window open, it offers to open one and serve the build. Skipped in CI; "Don't ask again" is remembered per project.
  • Dockable window. Content scrolls above a pinned footer, with the log list sized to fill the window - docks cleanly into a short panel.
  • Footer version + build date. Shows which build you're running, for bug reports.
  • Clearer cloudflared help. The install command button is now Copy Command for Terminal, with a note to run it in a terminal.

Upgrade notes

Drop-in upgrade. Stop ▸ Start a running host once after updating so it extracts the new server binary.

Install

Requires Unity 2022.3 or newer. Pick one:

  • UPM Git URL (recommended): in Package Manager, choose Add package from git URL and paste https://github.com/MakeGamesPlay/unity-webgl-build-host.git (append #v1.3.0 to pin this version).
  • .unitypackage: download it from the Assets below and drag it into your project.
  • Source zip: download "Source code (zip)" below and drop the folder into your project's Packages/.

WebGL Build Host 1.2.0

Choose a tag to compare

@jaredbrandjes jaredbrandjes released this 03 Jun 03:43

WebGL Build Host 1.2.0

A reliability fix for phone testing over the Cloudflare quick-tunnel. The host now detects when a tunnel has silently died - usually after the machine sleeps or the network changes while cloudflared keeps running - and shows it as offline instead of a dead URL that still looks active.

What's new

  • Tunnel health monitoring. Once a public URL is up, the host probes it end-to-end every 15 seconds (via a new /__webhost/healthz endpoint) and marks the tunnel offline after two consecutive failures, or immediately if cloudflared exits. No more handing your phone a URL that quietly stopped working after your machine slept.
  • Honest tunnel status in the editor. The Public row now shows the tunnel as offline with a "Stop ▸ Start to reconnect" hint, instead of leaving a dead URL looking active. Quick tunnels can't recover the same URL, so a fresh Stop ▸ Start gets you a new one.

Upgrade notes

Drop-in upgrade. If the host is already running, Stop ▸ Start it once after updating so it extracts the new server binary.

Install

Requires Unity 2022.3 or newer. Pick one:

  • UPM Git URL (recommended): in Package Manager, choose Add package from git URL and paste https://github.com/MakeGamesPlay/unity-webgl-build-host.git (append #v1.2.0 to pin this version).
  • .unitypackage: download it from the Assets below and drag it into your project.
  • Source zip: download "Source code (zip)" below and drop the folder into your project's Packages/.

WebGL Build Host 1.1.0

Choose a tag to compare

@jaredbrandjes jaredbrandjes released this 25 May 14:06

WebGL Build Host 1.1.0

A quality-of-life update for day-to-day iteration. Development builds now reload on the
device without a manual cache clear, the per-device console clears and persists properly,
and you can save any device's log to a file.

What's new

  • No-cache for Development Builds. When the active build is a Development Build, files
    are served with Cache-Control: no-store, so reloading on the device always picks up your
    latest build - no more manual cache clears or hard refreshes. Release builds keep normal
    caching for speed.
  • Clear actually clears. The per-device Clear now wipes the server-side log buffer
    (not just the editor view) and resets the sequence, so the session immediately resumes
    streaming new lines from a clean slate.
  • Closed tabs stay closed. Device tabs you close no longer reappear after a domain
    reload or recompile.
  • Save logs to a file. A new Save button (next to Copy) writes the selected tab's
    full log to a text file.

Upgrade notes

Drop-in upgrade. If the host is already running, Stop ▸ Start it once after updating so it
extracts the new server binary.

Install

Requires Unity 2022.3 or newer. Pick one:

  • UPM Git URL (recommended): in Package Manager, choose Add package from git URL and paste
    https://github.com/MakeGamesPlay/unity-webgl-build-host.git (append #v1.1.0 to pin this version).
  • .unitypackage: download it from the Assets below and drag it into your project.
  • Source zip: download "Source code (zip)" below and drop the folder into your project's Packages/.

WebGL Build Host 1.0.0

Choose a tag to compare

@jaredbrandjes jaredbrandjes released this 21 May 15:00

WebGL Build Host 1.0.0

First release. Host a Unity WebGL/WebGPU build on any device on your network and read
each device's console live inside the Editor. No Python, Node, or other runtime required.

Highlights

  • Open the build on any device via QR code or copyable LAN URLs.
  • Live per-device console: each browser gets a tab streaming its console output and
    uncaught errors, with level filters, search, frame numbers, duplicate collapsing,
    multi-select copy, and per-device Reload / Identify / Copy bug report.
  • Self-signed HTTPS on your LAN (secure context for camera, WebXR, SharedArrayBuffer).
  • Optional public link via Cloudflare quick tunnel, with in-editor install help for cloudflared.
  • Sends the correct headers for Unity's compressed data and WebAssembly
    (Content-Encoding, application/wasm, COOP/COEP).
  • Runs as its own process and keeps serving across recompiles, builds, and Editor restarts.
  • Prebuilt native servers for Windows, macOS (arm64/amd64), and Linux, bundled in the package.

Install

Requires Unity 2022.3 or newer. Pick one:

  • UPM Git URL (recommended): in Package Manager, choose Add package from git URL and paste
    https://github.com/MakeGamesPlay/unity-webgl-build-host.git (append #v1.0.0 to pin this version).
  • .unitypackage: download it from the Assets below and drag it into your project.
  • Source zip: download "Source code (zip)" below and drop the folder into your project's Packages/.