Lo que falla con más frecuencia, lo que realmente significa y qué hacer al respecto. La mayoría de estos casos son reglas de la carrera o configuración, no fallos: el mensaje en pantalla suele nombrar la regla. Para cualquier otra cosa, establece Config.Debug = true y lee las líneas RACING en la consola del servidor y en F8.
Instalación y arranque#
La consola repite "Waiting for Framework to load..."
No se encontró ningún framework cuando se inició el recurso, por lo que su puente no pudo cargarse; el primer error encima de la línea repetida lo indica. Asegúrate de que es_extended, qb-core o qbx_core se inicie con ensure antes de qs-advancedracing en server.cfg, y de que su carpeta tenga exactamente ese nombre. Un framework renombrado o diferente necesita su propia entrada; consulta Añadir un framework.
La tabla 'racing_users' (u otra tabla racing_) no existe
race.sql no se importó, o se importó en una base de datos distinta de la de tu cadena de conexión de oxmysql. Impórtalo en la correcta y reinicia.
Unknown column 'image' al crear un circuito
Las últimas líneas de race.sql usan el IF NOT EXISTS de MariaDB, que MySQL 8 rechaza, por lo que la columna de la imagen nunca se añadió. Ejecuta esto una vez:
ALTER TABLE `racing_tracks` ADD COLUMN `image` TEXT NULL DEFAULT NULL;"Automated user not found"
El servidor escribe el organizador Automated en racing_users en cada inicio, y esa escritura falló; el error de la base de datos justo antes lo explica. Corrígelo y reinicia; las competiciones automáticas no funcionan sin esa fila.
La consola está llena de líneas RACING DEBUG
Config.Debug viene como true. Cámbialo a false en un servidor en producción; eso también elimina el comando de prueba /race_cams.
"Locale xx does not exist" o "is missing key"
Config.Locale nombra un archivo que no está en locales/, o a tu archivo le falta una clave añadida en una actualización. El script recurre al inglés para lo que falta; copia las claves indicadas de en.json a tu archivo y tradúcelas.
La tablet#
F10 no abre la tablet
La tecla es un atajo de FiveM guardado por jugador, así que un jugador que la reasignó, o que entró antes de que cambiaras Config.AccessTabletWithKey, conserva su propia tecla. Revisa Settings → Key Bindings → FiveM → Open Racing UI, o escribe /openracingui. Si el comando tampoco existe, Config.AccessTabletWithKey está en nil. Otro script que use F10 también puede quedarse con la tecla primero.
Usar el ítem de la tablet no hace nada
El ítem debe existir en tu inventario con exactamente el nombre de Config.TabletItem, y estar marcado como usable donde tu inventario lo pida; consulta El ítem de la tablet. Si otro script también registra un ítem llamado tablet, solo uno de ellos gana: dale a racing su propio nombre de ítem.
Falta el tipo de carrera Competition
Solo se muestra a los pilotos con una puntuación de al menos Config.CompetitionCreationMinElo (1250) y a los administradores. Baja el valor para abrir las competiciones a más pilotos.
No se puede añadir un circuito a una competición
Solo se listan los circuitos verificados sin ninguna carrera programada. Un administrador verifica un circuito con la marca de su tarjeta. Un circuito que ya tiene una carrera próxima vuelve a aparecer cuando esa carrera termina.
No hay papelera en un circuito
La papelera de la página de un circuito se muestra al piloto que lo construyó.
"This race is about to start. You cannot delete it"
Una carrera no se puede cancelar en sus últimos 5 segundos. Fuera de ese margen, solo su organizador o un administrador puede cancelarla; cualquier otro recibe "Failed to delete the race".
La clasificación o los mejores tiempos de un circuito están vacíos
Ambos provienen de las competiciones. Las carreras normales cambian las puntuaciones pero no registran resultados, y la clasificación solo lista a los pilotos cuyo ranking de competición es superior a 0. Organiza una competición con dos o más pilotos y se llenarán.
La tarjeta del mapa muestra la imagen predeterminada, o ninguna
El circuito no tiene Image Link, o el enlace no lleva directamente a una imagen. Usa un enlace https directo a un archivo .png o .jpg, no a una página que muestre uno. Los circuitos sin imagen usan Config.DefaultBlipImage.
Construir circuitos#
"You need vehicle" y no se puede colocar nada
El creador coloca todo en relación con el coche, por lo que solo funciona desde dentro de un vehículo. Súbete a uno y aparecerá la vista previa de los props.
"Too close to another checkpoint" o "to another object"
Los checkpoints deben estar al menos a 5 metros entre sí, y los props también. Avanza un poco más antes de colocar el siguiente.
"Track is too short"
El primer y el último checkpoint están a menos de 10 metros. En un circuito cerrado, termina la ruta un poco antes de la línea de salida en lugar de sobre ella: la vuelta se cierra por el checkpoint 1 de todos modos.
"Please add at least 1 object"
Un circuito necesita al menos un par de props además de sus checkpoints. Pulsa ENTER en algún punto de la ruta; en la línea de salida funciona bien.
Unirse y competir#
No aparece el aviso para unirse en la línea de salida
El aviso se muestra a un jugador en un vehículo, a menos de 30 metros del checkpoint 1, mientras la inscripción está abierta. La inscripción se cierra a la hora de salida, por lo que no es posible unirse a una carrera que ya ha empezado.
"Your vehicle class is not allowed to join"
La clase de carreras del vehículo debe ser exactamente la de la carrera: un coche X no puede entrar en una carrera S. El mensaje nombra la clase de tu vehículo. Si dice nil, la clase de GTA del vehículo falta en Config.VehicleClasses; los coches de rueda descubierta (clase de GTA 22) son el caso habitual:
Config.VehicleClasses = {
-- ...
[22] = 2, -- Open wheel → X
}"You don't have enough money to join this race"
La inscripción se cobra solo de Config.MoneyType, que por defecto es el efectivo. Un jugador con el dinero en el banco sigue sin poder pagar. Cámbialo a 'bank' si eso encaja mejor con tu servidor.
"Your ELO rating is too low"
La carrera es una competición automática con un minElo, y el piloto tiene una puntuación inferior. Establece minElo = 0 en esa entrada para dejar entrar a cualquiera.
"Track is already in use"
Un circuito admite una carrera a la vez. Espera a que termine la actual o elige otro circuito.
El coche no se mueve después de unirse
Es el comportamiento correcto: los pilotos inscritos se mantienen en la línea hasta la salida, para que nadie salga con ventaja. Pulsa E para abandonar la carrera antes de que empiece; se devuelve la inscripción.
Una carrera nunca termina y su circuito sigue en uso
Una carrera se cierra cuando todos los pilotos que se unieron han terminado o han sido eliminados. Un piloto que se desconecta o cuyo juego se cierra a mitad de carrera nunca informa de ninguna de las dos cosas, así que la carrera sigue esperando. Reiniciar el recurso la elimina; las competiciones y los circuitos guardados se conservan.
El ganador no recibió nada, o menos de lo esperado
Una carrera sin inscripción no paga nada. Con inscripción, cada puesto premiado recibe su parte del importe de la inscripción de Config.Splits, en Config.MoneyType — consulta Pagos.
La puntuación no cambió
Las puntuaciones solo cambian en carreras con dos o más pilotos. El ranking de competición, el número de la clasificación, solo cambia en las competiciones.
"You are already in a race. You cannot preview a track"
La vista previa del GPS mezclaría sus checkpoints con los de la carrera. Abandona o termina la carrera primero.
Competiciones automáticas#
Nunca aparece una competición automática
Necesita un circuito verificado sin ninguna carrera; mientras no haya ninguno, el servidor lo vuelve a intentar cada minuto. Verifica algunos circuitos. Comprueba también que startTime sea una clave de Config.PredefinedTimes; de lo contrario, la consola dice "The defined time does not exist"; que cada entrada tenga su propio id, y que tracks se deje como nil.
Una competición a una hora fija se ejecutó una vez y se detuvo
Las entradas por hora del día se cuentan a partir de la fecha en que se inició el servidor. En un servidor que lleva más de un día encendido, la siguiente fecha ya está en el pasado y la consola lo indica. Un reinicio diario las mantiene en horario.
¿Sigues atascado? Abre un ticket e incluye la consola del servidor desde el inicio del recurso con
Config.Debug = true, tu framework y su versión, y lo que aparecía en pantalla. Una captura de la consola F8 ayuda en todo lo relacionado con la tablet o el HUD de la carrera.