Instalación

Antes de empezar#

Antes de instalar Dance Machine, asegúrate de que tu servidor cumple los requisitos mínimos. Cuatro cosas son obligatorias — una de ellas viene con el script; todo lo demás es opcional y se detecta solo.

Cada integración opcional se desactiva sin errores. Si falta un recurso, el script recurre a su propio aviso, notificaciones y gestión del HUD — nada da error. Integraciones tiene los detalles.

Descargar Dance Machine#

Tras comprar Dance Machine, el recurso se vincula automáticamente a tu cuenta de CFX Portal.

Inicia sesión en el CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Dance Machine.

Tras extraer la descarga, deberías tener estas dos carpetas:

qs-dancemachine/
├── config/          -- what you may edit
├── custom/          -- framework bridges (editable)
├── client/custom/   -- prompt, notifications, target, weather sync, debug tools (editable)
├── locales/         -- 41 languages
├── songs/           -- the 19 shipped tracks; your own go here too
├── database/        -- sql.sql: the tables and the shipped charts
└── web/             -- the interface

dancemachine-assets/
└── stream/          -- the arcade cabinet and the menu backdrop

Mantén los nombres de ambas carpetas tal como vienen. Otros recursos — entre ellos Arcade Creator — acceden al script mediante exports['qs-dancemachine'], y la comprobación de actualizaciones lo busca por su nombre. La máquina solo existe mientras dancemachine-assets está en ejecución.

Instalar el recurso#

Mueve ambas carpetas al directorio de recursos de tu servidor. Pueden estar en cualquier lugar dentro de él, incluida una carpeta de categoría:

resources/
└── [qs]/
    ├── qs-dancemachine/
    └── dancemachine-assets/

Después abre tu server.cfg y asegúrate de que cada dependencia — y todo lo que quieras que se detecte — se inicie antes que Dance Machine:

ensure oxmysql
ensure ox_lib

# Framework
ensure es_extended
# ensure qb-core
# ensure qbx_core

# Optional
ensure ox_target
ensure qs-interface
ensure qs-textui

ensure dancemachine-assets
ensure qs-dancemachine

El orden de carga importa. El framework se detecta en el momento en que se inicia el recurso, así que un framework que se inicia después no se encuentra y las máquinas funcionan en modo standalone — lo que significa que no se cobra a nadie por jugar.

La base de datos#

Dance Machine crea sus cuatro tablas en el primer inicio. No tienes que ejecutar nada para que el script funcione:

Lo que la configuración automática no puede hacer es escribir los charts de las 19 pistas incluidas. Esos están en database/sql.sql. Impórtalo una vez — con phpMyAdmin, HeidiSQL, DBeaver o cualquier gestor de bases de datos — y cada canción incluida se puede jugar en cuanto se inicia el servidor. Si lo omites, las canciones siguen apareciendo en el Music Manager, marcadas como not generated, hasta que generes cada una.

¿Actualizas desde una versión anterior? Las versiones anteriores guardaban la posición de una máquina en columnas separadas cx, cy, cz y heading. El primer inicio mueve cada fila a la nueva columna coords por sí solo e imprime cuántas migró. Tus máquinas, canciones y puntuaciones se conservan.

Conceder acceso de administrador#

Colocar máquinas (/dancecreator) y gestionar canciones (/dancemusic) están protegidos por un permiso ACE, command.dancecreator por defecto. A cualquiera sin él se le indica que no tiene permiso.

add_ace group.admin command.dancecreator allow
add_principal identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx group.admin

Config.Creator = {
    command = 'dancecreator',
    permission = 'dancemachine.machines',
    -- ...
}

Config.Music = {
    command = 'dancemusic',
    permission = 'dancemachine.music',
}

add_ace group.admin dancemachine.machines allow
add_ace group.dj dancemachine.music allow

Configurar el recurso#

Todo se configura en un solo archivo, config/main.lua, y cada sección está comentada. Las máquinas y las canciones no se configuran ahí — se gestionan en el juego.

Los valores que conviene revisar primero:

Config.Locale = 'en'                          -- 41 languages, see Integrations
Config.UseTarget = false                      -- true = ox_target on the cabinet
Config.MachineModel = `qs_arcade_dance_machine_02`  -- or qs_arcade_dance_machine_01

Config.Gameplay.audioOffsetMs = -90           -- more negative if hits feel late

Config.Creator.permission = 'command.dancecreator'
Config.Music.permission = 'command.dancecreator'

Config.Debug.enabled = false                  -- keep it off on a live server

Verificar la instalación#

Reinicia tu servidor y lee la consola. Un inicio correcto se ve así:

[qs-dancemachine:INFO] Locale loaded: en (13 keys)
[qs-dancemachine:INFO] Server framework loaded: esx
[qs-dancemachine:INFO] Loaded 19 song(s) (scanned once at boot)
[qs-dancemachine:INFO] Loaded 0 dance machine(s) from SQL.
[qs-dancemachine:INFO] Started - framework: esx

framework: standalone en un servidor con ESX, QBCore o Qbox significa que el framework se inició después de Dance Machine — muévelo por encima de ensure qs-dancemachine. Una línea amarilla WARN sobre canciones se explica en Errores comunes.

Después entra en tu servidor y completa el primer recorrido:

1. Coloca una máquina

   Escribe /dancecreator, pulsa +, ponle un nombre, pulsa Select en Placement, apunta la máquina fantasma al suelo y haz clic izquierdo. Pulsa Save Machine y aparecerá para todos.

2. Juega una canción

   Acércate a la máquina y pulsa E. Elige una pista con las flechas, pulsa ENTER dos veces, elige un escenario y pulsa Start. Acierta las notas con W A S y ↑ → ↓.

3. Abre el Music Manager

   /dancemusic muestra todas las canciones que encontró el servidor. A partir de ahí, Uso explica cómo añadir tu propia música.

A partir de ahora solo una cosa requiere reinicio: añadir nuevos archivos de audio a songs/. Las máquinas, los detalles de las canciones y los charts se editan en el juego y llegan a todos los jugadores al instante.