¡Bienvenido a Cave Engine!

Cave es un motor de juego de escritorio 3D simple y rápido, creado para construir juegos sin tener que pelear con la herramienta primero. El editor te proporciona los bloques de construcción habituales de un motor de juegos comercial, como escenas, entidades, componentes, activos, física, animación, interfaz de usuario, audio, cronogramas, scripting en Python y más, pero el flujo de trabajo está diseñado para mantenerlo directo. No necesitas compilar el código del juego ni esperar la compilación de shaders solo para comenzar a experimentar.

En esta misión de Introducción, irás desde abrir Cave por primera vez hasta crear, probar y exportar un proyecto de juego básico. Esta primera lección trata únicamente sobre instalar correctamente el editor y lanzarlo de forma segura.

Lo Que Necesitas

Antes de comenzar, asegúrate de tener:

• Una licencia válida de Cave Engine.
• Un ordenador con controladores gráficos actualizados: Cave requiere controladores 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 simple como C:\Cave Engine\ es una buena elección. El nombre exacto de la carpeta depende de ti, pero debe ser corto, fácil de encontrar, y no estar dentro de una carpeta de nube sincronizada.

Instalando Cave Engine

Cave Engine se distribuye como una carpeta comprimida (ZIP). Una versión única del motor será compilada y estará disponible para ti a través de nuestro servidor aquí. Es única para ti y compartirla o redistribuirla va en contra de nuestro Acuerdo de Licencia de Usuario Final, por lo que está prohibido.

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 lugares.

Después de extraerlo, la carpeta del motor debe contener el ejecutable del editor, el ejecutable del juego/jugador y carpetas de soporte importantes como Editor y Lib. Los nombres exactos de los archivos pueden variar un poco dependiendo del 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 eliminas archivos aleatorios de la carpeta del motor, el editor puede fallar al abrirse.

Solucionando Problemas con la Ruta de Instalación

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

• Mantén a Cave fuera de OneDrive, Dropbox, Google Drive y carpetas de nube sincronizadas similares.
• Evita extraerlo en el escritorio, especialmente si tu escritorio está sincronizado por OneDrive.
• Evita caracteres no ASCII en la ruta de la carpeta, como letras acentuadas u otros caracteres especiales del idioma.
• Mantén la ruta razonablemente corta.
• Evita carpetas que estén marcadas como fuera de línea, virtuales o solo en la nube.

Ejemplo bueno:

C:\Cave Engine\

Ejemplos arriesgados:

C:\Users\YourName\OneDrive\Desktop\Cave Engine\
C:\Users\YourName\Desktop Con Acentos\Cave Engine\
C:\Muy\Larga\Ruta\De\Carpeta\Con\Muchas\Muchas\Carpetas\Anidadas\Cave Engine\

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

Iniciando el Editor

Para iniciar Cave, abre el ejecutable Cave Editor dentro de la carpeta del motor. En Windows, esto generalmente se verá como 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 allí, puedes crear un nuevo proyecto, abrir un proyecto reciente o buscar uno existente:

Entendiendo los Archivos Básicos del Motor

Antes de pasar 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 se divide en las herramientas necesarias para crear un juego y el runtime necesario para jugar un juego exportado.

• El ejecutable del editor es la aplicación que utilizas para crear y editar proyectos.
• El ejecutable del juego/jugador es utilizado por los proyectos exportados. Se encarga de ejecutar el juego final para los jugadores.
• La carpeta Editor contiene datos del editor como íconos, activos predeterminados, fuentes, archivos de interfaz y otros recursos que necesita el editor.
• La carpeta Lib contiene las bibliotecas runtime requeridas, incluidos archivos relacionados con Python utilizados 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 juntos los contenidos de la carpeta.

Solucionando Problemas: Problemas Comunes en el Primer Lanzamiento

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

1. El Motor No Se Extrajo Completamente

Si Cave no puede encontrar un archivo requerido como Editor/imgui.ini, probablemente el motor no se extrajo correctamente o el ejecutable se movió lejos del resto de los archivos.

Soluciona esto 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 de nube, carpetas de escritorio sincronizadas, caracteres no ASCII y rutas muy largas.

3. El Antivirus Eliminó o Bloqueó Archivos

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

Cuando tengas dudas, extrae Cave en una carpeta limpia y asegúrate de que todos los archivos del paquete estén todavía allí.

4. Los Controladores Gráficos Están Desactualizados

Cave utiliza un renderizador 3D de escritorio, por lo que tu controlador gráfico es importante. Si el editor se bloquea durante el inicio, abre una ventana en blanco o muestra errores de renderizado, actualiza tu controlador de GPU desde el sitio web del fabricante de la GPU.

Esto es especialmente importante en computadoras portátiles, computadoras más antiguas o instalaciones recientes de Windows.

5. Estás Ejecutando el Archivo Equivocado

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

¿Qué Viene Después?

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

En la siguiente lección, crearás un nuevo proyecto, elegirás una plantilla de inicio, ajustarás el zoom del editor si es necesario, y comprenderás qué genera Cave para ti.