Section 5

Documentación de "Ren'Py RhythmBeats!"

Sección 5: ¿Cómo crear beatmaps?

---

¡Descargas disponibles! Obtén el Kit de desarrollo de Ren'Py RhythmBeats! desde este lanzamiento

---

En este documento podrás encontrar un tutorial para que puedas crear secuencias de Beatmaps y utilizarlas con Ren'Py RhythmBeats!

Antes de comenzar el tutorial, debes tener las siguientes consideraciones para crear tus beatmaps:

• Los beatmaps deben hacerse manualmente (al menos por ahora). Esto quiere decir de que debes utilizar algún software musical que te permita crear secuencias con instrumentos, como FL Studio (Mobile o Desktop), Abbleton, etc, y crear a oído los patrones de toques.

• Debes descargar la herramienta de conversión beatmap.exe para hacer las conversiones de beatmaps. Arriba está el link de descarga.

---

1. Creando la secuencia del Beatmap en un DAW de producción musical.

En este ítem usaré de ejemplo al DAW "FL Studio Mobile", disponible para Android, iOS y Windows App (UWP).

Nota: Si no puedes pagarlo, he incluido el APK + OBB de FL Studio Mobile en el kit de creación de beatmaps. Shhhh... es un secreto XD.

Hice un video tutorial de 3 a 4 minutos, donde te explico cómo usar Drums (tambores) en FL Studio Mobile para crear beatmaps.

[Toca aquí o en la miniatura para ver el video]

Sintetizando el video, debes hacer lo siguiente:

• Crear un canal de Drums con solo 2 instrumentos, ya que "Ren'Py RhythmBeats!" solo admite 2 pistas en la cascada de notas musicales. Se recomienda usar secuencias de Drums (tambores o instrumentos de percusión) para crear los taps de tus beatmaps. Se puede percibir mejor las marcas con estos instrumentos, además, por algo los juegos de ritmo tienen SFX de panderos o de claps al tocar las notas, ¿no crees?

• Agregar un archivo de audio en otro canal para reproducirlo en paralelo y así crear tu secuencia de taps.

• Sincronizar los BPM del metrónomo con los BPM de la canción que quieres incluir en tu juego. De esa forma la malla de la línea de tiempo queda más alineado para colocar los taps.

• Apagar todos los canales, a excepción del canal de Drums y el canal MASTER (que no se puede desactivar, ya que es el control maestro del proyecto xd).

• Exportar la secuencia como archivo MIDI, y opcional, guardar el proyecto como FLM para acceder a la secuencia más tarde.

Para usuarios de "FL Studio Mobile" en Android:

para incluir archivos de audio como una canción a un proyecto de FL Studio Mobile, necesitas colocar ese archivo de audio dentro de la ruta /storage/emulated/0/FLM User Files, pues esa carpeta es donde FL Studio Mobile puede leer y guardar archivos.

(FL Studio crea esa carpeta dentro de tu almacenamiento interno cuando es iniciado por primera vez.)

---

2. ¿Cómo usar la herramienta `beatmap.exe` para convertir archivos MIDI en Beatmaps (.beat)?

beatmap.exe es un programa CLI (Command Line Interface) que he creado para facilitar el proceso de conversión de archivos .mid (MIDI) hacia un archivo .beat (Beatmap) legible para "Ren'Py RhythmBeats!". Este programa está incluido en el último lanzamiento del módulo de Ren'Py RhythmBeats!

Aquí abajo he creado un tutorial que te puede ayudar a usarlo.

---

2.1. ¿Cómo convertir un archivo MIDI a Beatmap?

• Paso 1:

  Descarga el Kit de desarrollo de Ren'Py RhythmBeats! desde el Pre-Lanzamiento v1.07.1b.

• Paso 2:

  Después de descargar el archivo RBS_Beatmapping_Tools.zip, extrae su contenido en una carpeta que te sea accesible.

  

• Paso 3:

  Busca el ejecutable beatmap.exe dentro de la carpeta Beatmapping Tools y haz doble click sobre el. Debería aparecerte una ventana de terminal similar a esta:

  

• Paso 4:

  Para convertir una secuencia MIDI a BEATMAP, escribe el comando convert. Se desplegará una ventana del explorador para cargar el archivo MIDI en el programa. Selecciona el archivo haciendo doble click sobre el:

  

• Paso 5:

  Si todo salió sin errores, verás una lectura de los pitchs detectados en ese archivo MIDI seguido de que se abrirá una nueva ventana del explorador, donde debes seleccionar el lugar en que debe guardarse el archivo convertido. Por supuesto, debes darle un nombre a ese archivo. La misma herramienta le dará la extensión .beat al guardar.

  

Cuando el proceso haya finalizado verás una lectura con las estadísticas de la secuencia que hiciste, es decir, la cantidad de notas en las pistas (L y R), y el Full Combo que corresponde a la suma de ambas cantidades. Una vez terminado el proceso, ya podrás ver el archivo .beat en el directorio donde lo guardaste.

Este archivo .beat es el que se usa para que el juego pueda mostrar la cascada de notas en pantalla. El contenido son solo números que representan el tiempo donde el jugador debe tocar las teclas.

---

2.2. ¿Cómo obtener las estadísticas de un archivo .beat o .midi sin convertirlo?

La herramienta ofrece un comando de trabajo que abre estos archivos en modo de solo lectura, para mostrar sus estadísticas como la cantidad de notas por pista, el Full Combo y las marcas de tiempo completas.

• Paso 1:

  Ejecuta el programa beatmap.exe y escribe el comando read. Se abrirá una ventana del explorador solicitando un archivo .beat o .midi. Cuando se abra esta ventana, selecciona el archivo que debe cargarse al programa:

  

• Paso 2:

  Si los archivos fueron procesados correctamente, debería visualizarse las estadísticas del Beatmap. Para ver una tabla con el índice y la secuencia completa del beatmap en pantalla, escribe Y y pulsa ENTER.

  

---

3. Errores específicos al convertir un archivo.

Por lo general, los errores en la herramienta son notificados de forma clara. Sin embargo, pueden haber errores emitidos por el procesamiento de archivos MIDI durante la conversión o en actividades de solo lectura. Estos errores son los siguientes:

• Error "IOError('data byte must be in range 0..127')": Este error se da generalmente cuando el archivo MIDI está corrupto o ha sido creado con errores. Una solución posible es que vuelvas a exportar el archivo MIDI desde el programa que estás creando las secuencias.

• Error "Conversión abortada. Se detectaron más de 2 pitchs en la secuencia MIDI.": Este error ocurre cuando creas una secuencia con más de 2 instrumentos en el canal de Drums (u otro canal que estés usando). El sistema rítmico de Ren'Py RhythmBeats solo admite 2 pistas para la cascada de notas en pantalla, por lo que solo puedes usar 2 instrumentos dentro del canal de Drums.

---

4. Librerías de terceros utilizadas en "beatmap.exe".

• pretty_midi:

  pretty_midi es una librería para manipulación de datos MIDI.

• python-tabulate:

  tabulate es una librería que sirve para dar formato de tablas a datos dentro en una interfaz de línea de comandos.

• pyinstaller::

  pyinstaller es una utilidad que permite empaquetar scripts Python (y sus librerías importadas) en un ejecutable de Windows.

---

Hasta aquí llega la documentación de Ren'Py RhythmBeats!

Si tienes dudas acerca de cómo utilizar el módulo, o encontraste un error fatal en el funcionamiento, puedes abrir un post en la sección Discussions > General :3

---

¡Ya has recorrido toda la documentación! ¿Qué quieres hacer ahora?

• Ir al Inicio del repositorio.
• Descargar el Juego demostrativo "Ren'Py RhythmBeats! Game".
• Descargar el Kit de desarrollo de Ren'Py RhythmBeats!