Integraciones

Cómo funcionan las integraciones#

Gym Creator llega a cada recurso de terceros a través de un pequeño archivo abierto (un bridge) y elige el adecuado al arrancar mirando lo que ya está en ejecución. Los bridges no están cifrados, así que todo lo que el script hace con tu framework o tu target se puede leer y cambiar.

El orden de inicio importa. La detección solo ve los recursos que ya están en ejecución, así que cada recurso de esta página debe ir en un ensure por encima de Gym Creator en server.cfg.

Frameworks#

Los pagos usan las cuentas propias del framework: Efectivo es money en ESX y cash en QBCore / Qbox, Banco es bank en ambos.

Un framework renombrado o personalizado#

Si tu core se ejecuta con otro nombre, añádelo a la lista al principio de config/main.lua, apuntando al bridge con el que es compatible:

local frameworks = {
    ['es_extended'] = 'esx',
    ['qb-core'] = 'qb',
    ['qbx_core'] = 'qb',
    ['my-core'] = 'qb',   -- a QBCore fork under another name
}

Para un framework que no es compatible con ninguno, copia custom/qb/ a custom/<name>/, cambia las llamadas de dentro (jugador, identificador, trabajo, dinero, admin) y asigna tu recurso a <name> en la misma lista.

Quién cuenta como admin#

playerIsAdmin en custom/esx/server.lua y custom/qb/server.lua decide quién puede abrir el creador además de los trabajos de Config.CreatorJobs. Para dejar entrar también a los moderadores de ESX:

function framework:playerIsAdmin(source)
    local group = self:getPlayerFromId(source).getGroup()
    return group == 'admin' or group == 'superadmin' or group == 'mod'
end

Sistemas de target#

La recepcionista y cada estación se registran con el primero de estos que esté en ejecución:

Config.TargetDistance (2.0 por defecto) define lo cerca que debe estar un jugador en todos los modos. Las opciones usan el icono fa-solid fa-dumbbell.

Para admitir otro recurso de target, añade una rama a client/custom/target/main.lua. Solo necesita rellenar cinco funciones (addLocalEntity, removeLocalEntity, addBoxZone, removeZone y destroyAll) y añadir su nombre a detect() al principio del archivo.

Notificaciones y el HUD#

Mensajes como "Membership purchased." o "Workout cancelled." se muestran con los avisos propios del script, con el mismo estilo que sus ventanas, así que no hace falta ningún recurso de notificaciones. Para enviarlos por tu propio sistema, reemplaza Notification en custom/client.lua:

function Notification(msg, type)
    exports['okokNotify']:Alert('Gym', msg, 5000, type)
end

Mientras el creador está abierto, el minimapa se oculta, y también el HUD de qs-interface cuando está en ejecución. Eso ocurre en ToggleHud en el mismo archivo, por si quieres ocultar también tu propio HUD.

Misiones de inventario#

Con qs-inventory y su sistema de misiones, define Config.UseInventoryQuests = true y cada serie terminada informará del progreso a estas misiones:

Las misiones en sí se definen en qs-inventory; Gym Creator solo informa a las que existen.

Registros de Discord#

Las acciones del creador y las compras de membresías se pueden publicar en Discord como embeds con el nombre del jugador, su id de servidor y sus identificadores (Steam, Discord, license, FiveM…). Las URLs van en server/webhooks.lua:

Config.ShowWebhookIP = false    -- true adds the player's IP to every log

_G['webhook'] = {
    creator = 'https://discord.com/api/webhooks/...',     -- gyms created, updated and deleted
    membership = 'https://discord.com/api/webhooks/...',  -- memberships bought, with the gym and the price
    exercise = '',
}

Deja una URL vacía y ese registro no se envía. Los registros se ponen en cola y se envían al ritmo de Discord, así que un pico de actividad nunca bloquea el servidor.

Idiomas#

Se incluyen 28 traducciones en locales/: árabe (ar), búlgaro (bg), catalán (ca), checo (cs), danés (da), alemán (de), griego (el), inglés (en), español (es), persa (fa), francés (fr), hindi (hi), húngaro (hu), italiano (it), japonés (ja), coreano (ko), neerlandés (nl), noruego (no), polaco (pl), portugués (pt), rumano (ro), ruso (ru), esloveno (sl), sueco (sv), tailandés (th), turco (tr), chino simplificado (zh-CN) y chino tradicional (zh-TW).

Define el idioma en config/main.lua:

Config.Locale = 'es'

Para añadir otro, copia en.json al nuevo código, tradúcelo y pon Config.Locale con ese código. Todo lo que quede sin traducir vuelve al inglés, y la consola indica qué claves faltan.