Instalación

Antes de empezar#

Antes de instalar Guitar Pro, asegúrate de que tu servidor cumple los requisitos mínimos. Tres dependencias son obligatorias, además del recurso de props que viene en la misma descarga; todo lo demás es opcional y se detecta solo.

No hay integración con el inventario: aquí nada es un ítem. Las recompensas son XP y puntos de tienda, ambos guardados por el propio recurso, y el único dinero que se mueve es el precio por jugar en una máquina. Integraciones tiene los detalles de cada recurso opcional.

Descargar Guitar Pro#

Después de comprar Guitar Pro, 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 Guitar Pro.

Después de extraer la descarga, deberías tener dos carpetas:

guitarpro-assets/      -- the cabinet and guitar props (stream only)
qs-guitarpro/
├── config/            -- main.lua: everything you are meant to change
├── custom/            -- framework bridges (editable)
├── client/custom/     -- notifications, prompt, target and editors (editable)
├── database/          -- sql.sql, with the 18 shipped charts
├── locales/           -- 41 languages
├── songs/             -- the audio, one file per song
└── web/build/         -- the interface, already built

Mantén los nombres de carpeta qs-guitarpro y guitarpro-assets. Otros recursos — qs-arcades entre ellos — llaman a los exports por ese nombre, así que una copia renombrada deja de responderles.

Instalar el recurso#

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

resources/
└── [arcades]/
    ├── guitarpro-assets/
    └── qs-guitarpro/

Después abre tu server.cfg y asegúrate de que todas las dependencias — y todo lo que debe detectar — arrancan antes de Guitar Pro, con los props primero:

ensure oxmysql
ensure ox_lib

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

# Optional
ensure ox_target
ensure qs-interface

ensure guitarpro-assets
ensure qs-guitarpro

El orden de carga importa. El framework se detecta en el momento en que arranca Guitar Pro, así que un framework que arranca después no se encuentra y el script funciona en modo standalone. Si ambas carpetas están en la misma carpeta entre corchetes, ensure [arcades] las cubre, siempre que esa línea vaya después de tu framework.

La base de datos#

Guitar Pro crea sus seis tablas en el primer arranque, así que nada es estrictamente necesario. Aun así, te conviene importar database/sql.sql una vez: además de las definiciones de las tablas, carga las 18 canciones incluidas con sus charts ya generados, para que se puedan jugar desde que arranca el servidor. Ejecútalo con tu gestor de bases de datos habitual: HeidiSQL, phpMyAdmin, DBeaver o Navicat.

Si te saltas la importación no se rompe nada: las 18 canciones simplemente llegan not generated. Aparecen en el gestor de música, pero quedan fuera de la lista de canciones de los jugadores hasta que un administrador pulsa Generate en cada una. Importar el archivo te ahorra esos 18 análisis.

Conceder el permiso del creador#

El creador de máquinas, el gestor de música y el comando de progresión comprueban un mismo permiso ACE, command.guitarcreator. Concédelo en server.cfg:

add_ace group.admin command.guitarcreator allow

add_ace identifier.license:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx command.guitarcreator allow

Reinicia el servidor después de añadirlo. Cada comando puede tener su propio permiso en config/main.lua — Config.Creator.permission, Config.Music.permission y Config.Progression.permission — si quieres staff de canciones que no pueda mover máquinas.

Configurar el recurso#

Todo lo que debes cambiar está en un solo archivo, config/main.lua. Las máquinas y las canciones se gestionan en el juego; el archivo contiene las reglas del juego, el escenario y la tienda. Los valores que conviene revisar primero:

Config.Locale        = 'en'     -- any of the 41 files in locales/
Config.UseTarget     = false    -- true = ox_target instead of the [E] prompt
Config.Stage.enabled = true     -- false = play on the cabinet camera
Config.Gameplay.audioOffsetMs = -90  -- more negative if hits feel late
Config.Debug.enabled = true     -- the in-game editors: turn OFF on a live server

La lista completa de opciones está en Uso → Referencia de configuración.

Verificar la instalación#

Después de completar la instalación, reinicia tu servidor y lee la consola. Un arranque correcto imprime líneas como estas:

[qs-guitarpro:INFO] Server framework loaded: esx
[qs-guitarpro:INFO] Loaded 18 song(s) (scanned once at boot)
[qs-guitarpro:INFO] Loaded 0 guitar machine(s) from SQL.
[qs-guitarpro:INFO] Started - framework: esx

El nombre del framework indica lo que se detectó: esx, qb (QBCore y Qbox), o standalone si ninguno estaba en ejecución cuando arrancó Guitar Pro. Después entra en tu servidor y recorre el primer ciclo:

1. Coloca una máquina

   Escribe /guitarcreator, pulsa + y luego Select en Placement. Apunta con la máquina fantasma, haz clic izquierdo para soltarla, ponle un nombre y pulsa Save Machine.

2. Toca una canción

   Acércate y pulsa E. Elige una canción con las flechas, pulsa Enter, elige Single y un escenario, y tócala con A S D F G.

3. Revisa la música

   /guitarmusic lista las 18 canciones. Cualquiera marcada como not generated significa que sql.sql no se importó: impórtalo, o pulsa Generate en cada una. Uso cubre todo a partir de aquí.

Las máquinas, los precios, los modos, los nombres de canciones, los tempos y las ventanas de juego se editan en el juego y se aplican al instante. Lo único que necesita un reinicio es un archivo de audio nuevo: las canciones las sirve el recurso, así que un archivo que pongas en songs/ aparece tras el siguiente reinicio.