Integraciones

Cómo funcionan las integraciones#

Vehicle Keys llega a tu framework y a tu inventario a través de pequeños archivos puente, elegidos al iniciar según lo que ya está en ejecución. Nada más en el script nombra un framework, así que las mismas funciones funcionan en cualquier lugar donde exista un puente.

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

Frameworks#

Qbox se detecta a partir de qbx_core y lo atiende el puente de QBCore, mediante la compatibilidad con qb-core que el propio Qbox proporciona.

Los scripts escritos para qb-vehiclekeys y qbx_vehiclekeys siguen funcionando gracias a una capa de compatibilidad siempre activa — Reemplazar otros scripts de llaves enumera cada evento y export que atiende.

Inventarios#

Cada llave, matrícula y rastreador es un ítem, y una llave solo vale lo que valen los metadatos que el inventario guarda en ella.

En ox_inventory el script registra seis exports de cliente para client.export: useKey, useLockpick, useAdvancedLockpick, usePlate, useGps y useTracker. Ítems de inventario muestra qué necesita cada ítem.

Target#

Config.UseTarget = true activa las opciones de target mediante ox_target o qb-target, el que esté en ejecución:

Sin target, la tienda de copias y el empleado de recuperación muestran un aviso y se abren con E, y la tableta de diagnóstico tiene /diagnostic. Quitar un rastreador no tiene alternativa — necesita ox_target.

Avisos de texto y notificaciones#

Config.TextUI elige cómo se dibujan los avisos — la pista para hacer un puente, el Press E del empleado —:

Las notificaciones pasan por ox_lib, con el título Vehicle Keys. Cada mensaje pasa por una única función en custom/client.lua — cámbiala para usar otro sistema:

-- custom/client.lua
function Notification(msg, kind)   -- kind: 'info' | 'success' | 'error'
    exports['okokNotify']:Alert('Vehicle Keys', msg, 5000, kind)
end

Dispatch policial#

Cuando un puente, una ganzúa o un robo activa su DispatchChance, la alerta sale a través de Config.Dispatch:

Config.Dispatch = 'default'   -- default | qs-dispatch | qs-smartphone | origen

Config.DispatchSettings = {
    Default = {
        Blip = { Sprite = 161, Colour = 1, Scale = 1.2, DurationMs = 20000 }
    },
    QsDispatch = {
        Code = '10-42',
        Snippet = 'Vehicle Theft',
        Blip = { Sprite = 490, Scale = 1.5, Colour = 1, DurationMs = 3 * 60 * 1000 }
    },
    Origen = {
        Type = 'GENERAL'
    }
}

¿Otro sistema de dispatch? server/custom/dispatch/main.lua es abierto: añade una rama a DispatchVehicleKeys que llame a tu recurso con el título, el mensaje y las coordenadas que recibe, y ajusta Config.Dispatch al nombre que elegiste.

Sonidos#

El pitido del mando y el ancla se reproducen mediante interact-sound, así que los archivos están en ese recurso, no en este. Colócalos en la carpeta client/html/sounds/ de interact-sound, con estos nombres:

Sin interact-sound, los sonidos de puertas propios de GTA siguen sonando — a menos que Config.SoundsDisableDefault los silencie.

Garajes, concesionarios y trabajos#

Un coche que otro script genera para un jugador — desde un garaje, en un concesionario, desde un depósito de trabajo — necesita que ese script le entregue su llave. Una sola llamada lo hace, en cualquiera de los dos lados:

-- after spawning the car for this player
local plate = GetVehicleNumberPlateText(vehicle)
exports['qs-vehiclekeys']:GiveServerKeys(source, plate, 'sultan', false)

-- a job van returned
exports['qs-vehiclekeys']:RemoveServerKeys(source, plate, 'sultan')

local plate = GetVehicleNumberPlateText(vehicle)
local model = GetDisplayNameFromVehicleModel(GetEntityModel(vehicle))
exports['qs-vehiclekeys']:GiveKeys(plate, model, false)

-- a job van returned
exports['qs-vehiclekeys']:RemoveKeys(plate, model)

El último argumento, false, omite la llave cuando el jugador ya tiene una para esa matrícula — saca el coche cada día y el inventario seguirá teniendo una sola llave. El export de cliente también permite al jugador conducir de inmediato, sin esperar a que llegue el ítem, para que a nadie se le pida hacer un puente a un coche que le acaban de dar.

Cambios de matrícula#

Cuando se cambia una matrícula, Vehicle Keys actualiza qs-advancedgarages por sí mismo y luego lanza un evento de servidor que cualquier otro script puede escuchar:

AddEventHandler('vehiclekeys:server:plateChanged', function(oldPlate, newPlate)
    -- update your own tables here
end)

Estado del bloqueo#

El servidor recuerda el último estado de bloqueo de cada coche por matrícula. Un garaje que vuelve a sacar un coche puede restaurarlo:

local state = lib.callback.await('vehiclekeys:server:getVehicleLockStateByPlate', false, plate)
if state then
    SetVehicleDoorsLocked(vehicle, state)
end

Editar los puentes#

Estas partes vienen abiertas, así que puedes cambiar cómo se comunica el script con el resto de tu servidor:

Un puente de servidor proporciona estas funciones. Para admitir un framework propio, añádelo a la tabla frameworks al principio de config/main.lua, apuntando a un nombre de carpeta, luego copia el puente más parecido en custom/<that name>/ y cambia las llamadas de dentro.

Idiomas#

Se incluyen 41 traducciones en locales/: árabe (ar), búlgaro (bg), bengalí (bn), catalán (ca), checo (cs), danés (da), alemán (de), griego (el), inglés (en), español (es), estonio (et), persa (fa), finés (fi), francés (fr), hebreo (he), hindi (hi), croata (hr), húngaro (hu), indonesio (id), italiano (it), japonés (ja), coreano (ko), lituano (lt), letón (lv), malayo (ms), neerlandés (nl), noruego (no), polaco (pl), portugués (pt), rumano (ro), ruso (ru), eslovaco (sk), esloveno (sl), sueco (sv), suajili (sw), tailandés (th), turco (tr), ucraniano (uk), urdu (ur), vietnamita (vi) y chino (zh).

Ajusta Config.Locale al código. Para añadir un idioma, copia en.json con el nuevo código, tradúcelo y ajusta el locale — todo lo que falte recurre al inglés, y la interfaz usa el mismo archivo.