Skip to content

AI and agents

Asking for a change

Ask in the chat. Each turn lists its steps; open a step for its command, output or diff, and the turn ends with a receipt of the files it changed. Then press Play and judge the game.

Say what to change, and where

Name the node, script or file when you know it: "the Player node’s jump in player.gd is too floaty" is a change the agent can make and check. A precise request is built in that turn. An idea for something new gets a short brief first, which you approve before anything is built.

Ask Flockbay, on a node in the Scene dock, puts the selected node into the message box with its scene and script, for you to finish the sentence. You can also attach files and screenshots to a message, on a model that can see images.

Reading the turn

While a turn runs, the reply updates in place, and each tool call is a step row naming what it touched. Open a step for what was sent and what came back: the command and its output and exit code, or the diff of a file. A res:// path or an error line opens in your external editor at its line.

The turn ends with a receipt of every file it changed, each with its diff and Revert. How Flockbay’s agent works covers the receipt, Revert this turn and the permission modes.

A turn in the chat with its steps open: Edited run_timer.gd shows its diff, +14 −0, and Ran rooftops.tscn headless shows Godot’s Output with a SCRIPT ERROR line and exit 1.

Judging the result

The result is the game, not the message. Press Play (F5) and look. If it is wrong, say what you saw in the same chat: "the enemy walks through the wall at the top of the ramp" gives the agent something to find; "make it better" does not.

If a turn reports a change and the running game looks the same, the running game has not loaded it. Stop it (F8) and press Play again.

A turn’s receipt under its reply: Changed 2 files +58 −2 with Copy log, Review changes and Revert this turn, a Revert on each file, and the headless run’s parse error at res://ui/run_timer.gd:14 in red.

When a turn fails

A failed turn is titled by what stopped it, in one sentence, with the raw error and its code folded under Details. Copy details copies the sentence, the code and the details together, which is what to paste when you ask for help. Send logs… on the same card sends the app’s logs with that failure as the note.

AppImage, x86_64. Ubuntu 22.04, Debian 12, Fedora 39 or newer.

Intel or AMD Chromebook, with Linux turned on.

Download for macOSDownload for WindowsDownload for Linux

See also: AI game maker that writes the code.