Exportar el Juego

Esta sección cubre la exportación de tu juego desde RPG Maker y la colocación de los assets en la ubicación correcta para que Ludens pueda compilar.

Exportar desde RPG Maker

1. Abre tu proyecto en RPG Maker MV o MZ.
2. Ve a Archivo > Despliegue (Deployment).
3. Selecciona la plataforma Android / iOS (recomendado). Si no está disponible, selecciona Web Browsers.
4. Exporta el juego.

Diferencias entre MV y MZ

Dependiendo de la versión del motor (MV o MZ), el resultado del despliegue varía:

• RPG Maker MV: El despliegue típicamente genera una subcarpeta www que contiene todos tus assets descifrados y el archivo index.html.
• RPG Maker MZ: Podría generar la carpeta www directamente o solo los archivos raíz.

Lo importante es localizar el directorio donde residen el archivo index.html y los assets del juego.

Importar Assets en Ludens

Este es el paso más crítico.

Sensibilidad a Mayúsculas y Minúsculas

El sistema de archivos de Windows no distingue entre mayúsculas y minúsculas (/Ruta/Ejemplo = /ruta/ejemplo), pero Android e iOS usan sistemas de archivos que sí distinguen entre ellas. Asegúrate de que todas las referencias a archivos en el código de tu juego (imágenes, audios, archivos de datos) utilicen nombres exactamente idénticos. Si un archivo se llama MiImagen.png, debes referenciarlo como MiImagen.png, no como miimagen.png. Esta es una causa muy común de fallos silenciosos en móviles.

Consejo: Puedes utilizar el plugin YDP_CrossAssets para normalizar automáticamente las rutas de archivos y evitar este problema.

Tienes dos opciones válidas para integrar tus assets:

Opción A (Recomendada): Sincronización desde la Carpeta Raíz

1. Navega a la raíz del repositorio del proyecto Ludens.
2. Localiza la carpeta project/www/.
3. Copia el contenido de tu carpeta exportada www dentro de project/www/.

Nota

El sistema de compilación sincroniza automáticamente los assets desde project/www/ hacia la carpeta interna requerida (composeResources/files/www). Esta sincronización solo ocurre si hay archivos en project/www/ adicionales al index.html predeterminado.

Opción B: Colocación Directa en la Carpeta Interna

1. Navega a la carpeta de recursos interna: composeApp/src/commonMain/composeResources/files/
2. Copia la carpeta www completa de tu exportación y pégala dentro de files.

Estructura Interna Obligatoria: Tras usar cualquiera de las opciones, la aplicación espera encontrar el archivo index.html directamente dentro del directorio www interno.

Estructura Esperada (Interna)

• Directoriofiles/

  • Directoriowww/

    • Directorioaudio/

      • …
    • Directoriodata/

      • …
    • Directoriofonts/

      • …
    • Directorioimg/

      • …
    • Directoriojs/

      • …
    • …
    • index.html

Verificación

Después de colocar los archivos, verifica en Android Studio que:

1. La carpeta files/www/ aparece en el explorador del proyecto.
2. El archivo index.html está presente en la raíz de la carpeta www.
3. Todos los subdirectorios del juego (audio/, img/, js/, etc.) están intactos.

Errores Comunes (Pitfalls)

Al importar assets, ten en cuenta estos problemas comunes:

• Archivos Muy Grandes: Los APKs móviles tienen límites de tamaño, y los assets pesados consumirán rápidamente el almacenamiento del teléfono del usuario. Antes de desplegar, comprime agresivamente tus archivos .png (usando herramientas como TinyPNG) y tus archivos de audio .ogg/.m4a.
• Formatos de Audio Faltantes (RPG Maker MV): RPG Maker MV generalmente requiere archivos de audio .m4a (AAC) para compatibilidad móvil, ya que WebViews antiguos pueden tener problemas con .ogg. Asegúrate de que tu proyecto MV contenga ambos formatos en la carpeta audio. RPG Maker MZ, por otro lado, soporta y utiliza .ogg sin problemas.

Siguientes Pasos

Con tus assets en su lugar, procede a configurar y compilar tu aplicación.