Antes de empezar#
Antes de instalar Gym Creator, asegúrate de que tu servidor cumple los requisitos. Cuatro son obligatorios; todo lo demás es opcional y se detecta por sí solo.
Requisito | Estado | Notas |
|---|---|---|
| Obligatorio | Acceso a la base de datos. |
| Obligatorio | Callbacks, carga de modelos y utilidades compartidas. |
OneSync | Obligatorio | El recurso declara |
Framework | Obligatorio |
|
Target | Opcional |
|
| Opcional | Oculta su HUD mientras el creador está abierto. |
| Opcional | Solo para las misiones de inventario ( |
Todo lo específico de un framework o de terceros está detrás de un pequeño archivo abierto, y el recurso elige el adecuado mirando lo que ya está en ejecución:
Capa | Detectado |
|---|---|
Framework |
|
Target | En orden: |
Inventario |
|
Integraciones tiene los detalles de cada capa y cómo adaptar una a mano.
Descargar Gym Creator#
Después de comprar Gym Creator, el recurso se vincula automáticamente a tu cuenta de CFX Portal.
Inicia sesión en el CFX Portal con la misma cuenta que usaste al finalizar la compra, abre Granted Assets y descarga Gym Creator.
Después de extraer la descarga, deberías tener la siguiente carpeta:
qs-gym/
├── config/ -- main.lua and exercises.lua: what you may edit
├── custom/ -- framework bridges (ESX / QBCore), notifications, HUD
├── client/custom/ -- the target bridge (editable)
├── server/custom/ -- inventory bridges (editable)
├── server/webhooks.lua -- Discord logs
├── database/ -- database.sql
├── locales/ -- 28 languages
└── web/ -- the interface, ready to use (do not edit)El nombre de la carpeta no está fijado en el código:
qs-gymes solo una sugerencia. Usa el mismo nombre enserver.cfg.
Instalar el recurso#
Mueve la carpeta qs-gym al directorio de recursos de tu servidor. Puede estar en cualquier lugar dentro de él, incluida una carpeta de categoría:
resources/
└── [qs]/
└── qs-gym/Una vez copiada, abre tu server.cfg y asegúrate de que cada dependencia, y todo lo que debe detectar, se inicia antes de Gym Creator:
set onesync on
ensure oxmysql
ensure ox_lib
# Framework (one of them)
ensure es_extended
# ensure qb-core
# ensure qbx_core
# Optional: target, interface, inventory
ensure ox_target
ensure qs-interface
ensure qs-inventory
ensure qs-gymEl orden de carga importa. La detección solo ve los recursos que ya están iniciados: un framework que se inicia después de Gym Creator impide que este cargue, y un target que se inicia después no se encuentra, así que se usa en su lugar el aviso integrado de [E].
La base de datos#
Importa database/database.sql en la base de datos de tu servidor con HeidiSQL, phpMyAdmin o la herramienta de base de datos de tu panel. Crea dos tablas:
Tabla | Contiene |
|---|---|
| Cada gimnasio creado en el creador: su nombre, logo, blip, NPC de recepción, estaciones, props, precio y duración de la membresía, multiplicador de estadísticas y ajustes de degradación. |
| La fuerza y la resistencia de cada personaje, su membresía (gimnasio y fecha de vencimiento) y la fecha de su última degradación. |
El archivo usa
CREATE TABLE IF NOT EXISTS, así que importarlo dos veces no causa problemas. Gym Creator no crea sus tablas por sí mismo: si omites este paso, no se cargará ningún gimnasio ni ninguna estadística. Una instalación nueva empieza sin gimnasios: construyes el primero en el juego.
Quién puede abrir el creador#
/gymcreator es donde se construyen los gimnasios, así que está protegido por una comprobación de permisos en el servidor. Un jugador entra por cualquiera de estas vías:
Automático, no hay nada que configurar.
Framework | Considerado admin |
|---|---|
ESX | Grupo |
QBCore / Qbox | El permiso |
Para reconocer otro grupo, mod, por ejemplo, edita playerIsAdmin en custom/esx/server.lua o custom/qb/server.lua.
Config.CreatorJobs en config/main.lua permite que un trabajo construya gimnasios sin ser admin: el trabajo de dueño de gimnasio, un urbanista. grade = false permite todos los rangos; si no, enumera los rangos que pueden entrar.
Config.CreatorJobs = {
{ job = 'gymowner', grade = false }, -- every grade
{ job = 'realestate', grade = { 3, 4 } }, -- only grades 3 and 4
}Los admins siempre ignoran esta lista.
Configurar el recurso#
Los gimnasios en sí (precios, duraciones, multiplicadores, degradación, posiciones) se configuran en el juego, por gimnasio. Los archivos son para el comportamiento de todo el servidor:
Archivo | Contenido |
|---|---|
| Idioma, formato de precios, comando y trabajos del creador, distancia de interacción, valores predeterminados de membresía, el calendario de degradación, estadísticas nativas, la tecla del HUD, depuración. |
| El catálogo de ejercicios: animaciones, props y la recompensa predeterminada de fuerza y resistencia de cada ejercicio. |
| URLs de webhooks de Discord para los registros del creador y de membresías. |
Los valores que conviene revisar primero:
Config.Locale = 'en' -- language, see locales/
Config.CreatorCommand = 'gymcreator' -- opens the creator
Config.TargetDistance = 2.0 -- reach of the receptionist and stations
Config.DefaultMembershipPrice = 2500 -- pre-filled for each new gym
Config.DefaultMembershipDurationDays = 30
Config.StatDecay = { enabled = true, hour = 22, minute = 0 } -- nightly decay, server time
Config.AffectPedStats = true -- push stats to GTA's MP0_STRENGTH / MP0_STAMINA
Config.StatsHUDKey = 'F10' -- toggles the strength / stamina HUD
Config.Debug = falseCada opción se describe en Uso → Referencia de configuración.
Verificar la instalación#
Reinicia tu servidor y lee la consola. Un inicio correcto muestra:
[INFO] Successfully loaded the framework. esx
GYM INFO: Loaded 0 gym(s) from database.La primera línea indica el framework elegido (esx o qb). La segunda cuenta los gimnasios en qs_gyms: cero en una instalación nueva. Si en su lugar ves un error en rojo, ve a Errores comunes.
Después entra en tu servidor y recorre el primer ciclo:
Abre el creador
Escribe
/gymcreator. Si recibes "You do not have permission to use this.", revisa Quién puede abrir el creador más arriba.Construye un gimnasio
Pulsa +, ponle un nombre, coloca el blip, la recepcionista y una estación, y luego pulsa Create gym. Uso explica cada panel.
Compra una membresía
Ve a la recepcionista y elige Purchase Membership. Elige efectivo o banco y confirma.
Entrena
Usa la estación, pulsa
SPACEhasta que la barra llegue al 100 % y luego pulsaF10: tu fuerza y tu resistencia han subido.
A partir de aquí nada necesita reinicio. Cada gimnasio se crea, edita y elimina en el juego, y los jugadores ven el cambio al instante.