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
There is no Mac download today. Flockbay runs on Windows. The Mac release is later.
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 for Windows today. The Mac release is later. There is no browser version, no phone version and no Linux build.
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, you press Continue, the world builds, and it opens in the editor with the chat beside it. That conversation is the whole setup. The free Flockbay demo model builds from your first sentence, and your own Claude or ChatGPT is one press away.
Your account
Downloading Flockbay needs no account. Opening it, making a world, Play, and the builder do not either. A free account signs you in to build with the AI, connect your own agent, and publish; 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 subscription, through the Codex engine that ships with the app. You pay OpenAI for the plan you already have, 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 editor, where a new install starts, leaves only the view, the chat and Flockbay’s tools. Full editor 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
Building on your own AI is free: your Claude or ChatGPT plan in the app, your own agent over MCP, or your own API key. Flockbay also has three optional plans that run the AI for you.
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.