Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. La mayoría de estos casos son de orden de carga o de configuración, no fallos, y la consola suele indicar la causa. Cada línea que imprime Gym Creator empieza por GYM INFO:, GYM WARNING: o GYM ERROR:, así que busca primero en la consola GYM.
Instalación y arranque#
El recurso se detiene al arrancar con un error de custom/server.lua o custom/client.lua
No se encontró ningún framework. Gym Creator necesita es_extended, qb-core o qbx_core, y solo detecta uno que ya se haya iniciado: mueve el ensure de tu framework por encima del de Gym Creator en server.cfg. Un framework que se ejecute con otro nombre debe añadirse a la lista en config/main.lua (consulta Integraciones).
"Couldn't start resource" debido a onesync
El recurso declara OneSync como dependencia. Añade set onesync on a server.cfg, o actívalo en txAdmin.
Table 'qs_gyms' doesn't exist
La base de datos no se importó. Ejecuta database/database.sql en tu herramienta de base de datos y reinicia: Gym Creator no crea sus propias tablas.
La consola sigue mostrando GYM INFO: Waiting for db to initialize...
oxmysql no se está ejecutando o se inició después de Gym Creator. ensure oxmysql cerca del principio de server.cfg, y comprueba que su cadena de conexión llega a la base de datos.
GYM WARNING: Using standalone inventory...
Inofensivo. Gym Creator no detectó ningún inventario compatible y, de todos modos, no usa ítems: el aviso es solo informativo.
Locale xx does not exist, falling back to default (en)
Config.Locale indica un archivo que no está en locales/. Usa el nombre del archivo sin .json: 'es', 'pt', 'zh-CN'. Una lista de avisos "missing key" significa que al archivo de idioma le faltan textos más recientes; se muestran en inglés hasta que se traduzcan.
El creador#
"You do not have permission to use this." en /gymcreator
No eres administrador en tu framework ni estás en Config.CreatorJobs. En ESX solo cuentan los grupos admin y superadmin; en QBCore y Qbox, el permiso god o admin, o el ace command. Instalación muestra cómo añadir un trabajo, e Integraciones cómo aceptar otro grupo.
Los agentes de policía pueden abrir el creador
Es el valor predeterminado: Config.CreatorJobs contiene { job = 'police', grade = false }. Elimina la entrada o establece Config.CreatorJobs = {} para que solo accedan los administradores.
Un trabajo en Config.CreatorJobs genera un error
grade debe ser false (todos los rangos) o una lista de rangos como { 2, 3 }. Un número suelto como grade = 3 no se acepta.
"Finish the current action first."
Todavía hay una colocación en curso. Haz clic izquierdo para colocarla o pulsa BACKSPACE para cancelar y luego vuelve a abrir el creador.
"Fill in all required fields." al guardar
Un gimnasio necesita una etiqueta, una etiqueta de blip y coordenadas para el blip y la recepcionista. Cada estación y prop también necesita una posición: pulsa Select en cualquiera que muestre No location selected.
"Model ... does not exist." al colocar un prop
El modelo no está en tu juego. Los modelos vanilla siempre funcionan; uno personalizado debe ser transmitido por un recurso que se inicie antes de Gym Creator.
El marcador de colocación no aparece donde apunto
El puntero sigue lo que alcanza la cámara, hasta 50 metros de distancia. Acércate y apunta a una superficie sólida, como el suelo o una pared.
Gimnasios y membresías#
La recepcionista o una estación no muestra ningún aviso
El recurso de target se inició después de Gym Creator, así que no se detectó y se usa el aviso [E] integrado: mueve su ensure por encima del de Gym Creator. Comprueba también Config.TargetDistance: por defecto, el jugador debe estar a 2 metros o menos.
"You do not have an active membership here."
La membresía del jugador es de otro gimnasio o ha caducado. Un jugador tiene una sola membresía a la vez: comprar una en un segundo gimnasio la traslada allí. Para que un gimnasio sea gratuito, desactiva Requires membership en el creador.
"Not enough money."
La cuenta elegida en la pantalla de membresía (Cash o Bank) tiene menos que el precio.
El botón de compra dice Active y no se puede pulsar
El jugador ya tiene una membresía válida para este gimnasio. Puede volver a comprarla cuando haya pasado la fecha de caducidad que se muestra en la pantalla.
Un gimnasio nuevo no aparece para un jugador
Los gimnasios se envían a un jugador cuando su interfaz se ha cargado. Si la carpeta web/ falta o está incompleta, eso nunca ocurre: vuelve a copiar el recurso completo desde la descarga.
Entrenamientos y estadísticas#
La serie se completa pero las estadísticas no suben
El jugador está en 100, el máximo. Si no, revisa los valores Stamina + y Strength + de la estación en el creador (una estación configurada en 0 no da nada) y el multiplicador del gimnasio.
Las estadísticas bajaron durante la noche
Es el decaimiento diario. Su cantidad es el valor Decay per day del gimnasio del jugador; los jugadores que aún no tienen membresía pierden 5 puntos por noche. Desactívalo por gimnasio o para todo el servidor con Config.StatDecay.enabled = false. Consulta Uso.
El decaimiento no se ejecutó una noche
Se ejecuta en el minuto definido en Config.StatDecay, en la zona horaria del servidor, y no se recupera después. Si el servidor se estaba reiniciando a esa hora, esa noche se omitió.
El personaje mira hacia el lado equivocado o flota en una estación
Edita el gimnasio, pulsa Select de nuevo en esa estación y colócala mientras el clon está en la postura correcta: desplaza para girar, flechas para la altura. Una estación es tan precisa como su colocación.
Un ejercicio omite su animación de inicio o de fin
La consola F8 muestra GYM WARNING: Missing anim dict "...". Los nombres de animación del ejercicio en config/exercises.lua son incorrectos; normalmente se trata de un ejercicio personalizado con una errata.
Los jugadores no corren más tiempo después de entrenar
Config.AffectPedStats es false, u otro script está restableciendo MP0_STAMINA / MP0_STRENGTH. Algunos anticheats y HUD establecen estas estadísticas en valores fijos.
El jugador se queda congelado después de un reinicio
Reiniciar el recurso en mitad de una serie libera al jugador automáticamente. Si sigue congelado, pídele que se vuelva a conectar.
Migración desde 1.x#
Unknown column 'identifier' in 'SELECT'
Esa consulta se escribió para una estructura distinta de gym_data. Realistic Gym guarda cada personaje como citizenid más una columna JSON data: usa las consultas de Migración desde 1.x, que leen esa estructura.
Illegal mix of collations
Tu antigua tabla gym_data usa una collation distinta de la de las tablas nuevas. La consulta de membresías de la página de migración ya la convierte; si escribiste la tuya, añade COLLATE utf8mb4_unicode_ci al join.
Out of range value for column 'membership_expiry'
Una fecha de caducidad de 1.x es posterior al año 2038, normalmente un valor de prueba. Corrige o elimina esa fila en gym_data y vuelve a ejecutar la consulta.
¿Sigues atascado? Abre un ticket con las líneas de la consola de tu servidor que empiezan por
GYM, tu framework y su versión, y tu recurso de target. Una captura de la consola F8 ayuda con cualquier cosa relacionada con la interfaz.