Integraciones

Cómo funcionan las integraciones#

Nada dentro de Robberies Creator sabe qué framework, target, inventario o dispatch usas. A cada uno se llega mediante un pequeño archivo bridge en client/custom/ o server/custom/, sin cifrar y editable, y solo se ejecuta el bridge del recurso detectado. La detección ocurre al arrancar, y la consola muestra lo que eligió.

Cada integración opcional se degrada sin hacer ruido. Un target o dispatch que falta pasa al integrado en lugar de lanzar un error; por eso importa la línea del arranque: es el único sitio que te dice que una capa pasó a standalone antes de que te lo diga un jugador.

Forzar la detección#

Cada capa se encuentra buscando recursos iniciados en orden de prioridad: gana el primero que se encuentra. Para fijar uno a mano, sustituye la llamada de detección en config/main.lua por el id de su lista:

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

-- Manual: skip detection entirely.
Config.Inventory = 'codem'      -- codem-inventory
Config.Dispatch  = 'ps-dispatch'

Merece la pena cuando hay dos candidatos en ejecución a la vez (qs-police-creator tiene prioridad sobre qs-dispatch cuando ambos están en ejecución) o cuando un recurso se ha renombrado en tu servidor. Estos cuatro no están en el panel de ajustes a propósito: los bridges se eligen mientras carga el recurso, así que solo pueden cambiar con un reinicio.

Policía y dispatch#

Dos cosas distintas, configuradas en dos sitios:

El nodo Police Alert envía la llamada desde el cliente del líder a través del dispatch detectado, en la posición del líder o en una fija. Su panel muestra los campos extra que entiende tu dispatch: prioridad e imagen para qs-dispatch y qs-police-creator, escala y duración del blip para cd_dispatch, etc. La alternativa integrada avisa a los nombres de trabajo policiales habituales (police, sheriff, lspd, bcso, sasp, sahp, fib, ranger, trooper, marshal).

Bandas#

El alcance Gang de Set Cooldown y la condición Cooldown necesitan conocer la banda del líder. Se lee en este orden:

1. qs-crime-creator, cuando está en ejecución: su banda, así que todos los miembros comparten el cooldown sea cual sea su trabajo.

2. Tu framework, mediante GetPlayerGang en server/custom/frameworks/. QBCore y Qbox devuelven la banda del jugador; ESX y standalone no devuelven ninguna.

Un jugador sin banda (o con la banda none de QBCore) no recibe cooldown de banda. Para usar otro script de bandas, haz que GetPlayerGang(source) devuelva su nombre o id de banda:

-- server/custom/frameworks/esx.lua (or the bridge you use)
function GetPlayerGang(source)
    local gang = exports['my-gangs']:GetPlayerGang(source)
    return gang and gang.name or nil   -- nil = no gang
end

Disparadores Item Use#

Un disparador Item Use no registra el ítem por sí mismo; escucha a tu inventario y framework para detectar el momento en que se usa cualquier ítem. ox_inventory (y origen), qs-inventory, ESX, QBCore y Qbox se enganchan automáticamente cinco segundos después del inicio. El ítem debe ser usable en tu inventario para que el uso llegue al script.

Notificaciones y sonidos#

Robberies Creator muestra sus propias notificaciones, con el estilo del creador: no hace falta ningún recurso de notificaciones. Cada una reproduce además un breve sonido de interfaz de GTA según su tipo. Config.NotificationSounds en config/main.lua los cambia:

Config.NotificationSounds = nil     -- the built-in sounds
Config.NotificationSounds = false   -- silent

Config.NotificationSounds = {       -- your own; a missing type uses info's
    info    = { name = 'NAV_UP_DOWN',         set = 'HUD_FRONTEND_DEFAULT_SOUNDSET' },
    success = { name = 'MISSION_PASS_NOTIFY', set = 'DLC_HEISTS_GENERAL_FRONTEND_SOUNDS' },
    warning = { name = 'CHECKPOINT_PERFECT',  set = 'HUD_MINI_GAME_SOUNDSET' },
    error   = { name = 'CHECKPOINT_MISSED',   set = 'HUD_MINI_GAME_SOUNDSET' },
}

Otro recurso puede mostrar una de estas notificaciones a un jugador desde el servidor:

TriggerClientEvent('qs-robberies:notify', source, 'The vault is open', 'success', 5000)
-- type: info · success · warning · error

Logs de Discord#

El registro es un nodo, no un archivo de configuración: coloca un nodo Discord Webhook donde quieras un mensaje: al empezar, al tocar un láser, al tener éxito. Cada uno tiene su propia URL de webhook, nombre y avatar del bot, título, descripción, color, pie y miniatura del embed, así que distintos robos pueden publicar en distintos canales. Solo se aceptan direcciones de webhook de discord.com y discordapp.com.

Añadir un backend#

Dar soporte a algo que no está en la lista es un archivo más una línea. Cada bridge empieza con una comprobación, así que solo se ejecuta el elegido:

1. Copia el bridge más parecido

   Copia el archivo más cercano (server/custom/inventory/ox.lua, client/custom/dispatch/standalone.lua) y renómbralo con el nombre de tu recurso.

2. Rellena sus funciones

   InventoryDispatchTarget

   Dos funciones alimentan el selector de ítems. Dar y quitar ítems pasa al framework salvo que definas también Inventory_AddItem, Inventory_RemoveItem, Inventory_HasItem y Inventory_GetItemCount.

   -- server/custom/inventory/myinventory.lua
   if Config.Inventory ~= 'myinventory' then return end
   
   function GetAllItems()
       local items = {}
       for name, data in pairs(exports['my-inventory']:GetItems()) do
           items[#items + 1] = { name = name, label = data.label or name, weight = data.weight or 0 }
       end
       return items
   end
   
   function GetInventoryImagePath()
       return 'nui://my-inventory/html/images/', 'nui://my-inventory/html/images/placeholder.png'
   end

3. Regístralo para la detección

   Añade una entrada a la lista correspondiente al principio de config/main.lua (nombre del recurso y luego id) y reinicia.

   local inventories = {
       { 'ox_inventory', 'ox' },
       -- …
       { 'my-inventory', 'myinventory' },
   }

Idiomas#

Se incluyen veinte traducciones en locales/, que cubren tanto los mensajes del juego como todo el creador:

EN · ES · FR · DE · PT · IT · NL · PL · TR · AR · ZH · JA · KO · RU · SV · DA · NO · CS · RO · HU

Elige uno en /robberiesconfig → General; se aplica en vivo, sin reiniciar. Cualquier texto que falte en una traducción pasa al inglés. Para corregir una expresión, edita el archivo JSON de tu idioma: los archivos no están cifrados.