Captulo 15 De LSDj a GB Studio (lsdj2uge + hUGEtracker)

Visión general

lsdj2uge convierte las notas y asignaciones de instrumento de un proyecto .sav de LSDj a un archivo .uge listo para hUGEtracker y hUGEDriver, que son compatibles con proyectos de GB Studio. La idea es llevar tus composiciones de LSDj al mundo homebrew de Game Boy con un flujo relativamente directo.

Autoría original: Beatscribe & Ravi P (manual de lsdj2uge). Créditos a SuperDisk (hUGEtracker/hUGEDriver) y Johan Kotlinski (LSDj).

Requisitos

• LSDj (versión reciente). Si tu tema es antiguo, ábrelo en la ROM moderna y vuelve a guardar.
• hUGEtracker instalado (recomendado) para ajustar instrumentos y patrones tras la conversión.
• LSDPatcher (opcional) para organizar/exportar tu .sav.
• Python (en Linux/macOS; en Windows puedes usar los .bat incluidos).

Lo que convierte y lo que no

⚠️ Expectativas realistas: una canción nativa de hUGEtracker siempre sonará más “fiel” en hUGEDriver que una convertida automáticamente.

Prepara tu canción en LSDj

1. Renombra instrumentos siguiendo la plantilla que espera lsdj2uge (p. ej., 12s, 25l, kick, arpma, tri, sin, etc.). Estos nombres guían el mapeo al template de .uge.
2. Evita dependencias complejas de tablas/FX que no tengan equivalente directo.
3. Guarda el proyecto en un .sav reciente.

Conversión con lsdj2uge (CLI)

Ejemplos típicos:

# Windows (shell en la carpeta de lsdj2uge)
python313\python code\lsdj_to_uge.py --file=mitema.sav --song=1 --tempo=4 --out-file=mitema.uge

# Linux/macOS
py code/lsdj_to_uge.py --file=mitema.sav --song=1 --tempo=4 --out-file=mitema.uge

# Información del .sav (útil para ver Wave Frames y slots)
py code/lsdj_to_uge.py --file=mitema.sav --info

# Convertir kits a ruido (coloca percusiones en canal NOISE)
py code/lsdj_to_uge.py --file=mitema.sav --song=1 --tempo=4 --out-file=mitema.uge --kits-to-noise

Parámetros clave: --file, --song (slot), --tempo (1=rápido … 10=lento), --out-file y --kits-to-noise. También puedes usar --mapping-file para reasignar canales.

Mapeo manual (opcional)

Si quieres controlar a qué canal e instrumento de hUGEtracker va cada pista, usa un JSON de mapeo:

[
  {"source_track_num": 1, "target_channel": 1, "target_instrument": 0},
  {"source_track_num": 2, "target_channel": 2, "target_instrument": 0},
  {"source_track_num": 3, "target_channel": 3, "target_instrument": 0},
  {"source_track_num": 4, "target_channel": 4, "target_instrument": 0}
]

• target_channel: 1=Duty1, 2=Duty2, 3=Wave, 4=Noise.
• target_instrument: índice del instrumento en el template .uge (0 = decisión automática).

Limpieza en hUGEtracker

1. Abre el .uge y reproduce. La mayoría de ajustes se hacen en la pestaña Patterns.
2. Si la canción es muy larga y aparece “Song Data Grew Too Big”, borra 2–7 orders del final.
3. Ajusta instrumentos: envelope (Start/Dir/Change), length, duty, 7‑bit noise, y sub‑patterns.
4. Para arpegios rápidos, crea sub‑patterns con saltos de nota (+xx/‑xx) y usa Jxx para bucles.

Kits / samples: opciones

• --kits-to-noise: convierte kits a percusiones en NOISE (sobrescribe lo que haya en ese canal).
• Omitir el flag: intentará usar Wave para simular percusión (resultado variable).
• Si falla la conversión de un kit, prueba a sustituirlo por un kit básico (p. ej., TR‑606) antes de convertir.

Equivalencias de efectos (LSDj ↔ hUGEDriver)

Tempo, octavas y afinación

• En la conversión usa --tempo (1–10). Ajusta después con Fxx en hUGEtracker (F01 rápido … F09 moderado).
• Octavas: Ctrl+Shift+Q/A (subir/bajar) o semitono con Ctrl+Q/A.
• Si algo suena off, aplica micro‑tune con 201/101 puntualmente.

Uso en GB Studio

1. Importa el .uge final a tu proyecto de GB Studio como música.
2. Verifica tamaños y Orders (si la pista es muy larga, recorta o divide por secciones).
3. Prueba en emulador y en hardware real; documenta la consola objetivo (DMG/GBC).

FAQ y errores comunes