OhMyGame Studio
OhMyGame is a desktop app for making games. Its tools reach you through the
ohmygame-studio MCP server. You keep writing code with your own tools;
OhMyGame adds what you cannot do alone: media generation with the person's
providers, its canvas, and playing the game like a player.
Choose the project
Every tool except list_projects and open_project works on one OhMyGame
project.
- Working inside a project's folder selects it. Call
get_projectto confirm the project, its type and its workspace folder. - Otherwise call
list_projects, thenopen_projectwith an ID or folder. - If a tool says OhMyGame is turned off or could not be started, tell the person to open OhMyGame and turn on Settings → MCP Server → Allow other agents to use OhMyGame. Do not retry in a loop.
Generate assets
Use generate_image, generate_video, generate_3d_asset,
animate_3d_asset and generate_audio. Each call uses the person's provider
credits, so:
- Write one specific prompt and generate once; do not try variations unless asked.
- Start 3D from an approved image:
generate_imagefirst, thengenerate_3d_assetwithimagePath, thenanimate_3d_assetfor rigged characters. - Results name the saved file's workspace-relative path. Read the file with your own tools to check it before using it in the game.
generate_audiomakes speech, sound effects and music. Setkindand OhMyGame picks a model that makes it, or pick amodelyourself. For a text-to-speech model the prompt is the exact line to speak; otherwise it describes the sound. Some models mix dialogue, ambience and music from one prompt. A model that setsrequiresVoiceneeds a voice from its provider. Keep the returned audio JSON companion beside the audio in the project.
Generation can take minutes. A tool that is not done within about 45 seconds
returns a job ID: call wait_job with it until the job finishes. Never start
the same generation again while its job runs. get_job checks without
waiting; cancel_job stops a job the person no longer wants.
Canvas
Projects keep design docs, concept art and assets on a canvas under
canvas/. If you change files there, run canvas_check and fix what it
reports. canvas_initialize creates the canvas in a project without one.
generate_canvas_media generates into an existing canvas node.
Playtest
game_use opens the game in OhMyGame's player window, acts as a player and
captures screenshots. Use it after changing gameplay: a successful build is
not a playtest.
openreturns a session ID and the first state.actwith a batch of input and wait steps; it returns the new state.capturefor screenshots of canvas or WebGL games.closethe session when finished.
A game a plugin runs outside OhMyGame, such as a TapTap Maker project, may
only offer captureFrame: it runs the game again from its start and captures
the frame you name. Pick a frame after the game has loaded, and a later one
when the capture is blank or still loading.
It needs the OhMyGame desktop app and a project with a game preview.
Interactive Story projects
Use playable_add_node to add a screen and playable_check after changes;
use mode publish before the person publishes.
What stays with you
Edit code and files, run commands, plan, and ask the person questions with your own tools. OhMyGame cannot undo changes you make outside its tools, so keep the project in version control.