Abre tu proyecto de Godot existente
Un proyecto de Godot que hiciste en otro sitio se abre en Flockbay. Flockbay pregunta una vez antes de escribir nada en él, registra todo lo que añade y lo vuelve a quitar todo cuando lo pides.
Abrir el proyecto
En Home, elige Open project… y selecciona la carpeta del proyecto. También sirve una carpeta que lo contenga: Flockbay busca un project.godot hasta tres niveles más abajo, abre el que encuentra y, si encuentra varios, los enumera. El ▾ junto a Open project… tiene Import…, que acepta un project.godot o un .zip y descomprime el .zip a su lado, y Recent Godot projects, la lista que mantiene el Project Manager de Godot. Una carpeta, un project.godot o un .zip que sueltes en Home, fuera del cuadro de juego nuevo, se abre igual.
Se abre un proyecto en una carpeta compartida de red o en una unidad de red asignada, y también uno detrás de una unión (junction) o un enlace simbólico: Flockbay abre la carpeta real y dice dónde está. Los enlaces dentro del proyecto se siguen para leer, como los sigue Godot.
Si un editor de Godot que abriste tú tiene el proyecto abierto, Flockbay pregunta primero: ciérralo allí, o elige Open anyway. Dos editores sobre un mismo proyecto sobrescriben lo que guarda el otro.
Flockbay pregunta antes de añadir nada
Nada te pide escribir un brief: Flockbay lee el proyecto y trabaja en lo que le pides. Para un proyecto que Flockbay no hizo, una tarjeta pregunta «Add Flockbay to» y el nombre del proyecto antes de escribir nada, y enumera lo que escribe añadirlo.
La lista es corta: el plugin del editor en addons/flockbay_editor/; sus entradas bajo [editor_plugins] en project.godot, sin cambiar ningún otro ajuste; stage_generated/, que se añade la primera vez que pulsas Play; .flockbay/, los registros propios de Flockbay para el proyecto; en un juego 3D, modelos iniciales para la biblioteca Place del constructor; y en un repositorio git, un bloque marcado en .gitignore y otro en .gitattributes, con el filtro que ese bloque nombra en .git/config. En un proyecto C#, la tarjeta añade que el editor .NET de Godot escribe [dotnet] project/assembly_name al guardar.
Un archivo de esa lista que sea de solo lectura, como los que un espacio de trabajo de Perforce mantiene así hasta que haces checkout, aparece nombrado en la tarjeta, y Add and open lo hace escribible. Guardar sobre cualquier otro archivo de solo lectura se detiene y nombra el archivo, para que hagas checkout y lo intentes de nuevo.
Add and open abre el proyecto en el editor con el chat y el constructor. Open without Flockbay lo abre en el editor de Godot sin el plugin de Flockbay, con el chat en la propia ventana de la app, y no escribe ninguno de los archivos de Flockbay en el proyecto. La IA sigue leyendo el proyecto, edita los scripts y las escenas que le pidas, comprueba scripts y ejecuta el juego en modo headless, con sus propios archivos guardados en los datos de la app. Las ejecuciones en segundo plano y Play esperan hasta que añadas Flockbay: pulsar Play vuelve a mostrar la tarjeta. Cancel deja la carpeta como estaba.
Todo lo que Flockbay añade queda registrado en .flockbay/added.json, con el valor anterior de cada ajuste que cambió. Ese registro es tu respuesta en este ordenador, y por eso la pregunta se hace una sola vez. Git lo ignora, así que el clon de un compañero de equipo también recibe la tarjeta.
Tus ajustes y tus plugins siguen siendo tuyos
Flockbay no sobrescribe los ajustes de tu proyecto. Tu ajuste de importación de Blender, tu icono y tu boot splash se quedan como los configuraste, y tu propia copia de un plugin que Flockbay también usa, como Phantom Camera, nunca se sustituye por la de Flockbay.
La IA trabaja en el proyecto con las herramientas de Godot: escenas, nodos, scripts, recursos, señales, ejecuciones y capturas de pantalla. Las imágenes, los modelos, los efectos de sonido y la música generados van a la carpeta donde tu proyecto ya guarda ese tipo de archivo, y la IA dice cuál.
El constructor trabaja sobre tus propias escenas. Su Asset Browser lista el arte que tu proyecto ha importado, esté donde esté, por carpeta, y en una escena 2D Paint pinta tus TileMapLayers con los tiles y los terrenos de su TileSet, un paso de deshacer por trazo. El terreno, el cielo, el agua y los controladores de personaje vienen de plugins de Godot: Plugins lista los plugins de la Asset Store que encajan con el proyecto e instala uno cuando pulsas Install.
Play no añade nada permanente
En un proyecto hecho en otro sitio, pulsar Play no escribe nada en project.godot. Lo que necesita la ejecución se carga mediante un override.cfg solo para esa ejecución y se quita cuando el juego se detiene, y un override.cfg tuyo se vuelve a dejar como estaba. El overlay de Play y su agente solo actúan en las ejecuciones que inicia Flockbay, así que una build desde el propio Project > Export de Godot se juega solo como tu juego.
El overlay de Play de Flockbay nunca se queda con una tecla que use tu juego. Un juego con su propio menú de pausa conserva Esc, y F8 detiene la ejecución. Play no añade ninguna cámara propia y nunca cambia la escala de contenido de tu ventana.
Play ejecuta lo que ejecuta Godot. Cuando el cargador del motor rechaza una GDExtension, porque se compiló para un Godot más nuevo o no tiene biblioteca para esta plataforma, o cuando falta el script de un autoload, Godot lo omite y ejecuta el resto. Play hace lo mismo y nombra lo omitido junto a la ejecución, con las palabras del propio Godot. Un juego que activa disable_stdout también se juega.
Un proyecto sin escena principal sigue ejecutando sus escenas: F6 ejecuta la escena abierta, y Run Current Scene, Run Specific Scene y la ejecución propia de un plugin, como la de un test runner, ejecutan la escena que nombran. F5 pide una escena principal como hace Godot, “No main scene has ever been defined.”, con los propios botones de Godot: Select elige cualquier escena, Select Current toma la que está abierta en el editor, y la escena que elijas se establece como escena principal y se ejecuta.
Qué entra en git, y qué no
En un repositorio git, Flockbay mantiene un bloque en .gitignore, entre las líneas "# Flockbay: begin" y "# Flockbay: end". Solo reescribe las líneas entre esos dos marcadores; tus propias reglas quedan fuera de ellos.
El bloque ignora lo que pertenece a este equipo o se vuelve a poner en cada apertura o Play: el plugin del editor, override.cfg, los modelos iniciales y la mayor parte de .flockbay/, added.json incluido. Conserva los registros que necesita un clon para ser el mismo juego, como de dónde vino cada asset generado o descargado, con su licencia, y la música que suena en el juego.
El bloque en .gitattributes pasa project.godot por un filtro clean, configurado en el .git/config del repositorio, que deja fuera de lo que preparas con stage las entradas [editor_plugins] del plugin del editor. El project.godot del que haces commit no lleva nada de Flockbay, git status sigue limpio mientras el plugin está activo, y un compañero que abre el clon en un Godot sin Flockbay no ve ningún plugin que falte. Un Git sin el filtro hace commit del archivo tal como está.
En un proyecto hecho en otro sitio, la IA solo hace commits cuando se lo pides, y nunca escribe un nombre ni un correo en tu configuración de Git.
Dónde falla eso: los modelos iniciales también se ignoran, así que una escena que coloca uno nombra archivos que el clon no tiene hasta que el compañero añade Flockbay, y un Godot sin Flockbay los marca como dependencias que faltan.
Proyectos de otra versión de Godot
Flockbay incluye Godot 4.7.2. Un proyecto guardado por última vez con un Godot 4 más antiguo recibe una tarjeta con tres opciones. Keep Godot y la versión del proyecto, como Keep Godot 4.3, lo abre en tu propio Godot de esa versión, tal como está, y algunas funciones de Flockbay no están disponibles allí. Upgrade to Godot 4.7.2 lo actualiza en el sitio, lo que reescribe los ajustes de importación y añade archivos UID de scripts, como hace la propia actualización de Godot. Open a copy in Godot 4.7.2 hace una copia a su lado y deja el original intacto. Un proyecto de un Godot más nuevo recibe Keep y Open a copy.
Un proyecto de Godot 3 recibe Keep Godot 3, que lo abre en tu propio Godot 3 para que la IA edite archivos y ejecute el juego, sin las herramientas del editor, la pantalla Game ni el constructor, o Convert a copy to Godot 4.7.2. Convertir ejecuta el conversor propio de Godot sobre una copia junto al original, que solo lee, luego carga cada script, escena, recurso y shader de la copia y enumera lo que Godot 4 sigue reportando, por archivo y línea, junto con cualquier archivo que el conversor omitió. Un proyecto C# recibe el archivo de proyecto de Godot 4, con el de Godot 3 guardado como .csproj.godot3, y cuando Flockbay ya ha descargado el SDK de .NET su C# se compila y cada error del compilador se suma a la lista.
Volver a quitar Flockbay
Uninstall Flockbay from project… está en el menú del proyecto en Home, y en el menú del proyecto del dock del editor, que primero guarda y cierra el editor. Su tarjeta enumera lo que se va: las carpetas que Flockbay añadió y las que creó y quedan vacías, los ajustes del proyecto que vuelven a sus valores anteriores, sus bloques en .gitignore y .gitattributes, y lo que configuró en el .git/config y los hooks del repositorio. Los archivos que hizo escribibles vuelven a ser de solo lectura, y Git LFS sigue configurado mientras haya archivos del repositorio guardados en él.
GAME-BRIEF.md y todo lo que Flockbay construyó en tus propias escenas y scripts son ya tu juego, y no se tocan. Si archivos tuyos todavía usan archivos que se irían, la tarjeta los lista y ofrece Keep files in use o Uninstall anyway. Desde Home, cierra antes el editor y detén el juego.
Descarga Flockbay
Flockbay es gratis para Windows, macOS y Linux. La app está en inglés; estas páginas explican en español lo que hace cada parte.
Flockbay es una app de escritorio para Windows, macOS y Linux. Regístrate y envía la descarga a tu equipo.
