AI Game Dev
Home › Tutorials

A Godot game with Claude Code in three prompts (and do you need MCP?)

Claude Code built a small Godot game with a player, walls, a coin and a score, and tested it itself. Here are the prompts, and whether a Godot MCP server is worth it.

Tested with Godot 4.7.2 · Coding-Solo godot-mcp 0.1.1 · Claude Code 2.1.296

A frame from the finished Godot game. The blue player square stands to the right of a brown block just after picking up a coin, the score in the top-left corner reads 1, and the yellow coin has jumped to the lower middle. Grey walls frame the screen.

Before you start

  • Godot 4. Download it from godotengine.org. We used 4.7.2 on a Mac.
  • Claude Code. Follow the Claude Code install steps.
  • An empty Godot project folder, which is any folder with a project.godot file in it.
  • Optional: a Godot MCP server. We used godot-mcp. You can skip it; see below.
What we asked“Using the Godot tools, make a small 2D scene: a player you can move with the arrow keys and a few walls. Then run it and tell me if it works.”

What happened

You
Using the Godot tools, make a small 2D scene: a player you can move with the arrow keys and a few walls. Then run it and tell me if it works.
  • Created the scene and added the player with the Godot tools
  • Wrote the player script, the walls and a middle block into the scene file
  • Ran the game with the Godot tools: no errors
  • Tested it headless, holding each arrow key
Claude
Yes, it works. The scene opens with no errors, the arrow keys move the player, and the walls stop it. The player is a blue square that moves at 250 px/s. Holding each arrow key, it stopped right against the wall or the brown block it ran into. One catch: the Godot tools said they added the player but dropped its position, so I wrote the rest of the scene file by hand.
You
Add a coin the player can collect, with a score shown on screen.
  • Wrote the coin and score scripts
  • Added the coin and score text to the scene file
  • Ran the game with the Godot tools: no errors
  • Ran pickup tests: the score went to 3, then 5
Claude
The coin and score work. Touching the coin adds 1 to the score in the top-left corner, and the coin moves to a new random spot inside the walls, never on the middle block. A test that steered the player with the arrow keys collected 3 coins, and the label read "Score: 3".
You
I can't see the game from here. Can you take a screenshot of it running and save it in the project as screenshot.png?
  • Ran the game with a small capture script (the Godot tools can't take screenshots)
  • Saved screenshot.png and looked at it
Claude
I saved screenshot.png. It shows "Score: 0" in the top-left corner, the blue player on the left, the gold coin in the top right, the brown block in the middle and the grey walls. The walls are hard to see against Godot's dark-grey background; I can make them stand out if you like.

Three plain sentences gave us a working game, and Claude tested it itself. Godot’s scene and script files are plain text, so Claude Code can write them, run the game with the godot command, and read the errors without you clicking anything. We recorded it with a clean Claude Code (no personal skills or plugins).

Do you need a Godot MCP server?

No. An MCP server gives Claude extra buttons, like “create a scene” or “run the game”. We tried the community godot-mcp server. Its best part is running the game and bringing the errors back. Its scene tools were weaker: adding the player said it worked but dropped its position, so Claude wrote the scene file directly. It also can’t press keys or take screenshots, so Claude used small test scripts for those. Start without it, and add it later if you want to watch the game window open as Claude works.

Check the scene file

After any change, ask Claude to “check the scene file”. This catches most silent mistakes.

Next, if you are new to engines: choose your tools.

Was this useful?

More like this