Uso

Los dos lados#

Guitar Pro tiene un lado de jugador y un lado de administrador, y conviene saber cuál es cuál desde el principio:

Las máquinas y las canciones viven en la base de datos y se editan en el juego. Las reglas del juego — ventanas de acierto, puntuación, el escenario, la tienda — viven en config/main.lua y requieren reiniciar el resource.

Empezar una canción#

Acércate a una máquina y pulsa E (o usa ox_target si lo activaste). El jugador se coloca en un pad libre y se abre la lista de canciones. Está agrupada en setlists de seis canciones — OPENING LICKS, AXE-GRINDERS, THRASH AND BURN y más — y cada una muestra cuántas de sus canciones has superado. Cada fila muestra la duración, el número de notas, el nivel del chart y tu mejor partida en él.

Settings tiene tres pestañas: el perfil (las últimas 30 partidas y tu precisión), el ranking (los mejores jugadores) y las teclas. Las teclas de traste y Star Power se reasignan ahí — R las restablece — y se guardan en el juego del propio jugador, no en el servidor, así que cada jugador conserva su distribución en todas las máquinas.

Si la máquina cobra, el precio se cobra cuando empieza la canción. Si te alejas más de unos metros de la máquina, la sesión se cierra sola. Mientras toca, el jugador no puede recibir daño.

Los modos#

Duo y Versus empiezan con una invitación: el anfitrión elige la canción, la dificultad, el modo y el escenario, y el jugador del otro pad recibe un aviso con 30 segundos para aceptar. En una máquina de pago, ambos jugadores pagan cuando se acepta la invitación. En una máquina de dos pads, solo un jugador navega por la lista de canciones a la vez; el otro espera a que termine de elegir.

Jugar#

Cinco carriles, cinco trastes. Las teclas por defecto son A S D F G — verde, rojo, amarillo, azul, naranja — con Space para Star Power. Suena una cuenta atrás de 5-4-3-2-1 y luego las notas bajan por la autopista al ritmo de la canción. Backspace durante una canción pregunta si quieres abandonar; una partida abandonada no se guarda.

Valoraciones#

Cada nota se valora según lo cerca del pulso que se acertó, en milisegundos a cada lado:

Puntuación, racha y Star Power#

score per note = 1000 × judgment weight × streak multiplier × Star Power

El multiplicador de racha sube cada 10 notas seguidas — x2 a las 10, x3 a las 20, x4 a las 30 — y se limita a x4. Un fallo lo reinicia.

El medidor de rock empieza en 50 de 100 y se mueve con cada nota, según las cantidades de arriba. Si se vacía, el jugador es abucheado fuera del escenario y la partida termina ahí — desactívalo con Config.Gameplay.life.failEnabled.

Star Power acumula un cuarto de su medidor por cada frase de 16 notas superada. Cuando el medidor está al menos a la mitad, Space lo activa: la puntuación se duplica además del multiplicador de racha, las luces del escenario se vuelven blanco-azuladas, el público ruge, y un medidor lleno dura 26 segundos. Guardarlo para la parte más densa de una canción es como se baten récords.

Notas y estrellas#

Cada partida superada recibe una nota según su precisión, y una partida abucheada recibe una F:

También gana hasta cinco estrellas — una por cada 50%, 65%, 78%, 88% y 95% de precisión — y las estrellas dan XP y puntos. Una partida fallida no gana ninguna.

Resultados y récords#

La pantalla de resultados muestra la nota, la precisión, la racha más larga, las notas acertadas y el desglose de PERFECT a MISS, y si la partida superó tu mejor marca personal o el récord del servidor. Un nuevo récord del servidor se anuncia a todo el servidor. Luego la pantalla de subida de nivel entrega XP y puntos. Desde los resultados, Enter vuelve a la lista de canciones y G reintenta la misma canción.

Una partida superada siempre supera a una fallida como mejor marca personal, y solo las partidas superadas pueden establecer un récord del servidor. El servidor comprueba cada resultado antes de guardarlo — una partida con más notas que el chart, una puntuación por encima de lo que el chart permite, o un final más rápido que la canción se descarta y no paga nada.

La biblioteca musical#

Se incluyen 18 pistas libres de derechos en songs/, cada una con charts easy, normal y hard ya escritos en database/sql.sql. Cada canción es un archivo de audio en esa carpeta: nada se transmite ni se carga desde internet, y el juego solo reproduce archivos que sirve el propio resource.

Los charts se generan, no se escriben#

No hay archivos de chart que buscar. Cuando un administrador pulsa Generate, el gestor de música analiza el audio y escribe las notas por sí mismo, con una superposición de progreso que nombra cada paso:

1. Decodificando el audio.

2. Análisis espectral (FFT).

3. Detectando ataques — dónde golpean realmente las cosas en la pista.

4. Siguiendo los pulsos y fijando un tempo.

5. Colocando notas sobre esa rejilla, con la densidad de cada dificultad.

6. Guardando el chart en la base de datos.

Se ejecuta una vez por canción, en el juego del administrador — el servidor no procesa audio. A partir de ahí todos leen el chart guardado, y los jugadores en una máquina ven la nueva canción aparecer en su lista al instante. Cada dificultad se califica con un nivel según sus notas por segundo, su tempo y su duración.

La densidad es Config.Beatmap.difficulties. Un cambio solo afecta a los charts generados después — pulsa Regenerate en las canciones que quieras recortar de nuevo. Las pistas con percusión constante dan los mejores charts; las grabaciones ambientales, rubato y en directo poco ajustadas dan al detector de pulsos poco a lo que agarrarse.

Añadir tu propia canción#

1. Pon el audio en songs/

   Se admiten mp3, ogg y wav, y sirve cualquiera de las dos estructuras — el nombre del archivo o el de la carpeta se convierte en el id de la canción:

   songs/My-Song.mp3          → id "My-Song"
   songs/my_song/song.mp3     → id "my_song"

   Usa solo letras, números, _ y -. Los nombres con espacios, acentos o símbolos se renombran automáticamente la próxima vez que se detiene el resource — Más allá.mp3 pasa a ser Mas_alla.mp3.

2. Reinicia el resource

   La carpeta se escanea una vez al arrancar y los archivos los sirve el resource, así que uno nuevo no se ve hasta entonces.

3. Genérala en /guitarmusic

   La canción aparece como not generated. Selecciónala, rellena el nombre y el artista, marca las dificultades que debe ofrecer y pulsa Generate. Cuando termina la superposición, la canción se puede tocar en todas las máquinas.

Editar una canción#

Selecciona cualquier canción en el gestor de música para editarla:

La vista previa que suena en la lista de canciones son los primeros 30 segundos de la ventana de juego. Save Changes se aplica al instante; Regenerate reescribe el chart desde cero.

Delete no elimina nada del disco: el chart se descarta, la canción vuelve a not generated y sale de la lista del juego, pero sigue en el gestor de música para que puedas generarla de nuevo. Para eliminar una canción definitivamente, borra su archivo de audio y reinicia.

Colocar máquinas#

/guitarcreator abre la pestaña Machines: todas las máquinas colocadas en una lista con búsqueda, y un formulario a la derecha. Pulsa + para una nueva y luego Select en Placement. La ventana se cierra y un fantasma transparente de la máquina sigue hacia donde apuntas:

De vuelta en el formulario, rellena el resto y pulsa Save Machine. La máquina aparece para todos al instante y se guarda en guitar_machines.

Selecciona una máquina en la lista para editarla, hacerle Teleport o Delete. Editar o borrar una máquina termina cualquier canción que se esté tocando en ella. Las máquinas colocadas por qs-arcades no aparecen — pertenecen a ese resource.

Máquinas en el config#

Las máquinas listadas en Config.Machines se cargan en cada arranque y no se guardan en la base de datos — útil para un mapa que siempre trae sus máquinas:

Config.Machines = {
    {
        coords = vec3(-1652.1, -1060.3, 13.15), heading = 145.0,
        label = 'Vespucci Arcade',
        players = 2,
        price = 250, paymentMethod = 'money',   -- 'money' (cash) or 'bank'
        allowedModes = { 'solo', 'duo', 'versus' },
    },
}

Dónde se colocan los jugadores#

Config.Pads guarda las posiciones como desplazamientos desde la máquina — una entrada para máquinas de un pad, dos para las de dos. Están calibradas para la máquina incluida. Si cambias Config.MachineModel por tu propio prop, vuelve a medirlas con /guitarpad (consulta Editores en el juego más abajo).

El escenario cinemático#

Con Config.Stage.enabled = true (por defecto), el jugador que toca no mira la máquina — se mira a sí mismo. Se coloca un clon de su personaje en el escenario con su guitarra equipada, y la cámara corta entre planos encuadrados al ritmo de la música. Todo lo del escenario existe solo en la pantalla del intérprete, así que nunca molesta a nadie más; el resto del servidor ve al personaje real en la máquina, con la guitarra colgada, pasando por animaciones de actuación que se vuelven más locas a medida que crece la racha.

El jugador elige un escenario antes de que empiece la canción; en Duo y Versus se usa la elección del anfitrión, y los dos intérpretes se colocan uno al lado del otro. Añadir un escenario es una línea en Config.Stage.stages:

{ id = 'mystage', label = 'My Venue', coords = vec4(0.0, 0.0, 70.0, 180.0) },

Las coordenadas son dónde se coloca el intérprete y hacia dónde mira. Si tus archivos de idioma definen stages.mystage, se muestra esa traducción en lugar de label.

Desactiva Config.Stage.enabled y todos tocan con la cámara de la máquina en Config.Camera — fixed, front, side o dynamic.

Guitarras, niveles y la tienda#

Cada partida guardada da XP, que sube el nivel del jugador, y puntos, que se gastan en la tienda. Ambos se calculan en el servidor a partir de las notas acertadas, las estrellas ganadas, si la canción se superó y si se hizo full combo, y luego se escalan según la dificultad y el modo:

El total se multiplica por la dificultad — easy ×1.0, normal ×1.35, hard ×1.8 — y el modo — Single ×1.0, Duo ×1.1, Versus ×1.25. Una partida tiene un límite de 25,000 XP y 4,000 puntos, así que no se puede farmear nada de una sola vez. La curva de niveles empieza en 1,200 XP y crece un 14% por nivel, hasta el nivel 50.

La tienda#

Se abre con T desde la lista de canciones. Se incluyen siete guitarras, cada una bloqueada por un nivel y un precio en puntos:

Una guitarra comprada se cuelga al instante, y cualquier guitarra que tengas se puede equipar después. La guitarra equipada es la que el jugador lleva al escenario y la que todos los demás le ven en la máquina.

Añadir una guitarra#

Copia una entrada en Config.Guitars y cámbiala:

{
    id = 'my_guitar',               -- never rename it once players own it
    label = 'My Guitar',
    blurb = 'shop.blurb_my_guitar', -- a locale key, or plain text
    price = 5000,
    level = 6,
    image = 'my_guitar.png',
    machine = { model = `my_guitar_prop`, bone = 24817,
        placement = { x = 0.015, y = 0.280, z = 0.100, rx = 9.6, ry = 15.2, rz = 188.7 } },
    stage   = { model = `my_guitar_prop`, bone = 24817,
        placement = { x = 0.015, y = 0.280, z = 0.100, rx = 9.6, ry = 15.2, rz = 188.7 } },
},

machine es lo que ven los demás en la máquina y stage es lo que ve el intérprete en el clon del escenario — normalmente lo mismo. La primera entrada con precio 0 es la inicial gratuita. No adivines los desplazamientos de placement: ajústalos en el juego con /guitarplace. Una guitarra cuya imagen no forma parte de la interfaz muestra una tarjeta NO ARTWORK en la tienda y funciona con normalidad.

Para ajustar a mano el nivel, la XP o los puntos de un jugador, usa /guitarprogress — consulta Comandos y exports.

Editores en el juego#

Los planos de cámara, el público, las posiciones de los jugadores y los desplazamientos de las guitarras en config/main.lua son desplazamientos locales calibrados para los escenarios y props incluidos. Se pueden editar, pero edítalos con estas herramientas en lugar de a mano. Cada una imprime un bloque listo para pegar en la consola F8 — pégalo sobre la entrada correspondiente del config y reinicia.

Referencia de configuración#

Cada opción vive en config/main.lua y se aplica tras reiniciar el resource.