Diagnostic Symptom Matrix
Find your exact symptom in the table below to access the verified step-by-step resolution:
| Symptom Observed | Root Cause | Severity | Action Guide |
|---|---|---|---|
| #gpu-warning text displayed | WebGPU API unavailable or browser hardware acceleration disabled. | Blocking | WebGPU Fix Guide → |
| Black canvas with no audio/video | WASM initialization crash, GPU adapter panic, or canvas focus lock. | Blocking | Black Screen Fix Guide → |
| "Too many people are playing!!!" | Official Cloudflare Worker exceeded daily HTTP request quota. | Intermittent | HTTP 429 Workaround → |
| Severe FPS stutter & frame drops | Compiling 2,000 shader variants simultaneously on startup. | Degraded | FPS Optimization Guide → |
| "Fake website detected!" message | Game opened inside an unauthorized third-party iframe frame. | Blocking | Where to Play Guide → |
Universal 60-Second Recovery Checklist
Before troubleshooting specific graphics settings, run through these universal browser health checks:
- Hard Refresh the Browser: Cloudflare caches JavaScript assets for up to 4 hours. If developer Aethus pushes a new WebAssembly binary, a cached old
wenilla.jsrunning against a newwenilla_bg.wasmwill throw "Import requires a callable" and crash. Press Ctrl+Shift+R (Windows/Linux) or Cmd+Shift+R (Mac) to bypass stale caches. - Verify Browser Compatibility: Ensure you are running Google Chrome (version 113+), Microsoft Edge (version 113+), or Safari (macOS Sonoma / iOS 17+). Legacy browsers like Firefox (without nightly WebGPU flags) and older Opera builds will fail to boot the WebGPU pipeline.
- Check Hardware Acceleration: In Google Chrome or Microsoft Edge, enter
chrome://settings/systemoredge://settings/systeminto the address bar. Ensure the toggle for "Use graphics acceleration when available" is enabled, then restart the browser completely. - Click the Canvas to Resume Audio: Modern browsers automatically suspend Web Audio contexts until an explicit user gesture is registered. If the game appears to be running but has no sound, click once directly inside the game window to awaken the mixer.
Dedicated Error Breakdown Sub-Guides
1. WebGPU Error (#gpu-warning)
Detailed walkthrough for dual-GPU laptops, forcing dedicated NVIDIA/AMD GPUs, and enabling the Linux Chrome flag #enable-unsafe-webgpu.
2. Black Screen & Canvas Crash
Fixes for 15MB brotli WASM download stalls, navigator.gpu.requestAdapter() rejections, and canvas focus locks.
3. HTTP 429 Worker Rate Limit
Why the official Cloudflare Worker hits daily request limits, why it self-heals, and how to continue playing via the Windows client.
Read HTTP 429 Guide →4. Lag, Stutter & Low FPS
Official low-overhead launch flags (?pbr_lite=1, ?pipe_warm=0, ?farclip=200) to double frame rates on budget PCs.