Uso

Las dos ventanas#

Dance Machine tiene dos interfaces, y conviene saber desde el principio cuál es cuál.

Las máquinas, los detalles de las canciones y los charts se guardan en la base de datos y se envían a todos los jugadores conectados en cuanto guardas. Nada de esta página requiere reinicio, salvo añadir un archivo de audio nuevo.

Con qué empieza un servidor nuevo#

Diecinueve pistas originales, cada una con charts Easy, Normal y Hard ya generados una vez importado database/sql.sql. No hay ninguna máquina colocada: la primera la pones tú donde esté tu salón recreativo, club o bar.

Colocar una máquina#

/dancecreator → Machines → +. Rellena el formulario y pulsa Select en Placement: la ventana se cierra y una máquina transparente sigue a donde apunte tu cámara. Nunca se escribe una coordenada para una máquina.

La orientación y el desplazamiento de altura se muestran en la parte superior de la pantalla mientras trabajas, y los botones de la parte inferior siempre muestran las teclas que funcionan en ese momento.

El formulario#

Save Machine la hace aparecer para todos los jugadores a menos de Config.StreamDistance y la guarda en dance_machines, así que vuelve tras cada reinicio.

Gestionar máquinas#

La lista de la izquierda contiene todas las máquinas con un buscador. Cada tarjeta puede teletransportarte hasta ella (tras una confirmación), y al seleccionar una se abre para editarla: cambia cualquier campo, usa Reposition, Save Changes o Delete.

Máquinas en el archivo de configuración#

Las máquinas también se pueden listar en Config.Machines. Se crean en cada inicio a partir del archivo y no se escriben en la base de datos, así que el creador es mejor sitio para cualquier cosa que esperes mover.

Config.Machines = {
    {
        coords = vec3(-1371.56, -470.58, 71.03),
        heading = 145.0,
        label = 'Legion Square',
        players = 2,                          -- 1 = solo only, 2 = enables Duo and Versus
        price = 0,
        paymentMethod = 'money',              -- 'money' (cash) or 'bank'
        allowedModes = { 'solo', 'duo', 'versus' },
    },
}

Dónde se colocan los jugadores#

Config.Pads contiene dónde se pone a cada jugador sobre la máquina, en relación con el prop: una posición para una máquina de 1 jugador y dos para una de 2 jugadores. Un vec3 orienta al jugador hacia la máquina por sí solo; un vec4 fuerza la orientación. Los valores incluidos encajan con la máquina incluida. Si cambias el modelo, colócate en una máquina y usa /dancepad — consulta Comandos y exports.

Añadir canciones#

Cualquier canción de la que tengas los derechos puede convertirse en un chart jugable. El script escucha el audio y escribe las notas por sí mismo.

1. Copia el audio en songs/

   MP3, OGG o WAV, en cualquiera de las dos estructuras:

   songs/
   ├── My_Track.mp3          -- a file on its own: the song id is My_Track
   └── my_track/
       └── song.mp3          -- a folder: the song id is the folder name

   Dentro de una carpeta, el script busca primero song.mp3, song.ogg o song.wav, y después cualquier archivo de audio.

2. Reinicia el recurso

   restart qs-dancemachine. La carpeta se lee una vez cuando se inicia el recurso, y el juego solo sirve los archivos que estaban ahí en ese momento. La consola indica cuántas canciones encontró.

3. Genera el chart

   /dancemusic muestra la nueva canción marcada como not generated. Selecciónala, escribe su nombre y artista, elige las dificultades que pueden escoger los jugadores y pulsa Generate.

4. Júgala

   Cuando termina el análisis, el chart se guarda y la canción aparece en todas las máquinas a la vez — también para los jugadores que ya están en una.

El id de la canción es el nombre del archivo o de la carpeta. Las letras, los dígitos, _ y - se mantienen tal cual; los espacios, los acentos y los símbolos se convierten en guiones bajos, y cuando el recurso se detiene esos archivos se renombran en disco para poder servirse. Mi Canción (Remix).mp3 pasa a ser Mi_Cancion_Remix.mp3. Los jugadores nunca ven el id — ven el nombre que escribes.

Cómo se genera un chart#

La generación se ejecuta en el juego del administrador que pulsa el botón, no en el servidor, así que no le cuesta nada al servidor. Una superposición la sigue fase por fase — tarda desde unos segundos hasta un minuto aproximadamente, según la pista:

Las pistas con un ritmo claro y constante dan los mejores charts. Una canción en silencio, muy corta o sin un ritmo que el análisis pueda seguir se rechaza con un motivo — consulta Errores comunes. Solo un administrador puede generar una canción concreta a la vez.

Editar una canción#

Save Changes aplica los detalles al instante. Regenerate vuelve a analizar la pista — útil tras cambiar Config.Beatmap. Delete saca la canción del juego: su chart se borra y desaparece de la lista de todas las máquinas, pero se queda en el Music Manager, lista para generarse de nuevo. Para quitar una pista definitivamente, borra su archivo de songs/ y reinicia.

Dificultades y niveles de estrellas#

Lo densa que es cada dificultad viene de Config.Beatmap:

maxNps es el máximo de notas por segundo, minGapMs el menor intervalo entre dos notas, y jumps permite dos notas a la vez en los golpes más fuertes. Después cada chart recibe un nivel de estrellas del 1 al 20, calculado a partir de sus notas por segundo, el tempo y la duración — así que una canción Hard rápida y larga tiene más nivel que una lenta y corta. Un cambio en Config.Beatmap se aplica a las canciones generadas o regeneradas después.

Jugar#

Un jugador se acerca a una máquina y pulsa E en el aviso [E] - Pump It Up — o usa la opción de ox_target, cuando el target está activado. Un bailarín se mueve detrás del menú mientras suena una vista previa de la pista seleccionada.

Cada canción muestra su nivel de estrellas y su BPM. Una canción que el jugador nunca ha jugado lleva la etiqueta NEW; una que ya ha jugado muestra su mejor calificación. Alejarse de la máquina cierra el menú.

Los carriles y las teclas#

Las notas salen del centro de la pantalla hacia seis objetivos, tres a cada lado, y se aciertan cuando los alcanzan:

Cada jugador puede reasignarlas en Settings → Keybinds: elige un carril, pulsa la nueva tecla, y R restablece las de por defecto. Las asignaciones se guardan en el propio PC del jugador. Las teclas por defecto con las que empieza cada jugador son Config.DefaultKeys, escritas como códigos de tecla del navegador — 'KeyW', 'ArrowUp', 'Space'.

Notas, valoraciones y puntuación#

Hay tres tipos de nota. Una nota tap se pulsa una vez. Una nota hold se pulsa y se mantiene hasta que llega su cola — soltarla antes cuenta como Miss. Una nota bonus, aproximadamente una de cada 26 taps, vale 2.5× los puntos. Cada acierto se valora según lo cerca del ritmo que caiga:

Una nota vale 1,000 puntos por su valoración, por el multiplicador de combo, que crece un 5% cada 25 notas seguidas hasta 2×. Un Miss rompe el combo. La barra de vida empieza en 50 de 100; si se vacía, se falla la fase. Cada uno de estos números está en Config.Gameplay — life.failEnabled = false permite jugar cada canción hasta el final.

La partida termina con una calificación según la precisión:

ESC o BACKSPACE durante una canción pregunta si quieres salir; una partida abandonada no se guarda. En la pantalla de resultados, ENTER vuelve a la lista de música y G vuelve a jugar la misma canción. Una nueva mejor marca personal o un récord del servidor se anuncia ahí mismo.

Modos de juego#

Duo y Versus necesitan una máquina 2 Players que los permita y un segundo jugador en el menú de canciones; hasta entonces muestran FREE PAD y no se pueden elegir. Una partida de dos jugadores funciona así:

1. Un jugador elige

   Quien pasa primero a los modos controla la selección; al otro se le pide que espere a que termine. Elige la pista, la dificultad, el modo y el escenario, y pulsa Start.

2. Se invita al compañero

   El otro jugador ve una invitación con la canción y el escenario que eligió el anfitrión, y acepta con Start o rechaza con Return. Una invitación sin respuesta caduca tras Config.Multiplayer.inviteTimeoutMs (30 segundos).

3. Ambos pagan y empiezan juntos

   Cada jugador paga el precio de la máquina. Si alguno no puede, la partida no empieza y no se cobra a nadie. Ambos relojes están sincronizados con el servidor, así que la primera nota llega en el mismo momento en las dos pantallas.

Si un compañero se va durante Duo, el otro sigue jugando solo. Si uno se va durante Versus, gana el que se quedó.

El escenario de baile cinemático#

Cuando empieza la canción, la pantalla del jugador deja el salón recreativo. Una copia de su personaje — misma ropa, misma cara — baila en un escenario en algún lugar de Los Santos, grabada desde quince ángulos de cámara que cambian cada 8 beats, con un golpe de zoom en cada beat. Todos los demás siguen viendo al jugador bailando en la máquina. En Duo, la copia del compañero baila a su lado.

El escenario se elige en la pantalla Start con ← →; en una partida de dos jugadores el anfitrión lo elige para ambos. Los pasos de baile cambian cada 8 beats y se vuelven más grandes a medida que crece el combo — más tranquilos por debajo de 8, más animados desde 8, a tope desde 20 (Config.Animations.intensity). Un breve plano orbital del bailarín, de brazos cruzados, cubre la cuenta atrás.

Solo en la pantalla del propio jugador, el menú se ilumina como de día y la canción se juega de noche (Config.DanceStage.forceNight, nightHour) con una corrección de color cinemática (timecycle); la hora del servidor vuelve en cuanto se va. Los recursos habituales de sincronización del clima se pausan durante ese tiempo — consulta Integraciones.

Config.DanceStage = {
    enabled = true,
    default = 'amusement',
    stages = {
        { id = 'amusement', label = 'Funfair', coords = vec4(-1651.27, -1117.60, 13.02, 308.98) },
        { id = 'beach',     label = 'Beach',   coords = vec4(-1520.40, -1395.10, 5.20, 120.0) },
        -- ...
    },
}

Récords y clasificaciones#

Una partida superada siempre gana a una fallida como mejor marca personal, sea cual sea la puntuación, y solo las partidas superadas pueden establecer un récord del servidor.