quick-game

Performance Notes

• Take your time to do this thoroughly
• Quality is more important than speed
• Do not skip validation steps

Quick Game (Fast Prototype)

Build a playable game prototype as fast as possible. This is /viral-game without the polish — just scaffold + implement the core loop. Get something on screen, then incrementally add layers with /add-assets, /design-game, /add-audio, /game-deploy, and /monetize-game.

What you'll get:

1. A scaffolded game project with clean architecture
2. Core gameplay — input, movement, scoring, fail condition, restart
3. A running dev server you can play immediately

What you skip (run these later if you want):

• /add-assets — pixel art sprites (2D) or 3D models
• /design-game — visual polish, particles, transitions
• /add-audio — music and sound effects
• /record-promo — promo video capture
• /game-deploy — deploy to here.now
• /monetize-game — Play.fun integration

Instructions

Step 0: Parse arguments

Parse $ARGUMENTS to determine the game concept:

Direct specification: [2d|3d] [game-name]

• Engine: 2d (Phaser) or 3d (Three.js). If not specified, default to 2d.
• Name: kebab-case. If not specified, ask the user.

Tweet URL: If arguments contain a tweet URL (x.com/*/status/*, twitter.com/*/status/*, fxtwitter.com/*/status/*):

1. Fetch the tweet using the fetch-tweet skill
2. Default to 2D
3. Creatively abstract a game concept from the tweet
4. Generate a kebab-case name
5. Tell the user what you'll build

Meshy API Key (3D only): If 3D, check for MESHY_API_KEY. If missing, ask the user (link to https://app.meshy.ai). Store for model generation.

Step 1: Scaffold + Implement

Infrastructure (main thread):

1. Locate the template directory — check ~/.claude/plugins/cache/local-plugins/game-creator/*/templates/ or templates/ relative to this plugin
2. Target directory: If inside the game-creator repo, create in examples/<game-name>/. Otherwise, create in ./<game-name>/.
3. Copy the template:
   • 2D: templates/phaser-2d/ → target
   • 3D: templates/threejs-3d/ → target
4. Update package.json name and index.html title
5. Run npm install
6. Start the dev server (npm run dev) in the background. Check port availability first — if 3000 is taken, try 3001, 3002, etc.

Game implementation (subagent via Task):

Launch a Task subagent with:

You are building a quick game prototype. Speed is the priority — get a playable core loop working.

Project path: <project-dir> Engine: <2d|3d> Game concept: <description> Skill to load: phaser (2D) or threejs-game (3D)

Implement in this order:

1. Input (touch + keyboard from the start)
2. Player movement / core mechanic
3. Fail condition (death, collision, timer)
4. Scoring
5. Restart flow (GameState.reset() → clean slate)

Scope: 1 scene, 1 mechanic, 1 fail condition. Keep it tight.

Rules:

• All cross-module communication via EventBus
• All magic numbers in Constants.js
• No title screen — boot directly into gameplay
• No in-game score HUD — Play.fun widget handles score display
• Mobile-first input: touch + keyboard, use unified InputSystem pattern
• Import SAFE_ZONE from Constants.js — keep UI below SAFE_ZONE.TOP
• Minimum 7-8% canvas width for collectibles/hazards
• Character sizing: GAME.WIDTH * 0.12 to GAME.WIDTH * 0.15 for character-driven games
• Preserve the template's createButton() helper in GameOverScene — do NOT rewrite it
• Wire spectacle events: SPECTACLE_ENTRANCE, SPECTACLE_ACTION, SPECTACLE_HIT, SPECTACLE_COMBO, SPECTACLE_STREAK, SPECTACLE_NEAR_MISS
• Add isMuted to GameState for future audio support
• Ensure restart is clean — 3 restarts in a row should work identically

Step 2: Verify

After the subagent returns:

1. Run npm run build in the project directory to confirm no errors
2. If the build fails, fix the issues (up to 2 retries)
3. If Playwright MCP is available, navigate to the dev server, take a screenshot, and do a quick visual check

Example Usage

2D game

/quick-game 2d asteroid-dodge

Result: Copies Phaser template → implements player ship, asteroid spawning, collision death, score counter, restart flow → dev server running at localhost:3000 in ~2 minutes. Shapes only, no polish.

From tweet

/quick-game https://x.com/user/status/123456

Result: Fetches tweet → abstracts game concept → scaffolds and implements a playable prototype inspired by the tweet content.

Troubleshooting

Game scaffolds but won't start

Cause: Vite config or import paths incorrect. Fix: Verify vite.config.js has correct root. Check that main.js is referenced in index.html.

Missing core files

Cause: Scaffold skipped EventBus/GameState/Constants. Fix: Every game needs core/EventBus.js, core/GameState.js, core/Constants.js. Re-run scaffold or create manually.

Done

Tell the user:

Your game is running at http://localhost:<port>. Open it in a browser to play!

To keep building, run these commands:

• /add-assets — replace shapes with pixel art sprites
• /design-game — add visual polish (particles, gradients, juice)
• /add-audio — add music and sound effects
• /game-deploy — deploy to the web
• /monetize-game — add Play.fun integration

Or run /viral-game next time for the full one-shot pipeline (assets, polish, deploy, monetize all in one go).