Flockbay documentation
How to install Flockbay, build a world by hand, ask for a change, and find your project on disk. Every page here describes the app as it ships. If something is not documented, it is because it is not in the app yet.
Getting started
Install on Mac
Flockbay for Mac is a signed, notarised disk image for Apple Silicon, downloaded from flockbay.com. It is an earlier release than the Windows one: it does not yet run Claude in the app or host the full editor.
Install on Windows
Flockbay for Windows is a code-signed installer you download from flockbay.com and run. It installs for your user account only, so it does not ask for an administrator.
System requirements
Flockbay is a desktop app. Windows is the main release, the Mac build for Apple Silicon is an earlier release, and Linux desktops and Chromebooks run the same Linux AppImage. There is no phone version.
What happens on first launch
Flockbay is an AI game maker. It opens on one question — what game do you want to make? — not a list of games. You type a sentence, the AI reads it and shows what it understood on one card with 2D or 3D already selected, and Continue makes an empty Godot project of that kind. Your sentence becomes the first message in its chat: Flockbay asks what it still needs, proposes a brief, and builds the first playable when you press Go. That conversation is the whole setup. The free Flockbay demo model runs it from your first sentence, and your own Claude or ChatGPT is one press away.
Your account
Downloading Flockbay needs no account, and neither does building. On first launch Flockbay gives the install a guest account, with no browser and no email, and builds on it from your first message. Play and the builder ask for nothing more. Save your account is a free sign-in, needed to share a play link, make a Community profile, or prepare a Steam page. Your AI connects in Connectors, from the Flockbay menu.
Your own AI
Build with your Claude plan
Flockbay runs Claude Code, Anthropic’s coding agent, on your own Claude plan and shows its work in Flockbay’s chat. You pay Anthropic for the plan you already have, and Flockbay nothing. On Windows today.
Build with your ChatGPT plan
Sign in with ChatGPT and Flockbay’s chat runs on your own ChatGPT account, through the Codex engine that ships with the app. You pay OpenAI for the plan you already have, if it is a paid one, and Flockbay nothing.
Connect your own agent
Flockbay can expose your open project to an AI agent you already use. It does that over MCP, an open protocol, rather than through an integration we built for one product.
The builder
The editor: Full and Simple
Flockbay opens your game in the Godot editor that ships with it. Simple view, where a new install starts, keeps what you need to check a turn: the Scene dock, the Inspector, the Script editor, and Output and the Debugger, beside the viewport, the chat and Flockbay’s tools. Full view is Godot’s editor with Flockbay added. Play belongs to the app in both.
The builder
The builder is where you build your world by hand. Its tools sit around the 3D view, or the 2D view in a 2D game, they change the world itself, and what you change is saved into your project as you go.
Sculpt
Sculpt shapes the ground. You pick a verb, set the brush, and drag on the terrain until the land is the shape you want.
Paint
Paint decides what the ground is made of. In a 3D world Sculpt gives you the shape and Paint gives you the rock, grass, sand or mud lying on it. In a 2D world Paint lays the ground itself.
Plants
Plants scatters vegetation across the ground. You choose what to plant, then drag to plant it or erase it.
Water
Water is a panel, not a brush. You raise a level and the land decides where the water goes.
Sky
Sky sets the time of day and the sun. It is a panel of settings, with no brush and nothing to drag.
Weather
Weather adds rain or snow over time. The tool appears only in worlds that have a weather system, and most of what it shows comes from that system rather than from us.
Characters
Characters is where you tune how it feels to walk around your world. It is a panel of sliders for the player, not a brush.
People
People is the tool for the inhabitants of your world. It is in the tool column only when someone in your world can be changed.
Flockbay
What Flockbay does
Flockbay writes the code. You describe what you want; it edits the files in your project and tells you what it did.
Asking for a change
You ask in the chat, Flockbay works, and the thread shows you what it did. Reading that thread well is most of the skill.
When to use the manual controls
There are two ways to change your world, and they are good at different things. Asking is good at code and at scale. Doing it yourself is good at judgement.
Which models can I use?
The model is yours. On your Claude plan you pick among the models Claude Code offers your account; on your ChatGPT plan, among your account’s models; on an API key, any model the key reaches. The choice belongs to each chat.
The modeler
The modeler is how your AI makes a 3D model without a generation key. It writes a spec of blended shapes, and Flockbay builds a rigged, game-ready model from it on your computer. It costs nothing per model.
Your project
Where your project lives
Your project is a folder, in a place you picked, containing a real Godot project. Flockbay does not hide it somewhere and does not own it.
Opening your project in Godot
Every project already opens in Godot: the app’s own screen is the Godot editor that ships with it. It is a real Godot project, so nothing about it is locked to this app.
Open your existing Godot project
A Godot project you made elsewhere opens in Flockbay. Flockbay asks once before it writes anything into it, records everything it adds, and takes it all out again when you ask.
Exporting your game
Export turns your project into a standalone application someone else can run without Flockbay. There are two targets: macOS and Windows.
Reference
Plans and usage
Flockbay is free, and so is its AI. Every account gets free AI each day on the hosted model, called Demo. You can also build on your Claude or ChatGPT plan, your own agent over MCP, or your own API key.
Troubleshooting
The messages in Flockbay are written to be acted on. This page covers the ones people hit most, and what each of them actually means.