Los fallos más habituales después de instalar Cuxial Gym, con la causa y la solución de cada uno.

El recurso no arranca

Causa. Falta una dependencia o arranca después del gimnasio. Cuxial Gym necesita OneSync, ox_lib, oxmysql, cuxial_bridge, sleepless_interact y cuxial_gym_assets.

Solución. Activa OneSync y arranca antes las dependencias:

server.cfg

ensure ox_lib
ensure oxmysql
ensure sleepless_interact
ensure cuxial_bridge
ensure cuxial_gym_assets
ensure cuxial_gym

Los equipos son invisibles, o los ejercicios no tienen animación ni sonido

Causa. cuxial_gym_assets no está en marcha, se ha renombrado o se subió incompleto. Los props, las animaciones y los sonidos están ahí.

Solución. Vuelve a copiar cuxial_gym_assets desde el paquete original, no le cambies el nombre y arráncalo antes que cuxial_gym. Reinicia el servidor: los assets no siempre se cargan reiniciando solo el recurso.

No hay ningún gimnasio después de instalar

Causa. La zona de ejemplo se crea solo en el primer arranque, cuando la tabla de zonas está vacía. Si en ese momento no había conexión con la base de datos, o la zona se borró después, no hay nada que cargar.

Solución. Ejecuta /gymcreator y crea una zona. data/seed.lua solo se lee en el primer arranque.

/gymcreator o /gymadmin no hace nada

Causa. Una de estas:

• El jugador no tiene ni el ACE ni el permiso del framework.
• El módulo está apagado: /gymcreator necesita modules.creator; /gymadmin necesita modules.admin y modules.business.
• El comando se renombró o se puso a false en commands.
• El jugador está entrenando o ayudando.

Solución. Concede los ACE y revisa el config:

server.cfg

add_ace group.admin cuxial_gym.admin allow
add_ace group.admin cuxial_gym.creator allow

El equipo dice que hace falta membresía

Causa. La zona exige pase y el jugador no tiene.

Solución. Compra un pase en el punto del menú del gimnasio, o abre la zona en /gymcreator y quita el requisito. El staff también puede conceder uno con el export GrantMembership.

El panel o el minijuego no aparecen

Causa. La interfaz no carga. Falta la carpeta web/dist o está incompleta, normalmente por una subida parcial.

Solución. Comprueba que existe web/dist/index.html dentro de cuxial_gym. Si no, vuelve a copiar el recurso desde el paquete original y reinicia el servidor.

El panel se abre a pantalla completa en vez de en la pantalla del gimnasio

Causa. El panel se dibuja en el prop de la pantalla cuando el jugador está a menos de tablet.maxDistance de uno. En el resto de casos se abre a pantalla completa.

Solución. Usa el menú del gimnasio desde un punto que esté junto a un prop de pantalla. Para usar siempre la interfaz a pantalla completa, pon tablet.dui = false. No cambies los demás valores de tablet: corresponden al prop.

Usar un suplemento no hace nada

Causa. El item no existe en el inventario, o el gimnasio arrancó antes que el inventario. La consola muestra el suplemento "<id>" usa un item que no existe por cada item que falta.

Solución. Añade los ocho items de install/items.lua a tu inventario, arranca el inventario antes que cuxial_gym y reinicia el gimnasio.

Los items salen sin imagen en la tienda o en el almacén

Causa. Falta la imagen, o tu inventario guarda las imágenes en otra ruta.

Solución. Añade <item>.webp a la carpeta de imágenes de tu inventario, o cambia items.imageUrl a la ruta correcta. %s se sustituye por el nombre del item.

Las taquillas y los alijos no se abren

Causa. Las taquillas y los alijos requieren ox_inventory.

Solución. Usa ox_inventory, o quita las acciones de taquilla y alijo de los puntos de interacción.

El punto de vestuario no hace nada

Causa. El manejador apunta a un recurso que no está en marcha. El que viene por defecto llama a cuxial_appearance.

Solución. Arranca ese recurso, o cambia cloakroom.handlers a un export o un evento de cliente de tu recurso de ropa.

Falta la tienda, el menú del jefe o la opción de ayudar

Causa. Pertenecen a los módulos de negocio. modules.business = false los quita todos; modules.shop y modules.helper quitan cada uno. Un punto de tienda necesita además que su zona o su punto pertenezca a un negocio.

Solución. Activa los módulos, crea el negocio en /gymadmin y asígnale la zona.

La recompensa diaria dice que no hay stock

Causa. En una zona que pertenece a un negocio, la recompensa sale del almacén del negocio.

Solución. El negocio tiene que pedir o depositar ese item en su almacén.

Los minutos trabajados de un empleado no suben

Causa. Los minutos solo cuentan mientras el empleado está conectado y dentro del área de trabajo del negocio. Un negocio sin área de trabajo no cuenta nada.

Solución. Define el área de trabajo del negocio en /gymadmin.

He cambiado un archivo de datos y en juego no cambia nada

Causa. Esa sección se guardó alguna vez desde un editor. La copia de la base de datos sustituye al archivo.

Solución. Edítala desde /gymcreator o /gymadmin. En el creador, Restablecer valores devuelve una sección a los valores del archivo.

El gimnasio de la playa se ve mal o tiene objetos duplicados

Causa. cuxial_gym_assets incluye un archivo de mapa de esa zona. Otro recurso de mapa que edite el mismo sitio entra en conflicto con él.

Solución. Deja en marcha solo uno de los dos mapas de esa zona.

No llegan los registros a Discord

Causa. La convar no está definida, o se define después de arrancar el gimnasio.

Solución. Pon set cuxial_gym_webhook "..." en server.cfg por encima de ensure cuxial_gym. Con el debug activado, la consola indica si se ha leído el webhook.

Otro recurso no encuentra exports.CuxialGym

Causa. Ese recurso arranca antes que el gimnasio.

Solución. Arranca primero cuxial_gym. Con ese nombre solo están pensados AddSkillToPlayer, GetPlayerSkills y MaxAllSkills; para todo lo demás usa exports.cuxial_gym.