Proyectos

Un proyecto agrupa todos los archivos de tu aplicación: código, imágenes, sprites, mapas, música y salas. Esta guía te explica cómo crear, abrir y gestionar tus proyectos en JARU IDE.

Pantalla de inicio

Al abrir JARU IDE verás la pantalla de inicio del asistente de proyectos.

Desde aquí puedes:

• Abrir un proyecto reciente: En la lista de la izquierda, Recent Projects, aparecen los proyectos en los que has trabajado recientemente. Haz doble clic en uno para abrirlo.

• Crear un proyecto desde un ejemplo: En la lista de la derecha, Example Projects, encontrarás proyectos de ejemplo listos para usar. Al hacer doble clic, el IDE te pide un nombre (propone el del ejemplo) y crea una copia en tu carpeta de proyectos que podrás modificar libremente. Las plantillas StarterPlatformer y StarterTopDown son un punto de partida para un juego con salas: título, salas del editor de escenas, jugador, controles y fin (ver Tu primer juego con salas).

• Crear un proyecto nuevo: Haz clic en el botón New Project para empezar desde cero.

• Abrir otro proyecto: Haz clic en el botón Load Project para buscar un proyecto (su archivo .jpr) en cualquier ubicación de tu ordenador.

Cancel cierra el IDE

Si abres el asistente con Home › Project › New, su botón Cancel cierra JARU IDE entero, sin preguntar. No se pierde nada, porque el proyecto ya estaba cerrado: vuelve a abrir el IDE.

Crear un proyecto nuevo

Cuando hagas clic en New Project, verás el formulario de configuración, en la pestaña Project Configuration.

Información del proyecto

Rellena los siguientes campos:

• Project Name: Elige un nombre que identifique tu proyecto. Tiene que empezar por una letra y no puede llevar espacios ni ninguno de estos caracteres: / \ : * ? " < > |.

• Project Directory: La carpeta donde se guardará el proyecto. Se rellena sola al escribir el nombre: por defecto es Documentos\JARUProjects\<nombre>. Puedes cambiarla con el botón Browse....

• Author: Tu nombre. De entrada pone el de tu usuario de Windows. Va en la cabecera del archivo principal.

• Version: La versión inicial de tu proyecto (por defecto 1.0.0).

• Project Description: Una breve descripción de lo que hace tu proyecto (opcional). También va en la cabecera del archivo principal.

Opciones adicionales

En Additional Options puedes activar estas opciones según tus necesidades:

• Initialize Git repository: Crea un repositorio Git, con su .gitignore, para controlar las versiones de tu código. Requiere tener Git instalado en tu sistema.

• Create README.md file: Añade un archivo de documentación con información básica del proyecto.

• Add license: Incluye un archivo LICENSE. Al activarlo podrás elegir el tipo de licencia: MIT, GPL-3.0, Apache-2.0, BSD-3-Clause o Unlicense.

Finalizar

Cuando todo esté listo, haz clic en Finish. El IDE creará el proyecto y lo abrirá automáticamente.

Estructura de un proyecto

En el explorador de proyectos

El explorador muestra seis carpetas donde organizarás tu trabajo:

• Code: Tus archivos de código (.aru). El archivo principal se crea automáticamente con el nombre del proyecto.

• Images: Las imágenes que usará tu aplicación. Al importarlas (PNG, BMP, JPG o GIF), el IDE las guarda como BMP.

• Sprites: Las definiciones de sprites (.spr), que combinan imágenes con información de regiones y animación.

• Maps: Los mapas de tiles (.map) que dibujas en el editor de mapas.

• Music: Las canciones (.jms) del Music Tracker.

• Scenes: Las salas (.scn) del editor de escenas (ver Tu primer juego con salas).

Estas seis carpetas no se pueden borrar ni renombrar, pero dentro de cada una puedes crear las subcarpetas que quieras.

En el disco

Al crear un proyecto, JARU IDE genera la siguiente estructura de carpetas y archivos:

mi-proyecto/
├── Code/
│   └── mi-proyecto.aru    ← Archivo principal
├── Images/
├── Sprites/
├── Maps/
├── Music/
├── Scenes/
├── Resources/
├── Config/
├── Build/
├── mi-proyecto.jpr        ← Archivo de proyecto
├── README.md              ← (opcional)
├── LICENSE                ← (opcional)
└── .gitignore             ← (opcional, con Git)

Las carpetas Resources, Config y Build son de uso interno del IDE y no aparecen en el explorador de proyectos. La carpeta Build es donde se generan los archivos compilados cuando ejecutas tu programa.

El explorador de proyectos

El panel izquierdo del IDE muestra todos los archivos de tu proyecto organizados en carpetas.

La barra de botones

Los botones de arriba del explorador crean elementos sin abrir el menú. De izquierda a derecha: archivo de código, importar una imagen, sprite, canción, mapa de tiles, sala, carpeta y borrar. Al dejar el ratón encima, cada uno dice lo que hace.

Abrir un archivo

Haz doble clic en cualquier archivo para abrirlo. El IDE abrirá el editor adecuado según el tipo de archivo:

• Los archivos de código (.aru) se abren en el editor de código
• Las imágenes se abren en el editor de imágenes
• Los sprites (.spr) se abren en el editor de sprites
• Los mapas (.map) se abren en el editor de mapas
• Las canciones (.jms) se abren en el Music Tracker
• Las salas (.scn) se abren en el editor de escenas

Menú contextual

Haz clic derecho en el explorador para ver el menú de opciones:

Crear nuevos elementos

• New Source: Crea un nuevo archivo de código (.aru)
• New Image: Abre el editor de imágenes con una imagen nueva
• Import Image: Añade al proyecto una imagen de tu ordenador
• New Sprite: Crea un nuevo sprite (.spr)
• New TileMap: Crea un nuevo mapa de tiles (.map)
• New Music: Crea una nueva canción (.jms)
• New Scene: Crea una nueva sala (.scn)
• New Folder: Crea una subcarpeta

Si tienes una carpeta elegida en el explorador, lo nuevo va dentro de ella. Si no, va a la carpeta de su tipo: un sprite a Sprites, una sala a Scenes…

Otras opciones

• Set Main: Convierte el archivo de código elegido en el archivo principal del proyecto
• Open in Explorer: Abre la ubicación del elemento en el explorador de Windows
• Rename File: Cambia el nombre del archivo (no disponible para carpetas)
• Delete File / Delete Folder: Después de preguntar, manda el elemento a la papelera de Windows, con todo lo que tenga dentro si es una carpeta. En una memoria USB o en una carpeta de red no hay papelera, y se borra del todo.

Nota

Las opciones de renombrar y eliminar solo están disponibles cuando hay un elemento seleccionado. Renombrar solo funciona con archivos, no con carpetas.

Mover archivos

Puedes arrastrar archivos de una carpeta a otra para reorganizar tu proyecto.

Nota

Si la carpeta de destino ya tiene un archivo con el mismo nombre, el IDE mostrará un error y no permitirá moverlo.

El archivo principal

Todo proyecto tiene un archivo principal que es el punto de entrada de tu programa. Cuando ejecutas el proyecto, la ejecución comienza por este archivo.

Por defecto, el archivo principal se llama igual que tu proyecto y está en la carpeta Code. Por ejemplo, si tu proyecto se llama MiJuego, el archivo principal será Code/MiJuego.aru. Puedes elegir otro con la lista Main File de arriba del explorador o con Set Main en su menú.

El IDE lo crea con una cabecera hecha con los datos del formulario (la descripción, solo si escribiste una):

// MiJuego
// Created: 2026-10-29
// Author: Tu nombre
// Version: 1.0.0
// Description:
// Mi primer juego con JARU

// Your code here
println('Hello World from MiJuego');

Desde el archivo principal puedes importar otros archivos usando import:

import "config.aru"
import "jugador.aru"
import "enemigos.aru"

// Tu código principal aquí

Guardar el proyecto

El proyecto se guarda automáticamente cuando realizas cambios en la estructura (crear, renombrar o eliminar archivos). Los cambios en el contenido de los archivos se guardan con el botón de guardar de su editor (en la mayoría de los editores, también con Ctrl+S). Si cierras un archivo con cambios sin guardar, su editor te pregunta antes si los guardas.

Consejo

Si activaste Git al crear el proyecto, recuerda hacer commits regularmente para no perder tu trabajo.