Eclips Engine

Eclips es un motor para hacer novelas visuales, juegos 2D ligeros o las dos cosas juntas: una historia que, cuando lo pide, se vuelve juego por un rato y luego regresa a la historia.

Esta es su primera Technical Preview, versión 0.9.0. Todavía tiene errores, le falta pulido y muchas cosas pueden cambiar. La parte de novela visual está más desarrollada; el gameplay 2D aún tiene bastante camino por delante.

Es una preview para probarlo, romperlo y experimentar con pequeñas ideas o prototipos. Todavía no lo recomiendo para el desarrollo serio de videojuegos.

Qué hay en la descarga

El ZIP del motor incluye:

• El motor, listo para correr en Windows. Descomprimes el zip y abres Eclips.exe. No hace falta instalar nada.
• Una demo jugable, Testigo, con Sol, Luna y Estrella: novela visual con elecciones y varios finales, y tramos 2D vistos desde arriba y de lado. Puedes jugarla para explorar algunas posibilidades del motor; una ruta dura alrededor de media hora. Está disponible en español e inglés.
• Sus guiones, en texto y comentados (en la carpeta vnscript/), para explorar cómo está hecha la demo. Ábrelos, lee sus comentarios, cambia algo en una copia y vuelve a abrir el juego.
• Los dos manuales: el de EclipScript, para la historia (ECLIPSCRIPT_DOCS.md), y el de los mapas 2D y Lua (VOCABULARIO_2D_ECLIPMAP.md).
• Una guía corta con los controles (GUIA.md).

La extensión opcional de VS Code se descarga por separado como eclips-engine-0.1.0.vsix. Para jugar basta con el ZIP del motor. El código fuente se obtiene en GitHub.

Cómo se hace un juego con Eclips

• Puede ser sólo novela visual, sólo 2D o las dos cosas mezcladas, como en Testigo. Para un juego sólo 2D, el guion puede ser apenas la línea que abre el primer mapa.
• La historia y el 2D se hablan. Lo que pasa en un mapa lo lee el guion: en Testigo, cuántos golpes te dan en un tramo decide qué escena sigue.
• La historia se escribe en EclipScript, el lenguaje de guion propio de Eclips, pensado para leerse fácil: sol: "Hola." es una línea de diálogo, y elegir abre ramas. Trae escenas, elecciones, variables y condiciones, personajes con expresiones (también armados por partes), fondos y capas, música y sonidos, animaciones y efectos.
• Los tramos 2D van en archivos de mapa (.eclmap): vista de arriba o de lado, con bases para enemigos, proyectiles, habilidades y torres. Lua permite añadir lógica más compleja en esos mapas mediante las funciones que ofrece el motor.
• El look (las cajas, los colores, las fuentes y los menús) va en temas y en pantallas que también se escriben como guion.
• Guardar y cargar ya vienen incluidos, con los límites actuales que explico más abajo.

La meta es que puedas trabajar cómodo sin tocar C++. Lo que el motor todavía no trae sí podría pedir escribirlo.

El código está en GitHub: github.com/josedejesusmin-source/Eclips. Ahí también está cómo compilarlo.

Español e inglés

EclipScript admite comandos en español e inglés, y puedes mezclarlos en un mismo guion: por ejemplo, escena/scene, mostrar/show y elegir/choose. Los mapas .eclmap y el archivo de proyecto .eclips también admiten las equivalencias recogidas en los manuales.

Testigo se puede jugar en español o inglés, aunque sus guiones usan principalmente comandos en español. Sus comentarios y la mayor parte de la documentación están en español; el manual de EclipScript incluye algunas explicaciones en inglés.

Extensión de VS Code

Los archivos de Eclips se escriben en texto, así que puedes usar cualquier editor de texto, incluido Bloc de notas. La extensión de VS Code es opcional: añade colores y plantillas para trabajar más cómodo.

Para usarla necesitas VS Code 1.139.1 o una versión compatible posterior.

Con el archivo descargado

1. Descarga aquí eclips-engine-0.1.0.vsix, el archivo de la extensión.
2. Abre VS Code y presiona Ctrl+Shift+P.
3. Escribe VSIX y elige Extensions: Install from VSIX… (instalar desde VSIX).
4. Selecciona el archivo descargado y espera a que termine.

El zip del motor se extrae; el .vsix se elige directamente en VS Code.

Desde el Marketplace

La extensión está publicada en el Marketplace de VS Code. También puedes instalarla sin salir de VS Code:

1. En VS Code, presiona Ctrl+Shift+X para abrir Extensiones.
2. Busca Eclips Engine, del publicador sicigia.
3. Pulsa Instalar.

Comprobar que quedó

En Extensiones, busca Eclips Engine entre las instaladas. Luego abre un .ecl: abajo a la derecha debe decir EclipScript, y el texto tendrá colores según tu tema.

Si dice «Texto sin formato», haz clic en ese nombre y elige EclipScript. También reconoce mapas .eclmap, project.eclips y temas como tema.eclips.

Lo que todavía no es

• Todavía no es un motor maduro para el desarrollo serio de videojuegos: hay errores y partes que seguirán cambiando.
• El gameplay 2D está menos desarrollado que la novela visual y todavía necesita bastante trabajo.
• Por ahora la descarga compilada es para Windows.
• El sistema de texto seguirá recibiendo mejoras.

Problemas conocidos

• El rendimiento del gameplay 2D necesita trabajo. Puede haber un tirón al entrar a un tramo y la velocidad varía entre los equipos en los que lo probé.
• En los tramos 2D, mientras dura una charla, detrás del diálogo se ve negro en vez del mapa. El mapa vuelve al cerrar el diálogo.
• El guardado todavía no conserva toda la composición de una escena: al cargar pueden faltar algunas capas de texto y consolas de escena.

Junto al juego se abre una ventana negra: es la consola del motor. Si la cierras, se cierra el juego. Puede repetir un aviso de dos letras que la demo no usa y que no afecta al juego.

La lista completa de errores, límites y alternativas está en el README de GitHub.

Controles

En la historia

• Avanzar: Espacio, Enter, Z o clic
• Elegir: clic, el número de la opción, o flechas y Espacio
• Pausa: Esc
• Automático: A
• Adelantar el texto: mantener Ctrl
• Guardado y carga rápida: K y L
• Guardar y cargar: F5 y F9
• Historial: rueda del mouse hacia arriba

En los tramos 2D

• Moverse: WASD o flechas
• Saltar (vista de lado): Espacio
• Atacar (vista de arriba): Espacio o F
• Interactuar: E o Enter
• Dash: Shift
• Pausa: Esc

Requisitos

• Windows 10 de 64 bits.
• Gráficos con OpenGL 3.1.
• Unos 132 MB libres para los archivos descomprimidos, más espacio para tus partidas.

Los requisitos mínimos de CPU y RAM todavía no están medidos.

La preview se ha probado en mi HP EliteOne 800 G1 AiO: Intel Core i5-4590S, 8 GB de RAM, Intel HD Graphics 4600 y Windows 10 Pro de 64 bits.

También la probé en una tableta Surface 3. Ahí, en un tramo de gameplay 2D, observé una bajada a unos 35 FPS. Todavía no he identificado la causa. El gameplay 2D es la parte menos desarrollada del motor y seguirá recibiendo mejoras, también de rendimiento.

Créditos

Eclips está hecho con IA. La historia, los diálogos y el arte de la demo son míos. El código y los manuales se escribieron conversando con los modelos de abajo, y muchos de los comentarios de los guiones también; otros comentarios, y las notas, son míos.

Para crear casi todos los sonidos se usó un modelo de IA. Para la música, y para los sonidos de cuando Sol y Estrella se encienden, tenía una dirección de cómo debían escucharse; Opus 5.5 ayudó con los instrumentos y a pulir.

Dirección, guion y arte: yo :b

Con IA:

• Claude (Anthropic): de Sonnet 4.6 a Opus 5.5, en la app y en Claude Code. Fable 5, en los documentos de diseño.
• GPT (OpenAI), en Codex: Sol (GPT-5.6), Luna y Astra. Astra, en los documentos de diseño; hizo además los sonidos de la demo.
• Grok (xAI): Lyra, que implementa; Jarvis, que revisa; y Nexo, que sostiene el trabajo cuando faltan los demás.
• GLM-5.3: una auditoría a ciegas.

Las bibliotecas y las fuentes de terceros tienen su crédito y su licencia en NOTICE, dentro del zip.

Licencias

• El motor es MIT.
• El arte de la demo y el logo de Eclips son CC BY-NC-SA 4.0: puedes hacer mods y fan-works con crédito y la misma licencia, pero no vender ese arte.
• Los sonidos y la música son MIT, como el motor. Las fuentes son OFL. Las licencias de terceros se detallan en NOTICE dentro del ZIP y en THIRD_PARTY_NOTICES.md del repositorio.

¿Encontraste algo?

Abre un issue en el repo: github.com/josedejesusmin-source/Eclips. Si puedes, cuenta qué pasó y cómo llegaste ahí: con eso lo encuentro más rápido. Si sólo quieres comentar, aquí abajo también se puede.

In English

Eclips is an engine for visual novels, light 2D games, or both at once: a story that turns into a game for a while and then goes back to the story. It has its own scripting language, EclipScript, and supports Lua for more complex logic in 2D maps.

EclipScript commands can be written in Spanish or English, and mixed in the same script. The 2D maps and project file also support the equivalents listed in the manuals.

This is its first Technical Preview, version 0.9.0. It has bugs, needs polish and many things may change. The visual novel system is more developed; 2D gameplay still has a long way to go. It is for testing, breaking things and experimenting with small ideas or prototypes. I don't yet recommend it for serious game development.

The Windows ZIP includes the ready-to-run engine and Testigo, a playable demo for exploring some of its possibilities. Its commented scripts show how it works, and both manuals come with it: EclipScript for the story, and the one for 2D maps and Lua. The game is available in Spanish and English. Its scripts mainly use Spanish commands; comments and most of the documentation are also in Spanish, with some English sections in the EclipScript manual.

Extract the ZIP and run Eclips.exe, keeping its files together. You can edit its files with any text editor, including Notepad. The optional VS Code extension adds syntax colors and templates and is a separate VSIX download. The source code is on GitHub.

Requirements: Windows 10 64-bit, graphics with OpenGL 3.1 and about 132 MB of free space. Minimum CPU and RAM requirements have not been measured yet. The preview was tested on my HP EliteOne 800 G1 AiO (Intel Core i5-4590S, 8 GB of RAM, Intel HD Graphics 4600, Windows 10 Pro 64-bit) and on a Surface 3 tablet. On the Surface, one 2D gameplay section dropped to about 35 FPS; I haven't identified the cause yet. 2D gameplay is the least developed part of the engine and will keep improving, performance included.

The engine is MIT; the demo art is CC BY-NC-SA 4.0. Eclips is made with AI. The demo's story, dialogue and art are not: those are mine. The credits above say who did what.