¡Bienvenido a Cave Engine!

Cave es un motor de juego de escritorio 3D simple y rápido hecho para construir juegos sin tener que lidiar primero con la herramienta. El editor te ofrece los bloques de construcción usuales de un motor de juego comercial, como escenas, entidades, componentes, assets, física, animación, interfaz, audio, líneas de tiempo, scripting en Python, y más, pero el flujo de trabajo está diseñado para ser directo. No necesitas compilar código de juego ni esperar la compilación de shaders solo para empezar a experimentar.

En esta quest de Introducción, pasarás de abrir Cave por primera vez a crear, probar y exportar un proyecto de juego básico. Esta primera lección trata solo de instalar correctamente el editor y lanzarlo sin problemas.

Lo que necesitas

Antes de empezar, asegúrate de tener:

• Una licencia válida de Cave Engine.
• Un equipo con drivers gráficos actualizados: Cave requiere drivers OpenGL 4.3 o superiores para funcionar. Esta API gráfica fue lanzada en 2012, por lo que tu máquina probablemente ya la soporte.
• Una carpeta local normal donde puedas extraer el motor: En Windows, una ubicación sencilla como C:\Cave Engine\ es una buena opción. El nombre exacto de la carpeta es a tu elección, pero debería ser corto, fácil de encontrar y no dentro de una carpeta sincronizada en la nube.

Instalando Cave Engine

Cave Engine se distribuye como una carpeta comprimida (ZIP). Una compilación única del motor será compilada y puesta a tu disposición por nuestro servidor aquí. Es única para ti y compartirla o redistribuirla está prohibido según nuestro Acuerdo de Licencia de Usuario Final.

Para instalarlo, extrae todo el paquete del motor en una carpeta dedicada.

Importante:

• No ejecutes Cave directamente desde el archivo .zip.
• No extraigas Cave en una carpeta que ya contenga archivos no relacionados.
• No dividas los archivos del motor en diferentes ubicaciones.

Después de extraerlo, la carpeta del motor debería contener el ejecutable del editor, el ejecutable de juego/jugador y carpetas importantes de soporte como Editor y Lib. Los nombres exactos de archivos pueden variar un poco según el sistema operativo y la versión del motor, pero la regla importante es simple: mantén la carpeta extraída junta.

> Cave necesita que sus archivos permanezcan en la misma estructura de carpetas. Si mueves, renombras o borras archivos aleatoriamente del motor, el editor podría no abrirse.

Resolviendo Problemas con la Ruta de Instalación

Cave verifica varios problemas comunes con la ruta de instalación cuando inicia. Estos problemas pueden causar fallas, archivos faltantes o comportamientos extraños, especialmente en Windows. Usa una ruta de carpeta que siga estas reglas:

• Mantén Cave fuera de OneDrive, Dropbox, Google Drive y carpetas similares sincronizadas.
• Evita extraerlo en el Escritorio, especialmente si tu Escritorio está sincronizado con OneDrive.
• Evita caracteres no ASCII en la ruta de la carpeta, como letras acentuadas u otros caracteres especiales.
• Mantén la ruta razonablemente corta.
• Evita carpetas marcadas como offline, virtuales o solo en la nube.

Ejemplo bueno:

C:\Cave Engine\

Ejemplos riesgosos:

C:\Users\TuNombre\OneDrive\Desktop\Cave Engine\
C:\Users\TuNombre\Desktop Con Acentos\Cave Engine\
C:\Camino\Muy\Largo\Con\Muchas\Muchas\Carpetas\Anidadas\Cave Engine\

Si Cave muestra una advertencia de "Ruta de instalación inválida", mueve toda la carpeta extraída a una ruta local más limpia y ábrela de nuevo.

Lanzando el Editor

Para iniciar Cave, abre el ejecutable Cave Editor dentro de la carpeta del motor. En Windows, usualmente será un archivo .exe. Puedes crear un acceso directo en el escritorio o anclarlo a la barra de tareas, pero crea el acceso directo al ejecutable en lugar de mover el ejecutable fuera de la carpeta del motor.

Cuando Cave se abra correctamente, deberías ver la ventana del Administrador de Proyectos. Esta es la primera pantalla del editor. Desde ahí, puedes crear un proyecto nuevo, abrir uno reciente o buscar uno existente:

Entendiendo los Archivos Básicos del Motor

Antes de avanzar a lo específico del motor, entendamos un poco mejor los archivos del motor. La carpeta del motor contiene más de un tipo de archivo porque Cave está dividido en las herramientas necesarias para crear un juego y el runtime necesario para ejecutar un juego exportado.

• El ejecutable del editor es la aplicación que usas para crear y editar proyectos.
• El ejecutable de juego/jugador se usa para proyectos exportados. Ejecuta el juego final para los jugadores.
• La carpeta Editor contiene datos del editor como íconos, assets por defecto, fuentes, archivos de interfaz y otros recursos necesarios para el editor.
• La carpeta Lib contiene las librerías runtime requeridas, incluyendo archivos relacionados con Python usados por el sistema de scripting de Cave.

Por ahora no necesitas entender cada archivo en la carpeta. Solo recuerda esta regla:

> Abre el editor desde dentro de la carpeta extraída de Cave y mantén el contenido de la carpeta junto.

Resolución de Problemas: Problemas Comunes al Primer Lanzamiento

Si no aparece el Administrador de Proyectos, o el editor aparece y se cierra inmediatamente, revisa lo siguiente primero:

1. El Motor No Fue Extraído Completamente

Si Cave no encuentra un archivo necesario como Editor/imgui.ini, probablemente el motor no fue extraído correctamente o el ejecutable fue movido fuera del resto de archivos.

Corrígelo extrayendo el paquete completo nuevamente en una carpeta limpia. Luego lanza el editor desde esa carpeta.

2. El Motor Está Dentro de una Carpeta Problemática

Si el editor advierte sobre la ruta de instalación, mueve Cave a una carpeta local más simple. Evita carpetas en la nube, carpetas sincronizadas del Escritorio, caracteres no ASCII y rutas muy largas.

3. El Antivirus Eliminó o Bloqueó Archivos

Algunos antivirus pueden poner en cuarentena archivos de software recién descargado. Si faltan archivos después de la extracción, restaúralos desde la cuarentena del antivirus o descarga y extrae Cave nuevamente.

En caso de duda, extrae Cave en una carpeta limpia y asegúrate de que todos los archivos del paquete sigan ahí.

4. Los Drivers Gráficos Están Desactualizados

Cave usa un renderizador 3D de escritorio, por lo que el driver gráfico es importante. Si el editor falla al arrancar, abre una ventana en blanco o muestra errores de renderizado, actualiza el driver de tu GPU desde la página del fabricante.

Esto es especialmente importante en laptops, computadoras antiguas o instalaciones frescas de Windows.

5. Estás Ejecutando el Archivo Incorrecto

Usa el ejecutable del editor para crear proyectos. El ejecutable de juego/jugador es para correr juegos exportados, no para editar proyectos fuente. Si quieres hacer un juego, abre Cave Editor.

Qué Sigue

Una vez que se abra el Administrador de Proyectos, Cave estará listo para tu primer proyecto.

En la próxima lección, crearás un proyecto nuevo, elegirás una plantilla inicial, ajustarás el zoom del editor si es necesario y entenderás qué genera Cave para ti.