Guide

Building AI games

Black Whole includes a dedicated games builder alongside the AI website builder and chat assistant. You can design, playtest, iterate, and publish playable browser games using plain text prompts.

From concept to a playable game — Creating and refining a game inside the workspace

Starting a game

The games hub lives at /agent/games. You start every new game from this hub. When you start a build, a short concept wizard called GamePlanWizard asks a few questions about your concept before generation begins.

Open the games hub

Navigate to /agent/games to browse existing titles or begin a new build.

Answer the GamePlanWizard

Provide brief responses about mechanics, controls, and visual tone to shape the initial plan.

Review and playtest

The agent writes the project files and loads the playable result directly in your preview.

How game building works

Building a game works like building a website: the agent plans, writes the code, verifies it runs, and you can iterate by describing changes. Every game gets a generated thumbnail used as its cover art.

GamePlanWizard

A brief concept wizard that clarifies mechanics and goals before code is written.

GameSwitcher

Switch between games and website projects at any time within the workspace.

Sandboxed runtime

Games run in a sandboxed iframe, so a game cannot touch the rest of the site.

Cover art

Every game receives an automatically generated thumbnail for cover display.

Public play pages

Published games get a public play page at /play/<gameId>. Anyone can play a published game with no account needed. Drafts remain visible only to the owner.

Feature	Details
Public access	Anyone can open and play a published game page without registering or signing in.
Play counter	Track total plays on the page. A play is counted when the player actually starts the game.
Call to action	Play pages include a 'build your own game' prompt encouraging visitors to create their own.

Code ownership and iteration

A game is a real web project: it is code you own, it can be edited, and it publishes the same way a site does. You can ask the agent to tweak difficulty, add scoreboards, or change visual assets at any time.

Full code flexibility

Because game projects consist of standard web code, you keep complete ownership of the source files and can publish or expand them whenever you wish. See Publishing and GitHub.

Note on safety

The sandboxed iframe environment ensures all game scripts execute in isolation without accessing sensitive storage or session state from the main application.