# Godot/Editor/Administrador de proyectos

Abre Godot e inmediatamente después te debería aparecer la ventana del Administrador de proyectos. Si te aparece un diálogo sugiriéndote abrir un proyecto de la Librería de Assets, pulsa cancelar:

## ¿Qué es un proyecto de Godot?

Cada videojuego o aplicación que desees desarrollar con Godot se organiza alrededor de un proyecto. Un proyecto es un conjunto de archivos (niveles, scripts de programación, assets de distintos tipos -audio, imágenes, vídeo, modelos 3d, configuración, plugins, etc.) que se almacenan juntos dentro de un directorio y sus subdirectorios y que muchas veces se referencian entre sí para formar parte de nuestro juego. Algunos de estos archivos luego se empaquetarán juntos para formar parte del resultado final, a veces en su estado original, a veces modificados, y a veces los archivos no formarán parte del empaquetado final, porque solo son útiles durante el desarrollo. Para añadir archivos a nuestro proyecto podremos usar las funcionalidades del editor, o podremos simplemente arrastrarlos o guardarlos dentro de la carpeta del proyecto, pero en general Godot necesitará estar ejecutándose o ejecutarse posteriormente a los cambios para que el editor los reconozca y se importen correctamente dentro del proyecto.
El administrador de proyectos permite seleccionar qué proyecto deseamos editar o ejecutar de una lista, y también permite crear nuevos proyectos, que es lo que vamos a hacer a continuación. El administrador aparecerá siempre que ejecutemos Godot sin seleccionar un proyecto, o bien desde el menú Proyecto > Salir al listado de proyectos si estamos editando actualmente un proyecto y deseamos cerrarlo sin salir.

## Creando un nuevo proyecto

Por defecto, la lista de proyectos creados aparecerá vacía- pero desde este diálogo podemos crear nuevos proyectos, importar, buscar o descargar proyectos existentes. Vamos a realizar lo primero.
Para eso, asegúrate de que estás en la pestaña Proyectos Locales, arriba a la izquierda, y just debajo pulsa en el botón más a la izquierda: + Nuevo. Debería aparecerte una ventana emergente parecida a esto:
Aquí configuraremos, antes de darle a Crear y editar:
* El nombre del proyecto
* Su ruta
* El renderizador
* La compatibilidad con metadatadatos
Vamos a ver paso por paso exactamente qué es cada cosa.

### Nombre del proyecto

Este será el nombre con el que se conocerá el proyecto al editarlo. No te preocupes si no tienes un buen nombre al principio de la edición porque se puede cambiar más adelante tanto en el propio Administrador de proyectos como en la ventana principal de edición, en el menú: Configuración del Proyecto > General > Aplicación > Configuración > Nombre, y el nombre con el que se exporte no tiene por qué coincidir con el nombre al editarlo, por lo que puede usarse sin problemas un nombre en clave.
Idealmente el nombre del proyecto debería coincidir con el de la carpeta que la contiene, para más fácil identificación, de ahí que te sugiera pulsar el botón <Crear Carpeta> a su derecha- pero antes veamos la siguiente sección.
Te sugerimos escribir "Mi primer juego" como nombre.

### Ruta del proyecto

Este es el lugar en tu PC donde se almacenará el proyecto- por defecto sugiere la carpeta de documentos, pero mira que probablemente te salga un texto en rojo que dice: "No puedes guardar un proyecto en la ruta seleccionada. Por favor crea una nueva carpeta o elige una nueva ruta". Esto es porque Godot comprueba que la carpeta que eligas está vacía- de ahí que no te deje usar directamente la carpeta de documentos. Lo ideal sería, ahí donde queramos guardarla, crear una carpeta dedicada para nuestro proyecto, lo cual podemos hacer pulsando el botón de Crear Carpeta- el cual creará un directorio con el nombre del proyecto que hayamos escrito arriba, y el error desaparecerá.
Si la carpeta documentos no es el lugar donde queremos guardar nuestros proyectos, podemos pulsar el botón Examinar para seleccionar una nueva ruta o incluso crear una nueva carpeta para todos nuestros proyectos en nuestro PC (Seleccionar carpeta actual). Por ejemplo, para este curso nosotros vamos a guardar el proyecto en la carpeta existente D:\desarrollos\ (pero elige tú mismo una ruta adecuada para tí). Después pulsaremos Crear Carpeta y esto hará que se cree una nueva carpeta y el proyecto esté almacenado en: D:\desarrollos\Mi primer juego.
Si examinas esta ruta una vez creada, verás que -entre otros archivos- la carpeta tiene un archivo denominada project.godot. Este es el archivo principal de configuración del proyecto, que siempre debe existir- y el que podremos usar para importar o abrir un proyecto directamente.

### Renderizador

Esta es una de las opciones menos claras a la hora de empezar a trabajar con Godot y/o crear un nuevo proyecto, pero ¡que no te estrese! Se puede cambiar una vez el proyecto está empezado en el desplegable de la ventana principal del editor, en el desplegable de la esquina arriba a la derecha. La principal razón por la que aparece tan pronto es que al cambiarla es necesario reiniciar el editor.
Vamos a explicar de manera general las distintas opciones, pero no te preocupes demasiado por cometer un error al elegir uno- ¡probablemente no afecte mucho a tu primer juego!
* Forward+: Usa Vulkan como backend de renderizado- es la configuración pensada para juegos de escritorio con escenas complejas, pero puede ser poco eficiente en móviles.
* Móvil: También usa Vulkan, pero un método más simple (iluminación de un solo paso), ideal para escenas sencillas y para móviles. Hay algunas características como el sistema de iluminación global, niebla volumétrica y varios de los efectos de prostprocesado que estarán deshabilitados.
* Compatiblidad: Usa OpenGL 3/OpenGL ES 3, ideal para conseguir máxima compatibilidad con dispositivos antiguos, y WebGL2 para web.
Para nuestro primer juego puedes seleccionar el modo Compatibilidad, ya que haremos un videojuego muy sencillo en 2 dimensiones.

### Metadatadatos de Control de Versión

Por defecto, permite seleccionar Git o Ninguno. Indica si se deben crear los metadatos para un sistema de control de versiones. Si se selecciona Ninguno, no hace nada, pero si se selecciona Git crea un par de ficheros de configuración extra: .gitignore y .gitattributes, útiles si se usa Git como control de versiones.
Nosotros recomendamos el uso de Git para poder crear versiones del proyecto y revertir cambios de manera fácil, incluso si no se trabaja de manera colaborativa. Sin embargo, no es algo que enseñaremos para nuestro primer proyecto. Puedes elegir Git e ignorar esa configuración extra si no estás usándolo todavía.
Una vez configurada la creación de nuestro proyecto, pulsa en Crear y editar para finalmente crear el proyecto y acceder a la ventana principal del editor.

## Abrir o importar un proyecto existente

Crear un proyecto nuevo es algo que solo que tendremos que hacer una vez al principio de la vida de un proyecto. Si cerramos Godot y luego queremos volver a abrirlo para continuar nuestro trabajo, usaremos la lista de proyectos locales del diálogo principal del Administrador de proyectos:
Desde esta pantalla tenemos varias opciones a la izquierda:
* Editar: Después de seleccionar un proyecto existente de la lista de proyectos a la izquierda, lo abrirá con la ventana principal del editor
* Ejecutar: Lo ejecuta sin mostrar la ventana de edición
* Renombrar: Cambia el nombre de nuestro proyecto por otro que deseemos
* Administrar Etiquetas: Añade, quita o edita una serie de palabras clave que podemos usar para clasificar o dar propiedades a nuestros proyectso. Por ejemplo, podemos ver que el proyecto "Dodge the Creeps" viene por defecto con las tags: 2d, demo y official. Solo se pueden añadir etiquetas en minúscula y sin espacios.
* Eliminar: Elimina el proyecto del listado (no elimina los archivos)
* Eliminar Faltantes: Si existiera una referencia antigua o inválida de un proyecto en el listado que no se ha encontrado, las borra todas (del listado). Útil cuando se ha movido la ruta de una serie de proyectos, o han cambiado de alguna forma los proyectos disponibles (por ejemplo, si se ha editado directamente un proyecto en un disco extraíble).
Si hemos descargado un proyecto o borrado accidentalmente del listado, pero Godot no sabe dónde esta y este no aparece en el listado, podemos usar el botón Importar arriba a la izquierda para añadirlo al listado. Podemos, mediante este botón, seleccionar tanto una carpeta de proyecto de nuestro sistema de archivos, un archivo godot.project o un archivo comprimido .zip, el cual se descomprimirá en el lugar que le indiquemos antes de editarlo.
En el listado de la izquierda podremos marcar los proyectos que queramos como favoritos con la estrella de la izquierda para que aparezcan primero en el listado- útil para marcar el proyecto o proyectos que estamos usando actualmente- aunque ya se listan por defecto en el orden de última edición.
El icono que aparece aquí se puede cambiar una vez estamos en la ventana principal del editor en el menú: Configuración del Proyecto > General > Aplicación > Configuración > Icono. Por defecto, el gestor de proyectos añade el icono de Godot (icon.webp).
Para terminar de trabajar con el administrador de proyectos, selecciona "Mi primer juego" y pulsa en Editar para acceder a la ventana principal del editor.