--- name: browser-game-builder description: Generate simple self-contained browser games as single HTML files and automatically deploy them to the Telegram Mini App games platform. Use when the user asks to build, create, or generate a browser game, mini-game, arcade game, or any playable game that runs in a web browser. Examples include Snake, Pong, Flappy Bird clones, Breakout, Tetris, memory card games, click-tap games, or any other simple 2D game concept. Always deploys automatically to CloudFront and updates the Telegram bot — no manual steps needed. --- # browser-game-builder Generate complete, playable browser games and deploy them live to the Telegram Mini App platform automatically. ## Infrastructure - **Games dir:** `/opt/openclaw/.openclaw/workspace/games/` - **S3 bucket:** `agent-cody-games-ACCOUNT_ID` (us-east-1) — replace ACCOUNT_ID with your AWS account - **CloudFront:** `https://YOUR_CLOUDFRONT_DOMAIN` (permanent, HTTPS) - **Bot:** `@YOUR_BOT_NAME` — token in `/run/openclaw/env` - **Upload script:** `/opt/openclaw/.openclaw/workspace/scripts/upload_games.py` - **Bot update script:** `/opt/openclaw/.openclaw/workspace/scripts/setup_botfather.py` ## Workflow — always follow this order 1. Write the game HTML to `/opt/openclaw/.openclaw/workspace/games/.html` 2. Update `/opt/openclaw/.openclaw/workspace/games/index.html` to include the new game card 3. Run `python3 /opt/openclaw/.openclaw/workspace/scripts/upload_games.py` 4. Run `python3 /opt/openclaw/.openclaw/workspace/scripts/setup_botfather.py` (updates menu button + sends game message to the principal) 5. Tell the principal the game is live with the direct URL ## Telegram auth (mandatory) Every game MUST include these two script tags in `` before any other scripts: ```html ``` And the entire game JS must be wrapped in the auth gate: ```js if (!TG_AUTH.init()) { /* blocked */ } else { // ... all game code here ... } // end TG_AUTH gate ``` `tg-auth.js` is already in the games dir and served from CloudFront. It: - Blocks non-Telegram access with a lock screen - Calls `tg.ready()` and `tg.expand()` - Exposes `window.TG_USER` and `window.TG_THEME` ## Output format Always produce **one `.html` file** with: - All CSS inlined in `