Generador Simfiles Hibrido

En caso de recibir una advertencia al momento de ejecutar:

Este software trabaja directamente con la generación y modificación de archivos asociados.

Dado que el programa está diseñado para crear, modificar y reescribir contenido rítmico basado en algoritmos avanzados, existe un riesgo inherente de "Falsos Positivos" de seguridad por el antivirus. Usa este programa considerando hacer respaldos de tus archivos.

## ⚙️ Interfaz y Parámetros de Configuración (Los 45 Controles)

La interfaz está dividida lógicamente para facilitar la generación, desde las entradas principales hasta los ajustes más detallados de ritmo y IA.

### A. Inputs Esenciales y Meta-Datos

Estos campos definen qué se va a generar.

1 - Seleccionar Canción: Carga el archivo de audio que servirá como base para la creación de pasos. 

2 - Seleccionar Checkpoint IA: Carga el modelo (checkpoint) generado en la Fase 1. 

3 - Título de la canción:  Nombre que se le asignará a tu pieza musical. Se usa para renombrar los archivos. 

4 - Renombrar archivos: Permite forzar el nombre del archivo de pasos con el título proporcionado. 

5 - Nombre del artista: Nombra el artista de la canción

### B. Control Temporal y Estructura (Timing)

Definen la duración, velocidad base y ajustes temporales de la canción.

 6 - Duración Máxima: Define el tiempo máximo que debe tener el archivo de pasos generado. 

7 - Ajustar Límites en Gráfica Interactiva: El botón te abre una interfaz para colocar las zonas de duración, offset y extensión.

8 - Configuración BPM: Establece los pulsos por minuto (BPM) deseados. Se pueden ajustar con botones incrementales (1 en 1). 

9 - Doble BPM: Si el resultado automático o manual no es satisfactorio, puedes duplicar el BPM aquí antes de generar pasos. 

10 - Aplicar BPM Dinámico: Activa un ajuste que varía el BPM a lo largo de la canción según las fluctuaciones rítmicas del audio. 🛑 Si activas esto, desactiva "Aplicar Velocidad Visual". 

11 - Aplicar Velocidad Visual: Aplica efectos visuales basados en los niveles de ritmo (velocidad) detectados en la canción. 🛑 Si activas esto, desactiva "Aplicar BPM Dinámico". 

17 - Offset de Inicio - Permite definir manualmente el punto exacto donde debe comenzar la generación de pasos, distinto a la duración total. Útil si el inicio es silencioso o no rítmico. 

18 - Detectar Offset Automáticamente: Si está desactivado, debes especificar un offset manual (punto 15). Se recomienda deshabilitar si se conoce el punto de inicio preciso. 

19 - Extensión Final Estética: Permite extender el audio. Ideal para escuchar la "desvanencia" final del track. 

### C. Análisis Rítmico Avanzado (Sensibilidad y Ritmo)

Estos parámetros refinan cómo el sistema interpreta el pulso y la energía de la canción.

12 - Scroll mínimo (Low Sensitivity): Define qué nivel o ritmo se considera una sección lenta o "calmada". En estas zonas aparecerán menos notas. Ajusta la sensibilidad a partes suaves. 

13 - Scroll Máximo (High Sensitivity): Define qué nivel o ritmo se considera una sección rápida o intensa. Aparecerá mayor densidad de notas. Ajusta el umbral para picos rítmicos fuertes. 

14 - Duración transición: Determina cuánto tiempo tardará la herramienta en reajustar la velocidad cuando se usa "Aplicar Velocidad Visual". Controla la suavidad del cambio de ritmo. 

41 - Sensibilidad RMS Mínimo: Establece el parámetro mínimo (RMS) que debe tener una sección para ser considerada rítmicamente notable por la IA. 

42 - Sensibilidad RMS Máximo: Establece el parámetro máximo (RMS) que define el pico de impacto rítmico más fuerte de la canción. 

### D. Ajustes Estilísticos y Procesamiento AI

Controles para mejorar, modificar o controlar la "personalidad" del ritmo generado por IA.

15 - Aplicar Posprocesamiento rítmico - Mejora el resultado bruto de la IA mediante efectos adicionales. Desactivarlo produce un resultado "en crudo". Recomendado activarlo para mejor calidad. 

16 - Recalcular Dificultad Dinámicamente: Permite recalcular la dificultad basándose en las elecciones manuales de usuario (ej: BPM, Scroll Min/Max). Si se desactiva, se usa una configuración fija. 

22 - Temperatura IA: Determina cuán "libre" o creativa puede ser la Inteligencia Artificial al generar los pasos. Un valor alto = más experimentación; bajo = más conservador y predecible. 

43 - Dificultad Techo del Pack: Define el nivel general de dificultad deseado para todo el pack de pasos. Se usa en el recálculo de dificultad (Punto 14). Establece la intención artística del resultado final. 

39 - Potenciar Efectos y Trampas: Activar este campo aplica efectos especiales avanzados a los pasos generados por IA. 

### E. Control de Elementos Rítmicos Especiales (Minas, Fakes, etc.)

Permiten añadir elementos específicos del género de juegos de ritmo para aumentar la complejidad y la variación.

23 - Duración Máxima de Holds: Define el tiempo máximo que puede mantener un paso sostenido (Hold). Controla la duración de las notas largas. 

24 - Máximo de Holds Simultáneos: Determina cuántos pasos sostenidos pueden ocurrir al mismo tiempo. Ideal para quitar o aumentar complejidad en zonas específicas.

25 - 38  (Minas, Fakes, Lifts, Potions, Shields, Rayos, Hiddens): Cada uno de estos grupos controla la probabilidad y el número máximo de un efecto específico por compás generado. Estos son ajustes muy finos para crear patrones específicos (ej: si quieres muchas trampas/minas). 

### F. Controles Finales y Salida

Ajustes finales antes de ejecutar la generación.

44 - Semilla de Generación (Seed): Si introduces un número, el generador intentará crear exactamente los mismos pasos. Guardar la semilla es útil para reproducir resultados perfectos o deseados. 

45 - Restablecer Parámetros: Limpia todos los campos y devuelve a sus valores predeterminados (por default). Recomendado si estás empezando desde cero. 

20, 21 - Banner Graphic / Video de Fondo: Elementos opcionales para la presentación visual del track. No afectan la generación de pasos, solo el output multimedia. 

46 - Procesar y Exportar Dual Pack: Ejecuta todas las configuraciones establecidas para generar el archivo final de pasos (.sm, .ssc). 

47 - Monitor de Densidad en Tiempo Real: Proporciona una interpretación aproximada e inmediata del resultado rítmico que se está generando. Sirve como un feedback visual mientras ajustas los parámetros.