Visión General

Ludens es un wrapper de Compose Multiplatform desarrollado en Kotlin, diseñado para ayudarte a llevar tus proyectos de RPG Maker MV y MZ a dispositivos móviles. Toma tu exportación de juego HTML5 y la envuelve en una aplicación nativa moderna, brindándote control total sobre la configuración y el despliegue tanto para Android como para iOS.

¿Qué Problema Resuelve?

RPG Maker MV y MZ exportan juegos como aplicaciones web HTML5. Tradicionalmente, distribuir estos juegos a usuarios móviles significaba obligarlos a jugar en línea a través de un navegador, donde los juegos carecen de la experiencia móvil nativa que los jugadores esperan — iconos en la pantalla de inicio, controles en pantalla, ajustes de rendimiento y distribución adecuada como aplicación independiente.

Ludens cierra esta brecha proporcionando un shell nativo ligero construido específicamente para gaming. Carga tu juego en un WebView optimizado y superpone un conjunto completo de funcionalidades de interfaz nativa específicas para móviles.

Características

WebView Optimizado

Tu juego de RPG Maker se ejecuta dentro de un WebView de Android que está profundamente integrado en la interfaz de Compose Multiplatform. Este WebView está configurado específicamente para reducir la latencia táctil y optimizar el renderizado del canvas para juegos. Maneja toda la lógica central y el audio del juego, mientras que la capa nativa de Compose proporciona overlays, ajustes y navegación sin interrumpir el motor.

Controles en Pantalla (Overlay)

Ludens proporciona un overlay de controles en pantalla configurable:

Joystick Virtual — Entrada direccional para el movimiento del personaje.
Botones A, B, X, Y — Botones de acción configurables mapeados a eventos de teclado que el motor de RPG Maker reconoce.
Control de Opacidad — Ajusta la transparencia de todos los controles en pantalla.
Control de Posición — Reposiciona botones individuales según tus preferencias.

Pantalla de Ajustes Completa

La pantalla de ajustes integrada se organiza en cuatro secciones:

Sección	Opciones
Sistema	Tema (Claro / Oscuro / Sistema), Idioma (Sistema / English / Español / 中文 / 日本語 / Português (Brasil) / Русский)
Herramientas	Silenciar Audio, Mostrar FPS, Alternar WebGL, Posiciones de Botones
Controles	Activar/Desactivar, Ajustar Opacidad, Mapeo de Teclas
Acciones	Menú de Acciones Rápidas Configurable (Orden, Habilitar/Deshabilitar)

Menú de Acciones Rápidas

El menú de acciones rápidas proporciona acceso rápido a toggles comunes sin entrar a la pantalla completa de ajustes:

Alternar visibilidad de Controles
Alternar Silencio de Audio
Alternar visualización de FPS
Alternar renderizado WebGL
Abrir Ajustes

El orden y la visibilidad de estas acciones son completamente configurables.

Diagnósticos y Recopilación de Errores de WebView

Cuando está activo, Ludens captura errores de ejecución de JavaScript y fallos nativos de carga de recursos en el WebView. En lugar de fallar silenciosamente o mostrar una pantalla negra, renderiza un diálogo nativo superpuesto con el traceback completo, permitiendo:

Copiar el stack trace técnico completo al portapapeles.
Recargar el WebView y reiniciar el juego instantáneamente.

Generador Automático de Iconos de la App

Ludens incluye un plugin generador de iconos integrado que compila tus assets de icono de inicio para todas las plataformas a partir de una única imagen de origen (SVG o PNG) en project/assets/icons/:

Android: Iconos clásicos, cuadrados y capas adaptativas (primer plano y fondo) en carpetas res mipmap.
iOS: Todos los tamaños necesarios con su manifiesto de catálogo de assets JSON.
Google Play: Icono de la ficha de la tienda de alta resolución.

Configuración Fácil

Todas las propiedades de identidad, recursos y compilación de la aplicación se configuran a través de ludens.properties:

ID de aplicación, versión y nombre (para ajustes de sistema y launcher)
Ajustes del Generador Automático de Iconos (formato, fondo, escala)
Banderas del manifest para modo inmersivo, aceleración por hardware y tráfico HTTP en claro
Selección de idiomas a incluir en la compilación (ludens.languages.available)
Fuentes de título y cuerpo personalizadas, más fallbacks por idioma
Interruptor para el diálogo de diagnóstico de errores en WebView

Sincronización Automática de Recursos

Los assets del juego (project/www/), fuentes personalizadas (project/assets/fonts/) y archivos de traducción localizados (project/assets/languages/) se sincronizan automáticamente a los recursos de Compose durante la compilación, manteniendo limpio tu espacio de trabajo.

Soporte de Plataformas

Plataforma	Estado
Android	Soportado (21+)
iOS	Próximamente (iOS 13+)

Stack Tecnológico

Componente	Versión
Kotlin	2.3.0
Compose Multiplatform	1.9.3
Compose WebView	2.0.3
Virtual Joystick	1.0.0