Instalación y configuración de Godot para juegos 2D con GDScript

Descarga e instalación de Godot

Godot es un motor que puedes usar sin instalación tradicional (en la mayoría de sistemas): descargas el ejecutable, lo descomprimes y lo ejecutas. Para trabajar en 2D con GDScript, lo importante es elegir la versión correcta y dejar listo el entorno de proyecto.

Elegir versión (recomendación práctica)

• Godot 4.x: recomendado si empiezas desde cero y quieres el flujo actual del motor.
• Godot 3.5.x: útil si sigues un curso/proyecto antiguo o necesitas compatibilidad específica.

En este curso asumiremos un flujo típico de Godot 4.x (2D + GDScript).

Paso a paso: descargar y ejecutar

1. Ve a la web oficial de Godot y descarga la versión estable para tu sistema (Windows, macOS o Linux).
2. Descomprime el archivo en una carpeta de trabajo (por ejemplo, Documentos/Godot/).
3. Ejecuta el editor:
   • Windows: Godot_v4.x-stable_win64.exe
   • macOS: abre el .app (puede requerir permiso en Seguridad/Privacidad).
   • Linux: marca como ejecutable y abre el binario.
4. (Opcional) Crea un acceso directo al ejecutable para abrirlo rápido.

Verificación rápida del editor

Antes de crear el proyecto, comprueba que el editor funciona correctamente:

• Al abrir Godot, debe aparecer el Project Manager (gestor de proyectos).
• Abre la pestaña de Asset Library solo para verificar que carga (no necesitas descargar nada).
• Entra a Editor Settings y confirma que puedes cambiar un ajuste (por ejemplo, tema o tamaño de fuente) y que el editor no se cierra inesperadamente.

Crear un proyecto 2D

Un proyecto en Godot es una carpeta con un archivo project.godot y tus recursos (escenas, scripts, imágenes, audio). La organización desde el inicio evita problemas cuando el proyecto crece.

Paso a paso: crear el proyecto

1. En el Project Manager, pulsa New Project.
2. Asigna un nombre (ej.: MiJuego2D).
3. Elige una carpeta vacía como ruta del proyecto (ej.: Documentos/ProyectosGodot/MiJuego2D).
4. En Renderer, deja la opción por defecto recomendada (en Godot 4 suele ser Forward+ o la que sugiera el editor). Para 2D no es crítico al inicio.
5. Pulsa Create & Edit.

Confirmación de que el proyecto está bien creado

• En el panel FileSystem debe aparecer res:// como raíz.
• Si ves la escena vacía y los paneles (Scene, Inspector, FileSystem), el editor cargó el proyecto correctamente.

Primera escena vacía y guardado inicial

En Godot, casi todo se construye con escenas. Una escena es un árbol de nodos que puedes ejecutar, instanciar y reutilizar. Para arrancar ordenadamente, crea una escena base vacía y guárdala en una carpeta de escenas.

Continúa en nuestra aplicación.

• Escuche el audio con la pantalla apagada.
• Obtenga un certificado al finalizar.
• ¡Más de 5000 cursos para que explores!

O continúa leyendo más abajo...

Descargar la aplicación

Paso a paso: crear la primera escena vacía

1. En el panel Scene, pulsa + o Add Child Node.
2. Para un juego 2D, crea un nodo raíz Node2D (o Control si fuera UI). Elige Node2D.
3. Guarda la escena: Scene > Save Scene.
4. Si aún no existe la carpeta, crea res://scenes/ y guarda como res://scenes/main.tscn.

Probar que ejecutar funciona (smoke test)

Haz una prueba mínima para confirmar que el ciclo de ejecución está correcto:

1. Ve a Project > Project Settings > Application > Run.
2. En Main Scene, selecciona res://scenes/main.tscn.
3. Pulsa Play (triángulo). Debe abrirse una ventana del juego (aunque esté vacía) sin errores.
4. Cierra la ventana del juego y verifica que no aparecieron errores en la pestaña Debugger/Errors.

Configuración esencial para 2D: resolución, ventana y escalado

En 2D, la configuración de ventana y escalado determina cómo se verá tu juego en distintas pantallas. La idea es definir una resolución base (tu “lienzo”) y una política de escalado para adaptarse a diferentes resoluciones reales.

Resolución base (Viewport Width/Height)

Configura el tamaño base del viewport:

1. Abre Project > Project Settings.
2. Ve a Display > Window.
3. Ajusta Viewport Width y Viewport Height.

Ejemplos comunes:

• Pixel art: 320x180, 480x270 o 640x360 (luego se escala por múltiplos).
• 2D moderno: 1280x720 o 1920x1080 como base (dependiendo del objetivo).

Modo de ventana

Define cómo inicia el juego:

1. En Display > Window, busca opciones como Mode (Windowed/Fullscreen/Exclusive Fullscreen según plataforma).
2. Para desarrollo, usa Windowed (ventana) y un tamaño cómodo.
3. Más adelante podrás añadir un menú de opciones para cambiarlo en tiempo de ejecución.

Escalado (Content Scale)

El escalado controla cómo se adapta el contenido a pantallas con diferentes proporciones.

1. En Project Settings, ve a Display > Window y localiza Content Scale (nombres exactos pueden variar ligeramente por versión).
2. Configura el Mode (por ejemplo, basado en viewport) y el Aspect (cómo manejar proporciones).

Guía práctica (recomendación general):

• Aspect: Keep o Keep Width/Keep Height para mantener proporción y evitar estiramientos.
• Si tu juego debe llenar pantalla sin deformar, usa una opción que mantenga aspecto y acepte bandas (letterboxing) cuando sea necesario.

Prueba visual rápida del escalado

1. Ejecuta el proyecto.
2. Redimensiona la ventana (si está permitido) y observa si el contenido se estira o mantiene proporción.
3. Si notas deformación, revisa Aspect y vuelve a probar.

Carpeta de recursos y organización inicial del proyecto

Una estructura clara desde el principio te ayuda a encontrar archivos rápido y evita dependencias desordenadas. En Godot, todo vive bajo res://.

Estructura base recomendada

Crea estas carpetas en el panel FileSystem (clic derecho sobre res:// > New Folder):

• res://scenes/ (escenas .tscn)
• res://scripts/ (scripts .gd)
• res://sprites/ (imágenes, spritesheets, texturas)
• res://sounds/ (SFX)
• res://music/ (música)
• res://ui/ (escenas/recursos de interfaz)
• res://fonts/ (tipografías)
• res://data/ (JSON, configs, tablas)

Si quieres algo aún más ordenado, puedes agrupar por “feature” (por ejemplo res://player/, res://enemies/), pero para empezar esta estructura por tipo de recurso es simple y efectiva.

Convenciones de nombres (prácticas)

• Escenas: snake_case o PascalCase, pero sé consistente. Ej.: main.tscn, player.tscn.
• Scripts: mismo nombre que la escena cuando aplique. Ej.: player.gd.
• Recursos: evita espacios y caracteres raros. Ej.: jump_01.wav, tileset_forest.png.

Configurar la escena principal del proyecto

Godot necesita saber qué escena se ejecuta al presionar Play o al exportar.

Paso a paso: asignar Main Scene

1. Abre Project > Project Settings.
2. Ve a Application > Run.
3. En Main Scene, selecciona res://scenes/main.tscn.
4. Guarda (Godot guarda automáticamente al cerrar, pero es buena práctica revisar).

Comprobación práctica: editor, escena, guardado y ejecución

Esta mini-rutina te confirma que todo está listo para empezar a construir:

1. Abre el proyecto desde el Project Manager.
2. Abre res://scenes/main.tscn.
3. Guarda la escena (Ctrl+S / Cmd+S).
4. Ejecuta con Play.
5. Verifica que no hay errores en Debugger.
6. Cierra y vuelve a abrir el proyecto: confirma que la estructura de carpetas y la escena se mantienen.

Checklist de configuración mínima para empezar

• Godot descargado y ejecuta sin errores (Project Manager abre correctamente).
• Proyecto creado en una carpeta dedicada (ruta clara y sin mezclar con otros proyectos).
• Carpetas base creadas: scenes, scripts, sprites, sounds (y opcionales music, ui, fonts, data).
• Primera escena vacía creada y guardada: res://scenes/main.tscn con nodo raíz Node2D.
• Main Scene asignada en Project Settings > Application > Run.
• Resolución base configurada (Viewport Width/Height) acorde al objetivo del juego.
• Modo de ventana definido para desarrollo (Windowed recomendado al inicio).
• Escalado configurado para evitar deformaciones (Aspect en modo “Keep” o equivalente).
• Prueba de ejecución realizada: ventana abre y no hay errores en Debugger.