QBESXStandalone
Agency-Vehiclekeys V2 Exports & API
Chaves universais para veículos no FiveM, compatíveis com QBCore, Qbox, ESX ou totalmente standalone.
v2.0.0Pago5 Páginas
01Exports do cliente
| Export | Descrição |
|---|---|
HasKeys(plate) | True quando o jogador tem uma chave para esta placa: owner, shared ou temporary. Os veículos de trabalho são destrancados pelo modelo e não são contabilizados aqui. |
GetKeys() | Todas as chaves do jogador como uma lista de { plate, kind }. kind pode ser owner, shared ou temp. |
ToggleLock(vehicle) | Tranca ou destranca um veículo para o qual o jogador tem uma chave, com a mesma animação e verificações de G. Se não houver um veículo, usa o mais próximo dentro do alcance. |
ToggleEngine() | Liga ou desliga o motor do veículo que o jogador está dirigindo, como U. |
OpenMenu() | Abre o chaveiro, por exemplo, a partir de um menu radial ou de um aplicativo de telefone. |
CloseMenu() | Fecha o chaveiro e devolve o mouse ao jogo. |
IsMenuOpen() | True enquanto o chaveiro está aberto. |
useLockpick() | Inicia uma tentativa de arrombamento no carro à frente do jogador ou uma ligação direta quando ele está no banco do motorista. Destinado a itens do ox_inventory: client = { export = 'Agency-Vehiclekeys.useLockpick' }. |
02Exports do servidor
| Export | Descrição |
|---|---|
GiveKeys(source, plate, mode, hours) | Dá uma chave. mode 'temp' (padrão) é uma chave temporária, opcionalmente por um número de horas, e 'perm' é uma chave salva. Um source ou um identifier funciona. |
RemoveKeys(source, plate) | Retira uma chave compartilhada ou temporária. Retorna true quando havia uma. |
HasKeys(source, plate) | True quando o jogador tem uma chave para a placa, incluindo chaves de trabalho para um veículo próximo. |
SetOwner(source, plate) | Define o jogador como proprietário de uma placa, para garagens e lojas em servidores standalone. Um proprietário anterior perde a chave. |
RemoveOwner(plate) | Remove o proprietário salvo por este script para uma placa. |
GetOwner(plate) | O identifier do proprietário e sua origem: 'framework' para veículos de propriedade de QBCore, Qbox ou ESX, 'store' para proprietários salvos por este script. |
GetKeyHolders(plate) | Todos os outros que têm uma chave para a matrícula, numa lista de { identifier, kind, name, expires }. |
SetVehicleLocked(vehicle, locked) | Tranca ou destranca um veículo para todos, sem verificar se têm uma chave. Para scripts que precisam abrir um carro. |
IsVehicleLocked(vehicle) | Verdadeiro quando o veículo está trancado. |
GetFramework() | O framework detetado pelo script: qbcore, esx ou standalone. |
03Eventos
| Nome | Lado | Descrição |
|---|---|---|
Agency:Keys:GiveServer | Servidor | Solicita uma chave temporária para uma matrícula, como fazem Agency Garage e Agency Vehicleshop. Dispare do client com a matrícula. O carro tem de estar perto do jogador ou ser dele. |
qb-vehiclekeys:server:AcquireVehicleKeys | Servidor | O evento de chave de qb-vehiclekeys, interpretado da mesma forma, para que garagens e lojas criadas para qb-vehiclekeys continuem a funcionar. |
vehiclekeys:client:SetOwner | Cliente | Evento do client que muitas garagens e lojas disparam depois de criar um carro. Dá uma chave temporária para essa matrícula após as mesmas verificações no servidor. |
qb-vehiclekeys:client:AddKeys | Cliente | O evento do client de qb-vehiclekeys para entregar chaves, interpretado da mesma forma. |
simple_carkeys:client:toggleEngine | Cliente | Disparado no client quando o motor é ligado ou desligado com uma chave, para que HUDs como Agency-Hud possam acompanhar o estado do motor. |
+Bom saber
Agency-Vehiclekeys V2 oferece exports e entende os eventos de chave habituais, para que scripts de garagens, lojas, empregos e assaltos possam dar, verificar e retirar chaves.
- Dar e verificar chaves
- GiveKeys dá uma chave temporária ou salva, RemoveKeys a retira e HasKeys verifica se o jogador tem a chave, no servidor com um source ou um identificador e no cliente para o próprio jogador.
- Proprietários em garagens independentes
- Em servidores independentes, não há uma tabela de veículos próprios do framework. SetOwner define o jogador como proprietário de uma placa, RemoveOwner remove a propriedade e GetOwner a consulta.
- Eventos usados por outros scripts
- Agency:Keys:GiveServer, qb-vehiclekeys:server:AcquireVehicleKeys, vehiclekeys:client:SetOwner e qb-vehiclekeys:client:AddKeys concedem uma chave temporária após as mesmas verificações: o carro precisa estar perto do jogador ou pertencer a ele.
?Perguntas frequentes
Como dou uma chave pelo meu script de garagem?
No servidor, chame exports['Agency-Vehiclekeys']:GiveKeys(source, plate) depois que o carro aparecer ou dispare TriggerServerEvent('Agency:Keys:GiveServer', plate) no cliente. Scripts feitos para qb-vehiclekeys não precisam de alterações.