Ir al contenido
Descargar
Guía de Gobu

Primeros pasos

Gobu Engine es un motor de juegos derivado de Godot. Mantiene el árbol de actores y gran parte de la API, pero cambia la forma de trabajar:

  • Un lenguaje propio, Grost (ver El lenguaje Grost).
  • Documentos con el código incrustado: escenas, prefabs e interfaces (capítulo 2).
  • Managers para el flujo del juego: cambiar de escena, crear entidades, mostrar interfaces, sonidos (capítulo 3).
  • Física con Box2D y Box3D, input estilo Enhanced Input y un renderer propio sobre bgfx.
  • Un servidor MCP para que un asistente de IA trabaje dentro del editor (capítulo 10).

Cada versión está en la página de releases con dos formas de conseguir el editor de Windows:

  • gobu-setup-windows.exe, el instalador. Instala Gobu para tu usuario, sin permisos de administrador, en %LOCALAPPDATA%\Programs\Gobu, con su entrada en el menú Inicio y su desinstalador.
  • gobu-editor-windows.zip, el mismo editor para descomprimir en cualquier carpeta en la que puedas escribir.

En los dos casos el editor avisa cuando sale una versión nueva y se actualiza solo. Las plantillas de exportación de cada plataforma se instalan desde el editor cuando las necesitas (Install Module…, ver capítulo 9).

Al abrir Gobu ves el gestor de proyectos: la lista de tus proyectos, con una etiqueta 2d o 3d delante de cada uno. Desde ahí creas un proyecto nuevo, importas uno existente o abres uno de la lista.

Al crear un proyecto eliges si es 2D o 3D:

  • 2D: optimizado para juegos y aplicaciones 2D; usa física y renderizado 2D por defecto.
  • 3D: optimizado para juegos 3D; usa física y renderizado 3D por defecto. Pensado para primera persona, tercera persona y simulaciones 3D.

La elección se guarda en el ajuste de proyecto application/config/is_2d_project (si falta, el proyecto cuenta como 2D). Decide qué módulos carga el editor: en un proyecto 2D no se listan los actores derivados de Spatial3D al crear actores, y en uno 3D no se listan los de Spatial2D. El modo de selección del visor también es solo el del tipo de proyecto.

Project Settings > Application > Config con Is 2D Project activado

Carpeta o archivoQué contiene
project.gobuLos ajustes del proyecto
resources/Tus recursos: escenas, prefabs, texturas, sonidos, scripts. Es res://
plugins/Los plugins del proyecto, una carpeta por plugin. Vive fuera de resources/, pero se accede como res://plugins/...
config/Configuración del proyecto, también fuera de resources/ (res://config/...)
.cache/Datos que el editor genera; no hace falta versionarlos

Es decir, res://player.prefab es el archivo <proyecto>/resources/player.prefab. En el panel de archivos la carpeta plugins aparece aparte, como una carpeta “Plugins” de primer nivel.

El panel Assets: res:// tiene las carpetas de resources/, y Plugins aparece aparte

La barra de ejecución del editor lanza el juego. Puedes ejecutar la escena principal del proyecto (run/main_scene) o la escena que estás editando. Lo que imprime el juego (print, errores) aparece en la pestaña Output del Debugger (capítulo 1).

La barra de ejecución en la cabecera del visor y la pestaña Output del Debugger con una línea que imprimió el juego

Si el código de un documento tiene un error de sintaxis, el juego no lo ejecuta y el error aparece en Output.

Si te atascas, pregunta en el Discord de Gobu: abre un hilo en #help, o informa de un fallo en #bugs.