Ejemplos

Esta página proporciona ejemplos prácticos para flujos de trabajo comunes al usar Ludens.

Ejemplo 1: Configuración Mínima

La configuración más simple posible — exporta tu juego y compila con ajustes por defecto.

Pasos

1. Exporta tu juego de RPG Maker MV con la opción de despliegue Android / iOS.
2. Copia la carpeta www a:

   composeApp/src/commonMain/composeResources/files/www/

3. Edita ludens.properties:

   ludens.android.id=com.ejemplo.mijuego
   ludens.android.version=1.0.0
   ludens.android.versionCode=1
   ludens.android.name=Mi Juego
   ludens.android.launcherName=Mi Juego

4. Ejecuta:

   ./gradlew assembleDebug

Resultado

Un APK de debug en composeApp/build/outputs/apk/debug/composeApp-debug.apk listo para pruebas.

---

Ejemplo 2: Icono Personalizado y Release Firmado

Un flujo de trabajo completo de producción con branding personalizado.

Pasos

1. Completa la Configuración Mínima anterior.

2. Establece un icono personalizado usando Image Asset Studio:

   • Clic derecho en composeApp/src/androidMain/res
   • Selecciona New > Image Asset
   • Importa el icono de tu juego (recomendado: PNG de 512×512 px)

3. Crea un keystore de firma (si no tienes uno):

   • En Android Studio: Build > Generate Signed Bundle / APK
   • Selecciona APK, clic en Next
   • Clic en Create new… y completa los datos del keystore
   • Guarda el archivo .jks de forma segura

4. Configura la firma:

   keystore.properties

   storePassword=mi_password_seguro
   keyPassword=mi_key_password
   keyAlias=mi_alias
   storeFile=C:/llaves/mi-juego-key.jks

5. Compila el APK release:

   ./gradlew assembleRelease

Resultado

Un APK release firmado en composeApp/build/outputs/apk/release/composeApp-release.apk listo para distribución.

---

Ejemplo 3: Usando el Plugin YDP_Ludens

Integra el plugin recomendado para mejor compatibilidad con WebView.

Pasos

1. Descarga YDP_Ludens.js del repositorio rpgm-plugins.

2. Colócalo en la carpeta js/plugins/ de tu proyecto RPG Maker.

3. Abre tu proyecto de RPG Maker y ve al Gestor de Plugins.

4. Agrega YDP_Ludens y muévelo a la parte superior de la lista de plugins.

5. Guarda y vuelve a exportar el juego.

6. Copia la carpeta www actualizada a Ludens y recompila.

Beneficios

• Corrige errores de verificación de carga de fuentes en versiones antiguas de WebView.
• Habilita funcionalidades adicionales del lado del cliente soportadas por Ludens.

---

Ejemplo 4: Referencia de Estructura de Archivos

Una vista completa de la estructura del proyecto después de la configuración:

• Directorioludens/

  • DirectoriocomposeApp/

    • Directoriosrc/

      • DirectorioandroidMain/

        • Directoriores/

          • Directoriomipmap-mdpi/ Icono de app (48px)

            • …
          • Directoriomipmap-hdpi/ Icono de app (72px)

            • …
          • Directoriomipmap-xhdpi/ Icono de app (96px)

            • …
          • Directoriomipmap-xxhdpi/ Icono de app (144px)

            • …
          • Directoriomipmap-xxxhdpi/ Icono de app (192px)

            • …
      • DirectoriocommonMain/

        • DirectoriocomposeResources/

          • Directoriofiles/

            • Directoriowww/ Tu juego

              • Directorioaudio/

                • …
              • Directoriodata/

                • …
              • Directoriofonts/

                • …
              • Directorioimg/

                • …
              • Directoriojs/

                • Directorioplugins/

                  • YDP_Ludens.js
              • index.html
    • Directoriobuild/

      • Directoriooutputs/

        • Directorioapk/

          • Directoriodebug/ Salida APK debug

            • …
          • Directoriorelease/ Salida APK release

            • …
  • ludens.properties Configuración principal de Ludens
  • gradle.properties Configuración de Gradle
  • keystore.properties Credenciales de firma
  • keystore.properties.template Referencia de plantilla