Help & Troubleshooting

Use this guide when the game does not start, saves look wrong, or deployment setup is unclear.

Quick Start

• Open Play page and confirm build name (default: KBBQIdleWebGL).
• Click Check Build Files and verify data/framework/wasm are all detected.
• Click Start Game.
• Press F or click Fullscreen for immersive mode.

Cloudflare Pages Deployment

• Framework preset: None.
• Build command: leave empty if committing prebuilt docs/Build assets.
• Build output directory: docs.
• If build artifacts are missing, run ./tools/build_webgl_docs.sh then push.

Common Problems

• "Build check failed": verify that docs/Build contains .data, .framework.js, .wasm, and loader files.
• Black screen after load: hard refresh to clear stale cached build files.
• No ad shown: ad slot stays disabled until real AdSense client/slot values are configured.
• Save issue: clear browser site data and restart session if local save is corrupted.

Need Support?

Open an issue at GitHub Issues with browser/device, screenshot, and reproduction steps.