Reference
Troubleshooting and support
Start with Help: Report a bug on Discord, and Send logs to Flockbay… with the failure attached. Every failure card has Copy details. The rest of this page covers the failures people meet most.
Get help
Help, in the app’s ≡ menu and under ⋯, has Keyboard shortcuts and Documentation; Report a bug on Discord, which copies the app’s version and the last error and opens Discord, Send feedback…, Send logs to Flockbay… and Open logs folder; and About Flockbay, which lists the version, commit, Godot, WebView2 and OS with Copy.
A failure card in the chat has Copy details, which copies the sentence, its error code and the raw output folded under Details, and Send logs…, which sends the logs with that failure as the note. Paste the details when you ask for help: the code identifies the failure.
Logs
Help › Open logs folder opens it, as does Open logs folder in Settings › Developer. The folder is logs in the app’s data folder: %APPDATA%\com.flockbay.desktop\logs on Windows, ~/Library/Application Support/com.flockbay.desktop/logs on macOS, and ~/.local/share/com.flockbay.desktop/logs on Linux.
Send logs to Flockbay… lists each file it sends, with its size and lines; open one to read its last 40 lines as they are on this computer, or use Copy and Show in Explorer. Each file is sent from its end, up to 2 MB, with paths, email addresses and keys removed.
When the Godot editor crashes, the band above the chat names Godot’s exit code, such as 0xC0000005 (access violation), with Open editor log.
Play is greyed out
Its tooltip says why. "Locate the project folder before playing." means the folder was moved, renamed, or is on a drive that is not attached: press Locate folder… on the project’s card. "Another game is running. Stop it before starting this one." means a game from another chat is running; one game runs at a time.
If the editor lost its line to the app, Play says "Disconnected from Flockbay. Play waits until the editor reconnects; if it doesn’t, restart the Flockbay app."
GDScript errors on Play
A Play you press stops at a script error, at its line, as Godot’s runner does: the error and stack trace are under Debugger › Errors and the prints in Output. A game that fails before its window opens leads with Godot’s first error line and its res:// file, then the exit code or signal, with Godot’s output in Output. Play and debug covers the debugger.
The MCP connection doesn’t start
If your agent lists only flockbay_status, the app is not serving it: open the project in Flockbay and press Turn on in Connect your agent (MCP). If the dialog shows a red line that the connection couldn’t start on this computer, it names why. After a Flockbay update, copy the setup line again. Connect your agent (MCP) has each case.
An export fails
The first export to a platform downloads its export templates; if that fails, the message says so, and it is the one part of exporting that needs a connection. A failed build shows what the exporter printed, with Fix with Flockbay, which sends it to the chat. Export says why Export can be greyed out.
A security warning on the finished build is not a failure: exported games are unsigned. On Windows, More info, then Run anyway, opens it.
Windows blocks a write
When Windows Security’s Controlled folder access protects a folder, Godot or Flockbay cannot write to it, and the card names the folder. In Windows Security, open Virus & threat protection › Manage ransomware protection › Allow an app through Controlled folder access, choose Add an allowed app › Recently blocked apps, and add Godot, and Flockbay if it is listed. Then open the editor again, or send the message again. Another antivirus that refuses writes to Flockbay’s data folder needs the same exception.
A change doesn’t show up
If a turn reports a change and the running game looks the same, the change is on disk and the running game has not loaded it. Stop the game (F8) and press Play again.
If you had the project open in another Godot editor at the same time, check that you saved and closed it: a save from there after a turn overwrites the turn’s edit.
No connection
Building needs the network: signing in, the chat and generating assets all do. "You’re offline" means this computer has no connection.
Playing what you have built, building by hand in the Godot editor, opening the project in Godot and running an exported build do not need the network.
AppImage, x86_64. Ubuntu 22.04, Debian 12, Fedora 39 or newer.
Intel or AMD Chromebook, with Linux turned on.
See also: AI game maker.
