Projects
Projects on disk
A project is a Godot project folder on your computer, where you made or opened it. Flockbay keeps no copy of it elsewhere. Its own data and logs are in a separate app data folder.
Where new projects go
New projects are made in the New projects folder, Documents\Flockbay on Windows and ~/Documents/Flockbay on macOS and Linux. Settings › New projects folder › Change… picks another, and Restore default puts it back. The New project dialog’s Location can put any one project somewhere else.
A project you open from elsewhere stays where it is. Flockbay works on it in place and never moves or copies it.
What is in a project
An ordinary Godot 4 project: project.godot, your scenes, scripts and assets, as Godot lays them out. There is no database and no container around it. Flockbay adds its editor plugin in addons/flockbay_editor/ and keeps its own records in .flockbay/; Open your existing Godot project lists every addition and how Git treats it.
Other files appear as you work: GAME-BRIEF.md once you approve a brief, generated assets in the folders your project keeps that kind of file in, and 3D models built by Flockbay under assets/Models/.
Opening the folder in your own tools
The project menu has Show in Explorer (Show in Finder on a Mac, Show in file manager on Linux), Open in your code editor, and Open in Terminal, each at the project’s folder.
Settings › Developer › External editor sets the editor: VS Code, Cursor, Windsurf, Rider, Zed, Godot’s Script editor, or Custom, a program with arguments where {project}, {file}, {line} and {col} are filled in as in Godot’s Exec Flags. Until you choose, it is the one your own Godot uses, else the first one found on this computer. Every res:// path, step and error line in the chat opens there, at its line. Terminal, in the same section, sets what Open in Terminal starts.
Open without Flockbay opens the project in the Godot editor without Flockbay’s plugin: Open without Flockbay.
A moved or renamed project
Flockbay remembers each project’s folder. If the folder is moved, renamed or on a drive that is not connected, Play, Export and the editor wait rather than act on the wrong place: Play’s tooltip says "Locate the project folder before playing." Press Locate folder… on the project’s card and pick where it is now.
Remove from list, in the project menu on Home, takes a project off the list and deletes nothing, as Godot’s Project Manager does; opening its folder again brings it back.
App data and logs
Flockbay’s own data, its settings, chats, downloaded tools and logs, is in its app data folder. Your projects are never in it.
| System | App data | Logs |
|---|---|---|
| Windows | %APPDATA%\com.flockbay.desktop | %APPDATA%\com.flockbay.desktop\logs |
| macOS | ~/Library/Application Support/com.flockbay.desktop | …/com.flockbay.desktop/logs |
| Linux | ~/.local/share/com.flockbay.desktop | …/com.flockbay.desktop/logs |
Settings › Developer has Open data folder and Open logs folder, and Help › Open logs folder opens the logs too. Troubleshooting and support says what to send when something fails.
AppImage, x86_64. Ubuntu 22.04, Debian 12, Fedora 39 or newer.
Intel or AMD Chromebook, with Linux turned on.
See also: what of Flockbay is open source.
