Cuxial Gym viene en dos carpetas, necesita ocho items de inventario y crea sus tablas en la base de datos en el primer arranque.

Comprueba las dependencias

Estos recursos tienen que estar instalados y funcionando antes de añadir el gimnasio:

• ox_lib
• oxmysql
• cuxial_bridge, con tu framework
• sleepless_interact
• OneSync activado en el servidor

ox_inventory es recomendable: los suplementos, la recompensa diaria, la tienda, las taquillas y los alijos pasan por el inventario.

cuxial_appearance es opcional. Si está en marcha, los puntos de vestuario abren su armario. Para usar otro recurso de ropa, apunta el vestuario a él en cloakroom.handlers.

Copia los recursos

Coloca las dos carpetas dentro de tu directorio resources. No les cambies el nombre.

• cuxial_gym
• cuxial_gym_assets

Cuxial Gym ocupa el nombre de recurso CuxialGym. No puede haber otro recurso con ese nombre en marcha a la vez.

Añade los items

Copia las ocho entradas de install/items.lua en la lista de items de tu inventario. Con ox_inventory:

ox_inventory/data/items.lua

['gym_iron_surge'] = {
    label = 'Iron Surge',
    weight = 0,
    stack = true,
    close = true,
    description = '+20% de XP de entrenamiento durante 1 hora',
},

Los ocho nombres de item son gym_iron_surge, gym_pump_juice, gym_ripped_recovery, gym_hardcore_stack, gym_beast_mode_fuel, gym_apex_predator, gym_american_mass y gym_king_of_iron.

Añade una imagen por item, con el nombre del item, en ox_inventory/web/images/<item>.webp. El gimnasio lee las imágenes de esa ruta; cambia items.imageUrl si las tuyas están en otro sitio.

Los items no necesitan bloque client ni server. El gimnasio los registra como usables al arrancar.

Define las convars

Todas son opcionales.

server.cfg

# Idioma (se incluyen en y es)
setr ox:locale "es"

# Webhook de Discord para los registros del gimnasio
set cuxial_gym_webhook "https://discord.com/api/webhooks/..."

# Trazas de depuración en la consola
setr cuxial_gym_debug "0"

El webhook va en server.cfg, nunca en shared/config.lua. El nombre de la convar se puede cambiar en logs.convar.

Da acceso al staff

Dos permisos ACE abren los editores de staff. Los jugadores con el permiso admin del framework tienen los dos sin ningún ACE.

server.cfg

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

En Comandos y permisos verás qué abre cada uno.

Arranca los recursos

Arranca los assets antes que el gimnasio, y los dos después de sus dependencias y de tu framework:

server.cfg

ensure ox_lib
ensure oxmysql
# tu framework aquí
ensure ox_inventory
ensure sleepless_interact
ensure cuxial_bridge
# opcional
ensure cuxial_appearance
ensure cuxial_gym_assets
ensure cuxial_gym

No hay SQL que ejecutar. El recurso crea sus siete tablas cuxial_gym_* al arrancar; install/cuxial_gym.sql es solo una referencia.

En el primer arranque, sin zonas en la base de datos, el gimnasio crea además una zona de ejemplo con sus equipos y puntos a partir de data/seed.lua. Desde ese momento manda la base de datos y las zonas se editan en juego.

Comprueba que funciona

1. Entra al servidor y ejecuta /gymcreator. Se abre el editor de zonas con la zona de ejemplo.
2. Abre la zona de ejemplo y teletranspórtate desde el editor a uno de sus equipos. Los equipos están en su sitio.
3. Usa el punto del menú del gimnasio. Se abre el panel con tus estadísticas y la pestaña de membresía. La zona de ejemplo no exige pase; activa el requisito en el editor si lo quieres.
4. Interactúa con una máquina y empieza un ejercicio. Aparece el minijuego; pulsa X para dejar la serie.
5. Ejecuta /gymadmin y crea un negocio; después asígnale la zona.

Siguiente: aprende cómo se usa cada parte en la Guía de funciones, o ajusta el script en Configuración.