QBESXStandalone
Agency-Vehiclekeys V2 Exports & API
Llaves universales para vehículos de FiveM en QBCore, Qbox, ESX o totalmente independiente.
v2.0.0De pago5 Páginas
01Exports de cliente
| Export | Descripción |
|---|---|
HasKeys(plate) | Es true cuando el jugador tiene una llave para esta matrícula: de propietario, compartida o temporal. Los vehículos de trabajo se abren por su modelo y no se cuentan aquí. |
GetKeys() | Todas las llaves del jugador en una lista de { plate, kind }. kind puede ser owner, shared o temp. |
ToggleLock(vehicle) | Bloquea o desbloquea un vehículo para el que el jugador tiene una llave, con la misma animación y comprobaciones que G. Si no hay ningún vehículo, se usa el más cercano dentro del alcance. |
ToggleEngine() | Arranca o detiene el motor del vehículo que conduce el jugador, como U. |
OpenMenu() | Abre el llavero, por ejemplo, desde un menú radial o una aplicación del teléfono. |
CloseMenu() | Cierra el llavero y devuelve el control del ratón al juego. |
IsMenuOpen() | Es true mientras el llavero está abierto. |
useLockpick() | Inicia un intento de ganzúa en el coche situado frente al jugador o el puenteo del encendido desde el asiento del conductor. Pensado para objetos de ox_inventory: client = { export = 'Agency-Vehiclekeys.useLockpick' }. |
02Exports de servidor
| Export | Descripción |
|---|---|
GiveKeys(source, plate, mode, hours) | Entrega una llave. El modo 'temp' (predeterminado) es una llave temporal, opcionalmente por un número de horas; 'perm' es una llave guardada. Se puede usar un source o un identifier. |
RemoveKeys(source, plate) | Retira una llave compartida o temporal. Devuelve true si había una. |
HasKeys(source, plate) | Es true cuando el jugador tiene una llave para la matrícula, incluidas las llaves de trabajo para un vehículo cercano. |
SetOwner(source, plate) | Convierte al jugador en propietario de una matrícula, para garajes y tiendas en servidores standalone. El propietario anterior pierde la llave. |
RemoveOwner(plate) | Elimina el propietario que este script guardó para una matrícula. |
GetOwner(plate) | El identifier del propietario y su procedencia: 'framework' para vehículos en propiedad de QBCore, Qbox o ESX, 'store' para propietarios guardados por este script. |
GetKeyHolders(plate) | Todos los demás que tienen una llave para la matrícula, en una lista de { identifier, kind, name, expires }. |
SetVehicleLocked(vehicle, locked) | Bloquea o desbloquea un vehículo para todos, sin comprobar si tienen llave. Para scripts que necesitan abrir un coche. |
IsVehicleLocked(vehicle) | True cuando el vehículo está bloqueado. |
GetFramework() | El framework que detectó el script: qbcore, esx o standalone. |
03Eventos
| Nombre | Lado | Descripción |
|---|---|---|
Agency:Keys:GiveServer | Servidor | Solicita una llave temporal para una matrícula, como hacen Agency Garage y Agency Vehicleshop. Actívalo desde el cliente con la matrícula. El coche debe estar junto al jugador o ser suyo. |
qb-vehiclekeys:server:AcquireVehicleKeys | Servidor | El evento de llaves de qb-vehiclekeys, interpretado del mismo modo, para que los garajes y tiendas creados para qb-vehiclekeys sigan funcionando. |
vehiclekeys:client:SetOwner | Cliente | Evento de cliente que muchos garajes y tiendas activan después de generar un coche. Otorga una llave temporal para esa matrícula tras realizar las mismas comprobaciones en el servidor. |
qb-vehiclekeys:client:AddKeys | Cliente | El evento de cliente de qb-vehiclekeys para entregar llaves, interpretado del mismo modo. |
simple_carkeys:client:toggleEngine | Cliente | Se activa en el cliente cuando se enciende o se apaga el motor con una llave, para que los HUD, como Agency-Hud, puedan seguir el estado del motor. |
+Conviene saber
Agency-Vehiclekeys V2 ofrece exports y es compatible con los eventos de llaves habituales, para que los scripts de garajes, tiendas, trabajos y atracos puedan dar, comprobar y retirar llaves.
- Dar y comprobar llaves
- GiveKeys da una llave temporal o guardada, RemoveKeys la retira y HasKeys la comprueba, en el servidor con un source o un identifier y en el cliente para el propio jugador.
- Propietarios para garajes independientes
- En servidores independientes no hay una tabla del framework con los vehículos propios. SetOwner asigna a un jugador como propietario de una matrícula, RemoveOwner elimina esa asignación y GetOwner la consulta.
- Eventos que usan otros scripts
- Agency:Keys:GiveServer, qb-vehiclekeys:server:AcquireVehicleKeys, vehiclekeys:client:SetOwner y qb-vehiclekeys:client:AddKeys otorgan una llave temporal tras realizar las mismas comprobaciones: el vehículo debe estar junto al jugador o pertenecerle.
?Preguntas frecuentes
¿Cómo doy una llave desde mi script de garaje?
En el servidor, llama a exports['Agency-Vehiclekeys']:GiveKeys(source, plate) después de generar el vehículo, o ejecuta TriggerServerEvent('Agency:Keys:GiveServer', plate) en el cliente. Los scripts creados para qb-vehiclekeys no requieren cambios.