Integraciones

Cómo funcionan las integraciones#

Crime Creator llega a cada recurso de terceros a través de un puente: un pequeño archivo sin cifrar por recurso en client/custom/, server/custom/ o custom/. Cuando el recurso arranca, mira lo que ya está en marcha y activa el puente correspondiente; todos los demás puentes quedan inactivos.

La detección solo ve recursos que ya están iniciados. Todo lo que quieras que se detecte debe estar por encima de ensure qs-crime-creator en server.cfg.

Forzar la detección#

Cada capa es una tabla en config/main.lua que asocia un nombre de recurso con un puente. Si dos candidatos se ejecutan a la vez, o un recurso se ha renombrado en tu servidor, sustituye la línea de detección por el nombre del puente:

-- Auto, the default: the first started resource in the table is used.
Config.Inventory  = DependencyCheck(inventories) or 'standalone'

-- Manual: always use this bridge.
Config.Inventory  = 'ox'
Config.Vehiclekeys = 'qs-vehiclekeys'
Config.Wardrobe   = 'illenium-appearance'
Config.Ambulance  = 'qs'
Config.Dispatch   = 'qs-dispatch'

Un recurso renombrado en tu servidor se arregla igual, añadiendo el nombre de su carpeta a la tabla: ['my-inventory'] = 'ox'.

Recursos compatibles#

Bajas en las guerras de territorio#

Cada servidor informa de las muertes de forma distinta, así que Crime Creator no lo adivina. Para que las bajas cuenten en las guerras de territorio — en la puntuación clásica y en las solicitudes de guerra de Kills — llama a un export desde tu evento de muerte, en el servidor:

-- custom/esx/server.lua (an example is already there, commented out)
AddEventHandler('esx:onPlayerDeath', function(data)
    local victim = source
    local killer = data and data.killerServerId
    if killer and type(killer) == 'number' and killer ~= victim then
        exports['qs-crime-creator']:TerritoryWarOnPlayerKilled(killer, victim)
    end
end)

-- From your hospital / death handler, on the server:
exports['qs-crime-creator']:TerritoryWarOnPlayerKilled(attackerSource, victimSource)

La baja solo cuenta cuando el asesino y la víctima pertenecen a las dos organizaciones en guerra y la víctima está dentro del territorio disputado. El export devuelve true cuando se ha acreditado.

Notificaciones, textos y barras de progreso#

Las tres están en custom/client.lua:

• Las notificaciones usan los toasts propios del script. Hay versiones listas de qs-interface y ox_lib en la función Notification, comentadas — descomenta la que quieras. Otros scripts pueden lanzarlas con el evento crime:notification.

• Los avisos de texto usan qs-textui cuando está en marcha y, si no, ox_lib.

• Las barras de progreso usan qs-interface cuando está en marcha y, si no, el círculo de progreso de ox_lib.

• El menú de interacción F4 — sus opciones, orden e iconos — está en el mismo archivo.

Extras opcionales#

Logs de Discord#

Pega una URL de webhook por categoría en server/webhooks.lua. Una categoría vacía simplemente no se envía.

-- server/webhooks.lua
Config.ShowWebhookIP = false

_G['webhook'] = {
    graffiti = '',
    creator = 'https://discord.com/api/webhooks/...',
    vehicle_purchase = 'https://discord.com/api/webhooks/...',
    pvp_death = '',
    pvp_battle_end = 'https://discord.com/api/webhooks/...'
}

Los logs se ponen en cola y se envían por lotes para que Discord nunca los limite. Las direcciones IP de los jugadores se ocultan salvo que actives Config.ShowWebhookIP.

Idiomas#

Se incluyen 41 traducciones en locales/: ar, bg, bn, ca, cs, da, de, el, en, es, et, fa, fi, fr, he, hi, hr, hu, id, it, ja, ko, lt, lv, ms, nl, no, pl, pt, ro, ru, sk, sl, sv, sw, th, tr, uk, ur, vi y zh. Define Config.Locale en config/main.lua. Cualquier línea que falte en tu idioma usa el inglés, con un aviso en la consola que la nombra.

El dinero en la interfaz se formatea con Config.Intl — define locales (por ejemplo es-ES) y currency (por ejemplo EUR) para adaptarlo a tu servidor.