QBESXStandalone
Agency-Vehiclekeys V2 Eksporty & API
Uniwersalne kluczyki do pojazdów dla FiveM na QBCore, Qbox, ESX lub w pełni standalone.
v2.0.0Płatny5 Strony
01Eksporty klienta
| Eksport | Opis |
|---|---|
HasKeys(plate) | Wartość true, gdy gracz posiada klucz do tej tablicy rejestracyjnej: właścicielski, współdzielony lub tymczasowy. Pojazdy służbowe otwierają się według modelu i nie są tutaj uwzględniane. |
GetKeys() | Wszystkie klucze gracza jako lista { plate, kind }. kind to owner, shared lub temp. |
ToggleLock(vehicle) | Blokuje lub odblokowuje pojazd, do którego gracz ma klucz, z tą samą animacją i weryfikacją co G. Przy braku pojazdu używany jest najbliższy w zasięgu. |
ToggleEngine() | Uruchamia lub zatrzymuje silnik pojazdu, którym kieruje gracz, tak jak U. |
OpenMenu() | Otwiera brelok na klucze, na przykład z menu kołowego lub aplikacji w telefonie. |
CloseMenu() | Zamyka pęk kluczy i oddaje mysz do gry. |
IsMenuOpen() | Wartość true, gdy brelok na klucze jest otwarty. |
useLockpick() | Rozpoczyna próbę użycia wytrycha przy aucie przed graczem lub odpalanie na krótko na miejscu kierowcy. Przeznaczone dla przedmiotów ox_inventory: client = { export = 'Agency-Vehiclekeys.useLockpick' }. |
02Eksporty serwera
| Eksport | Opis |
|---|---|
GiveKeys(source, plate, mode, hours) | Przyznaje kluczyk. Tryb 'temp' (domyślny) to kluczyk tymczasowy, opcjonalnie na określoną liczbę godzin, 'perm' to kluczyk stały. Działa source lub identyfikator. |
RemoveKeys(source, plate) | Odbiera współdzielony lub tymczasowy klucz. Zwraca true, jeśli taki istniał. |
HasKeys(source, plate) | Wartość true, gdy gracz posiada klucz do tej tablicy rejestracyjnej, w tym klucze służbowe do pobliskiego pojazdu. |
SetOwner(source, plate) | Czyni gracza właścicielem rejestracji dla garaży i sklepów na serwerach standalone. Poprzedni właściciel traci klucz. |
RemoveOwner(plate) | Usuwa właściciela zapisanego przez ten skrypt dla danej tablicy rejestracyjnej. |
GetOwner(plate) | Identyfikator właściciela oraz źródło jego pochodzenia: 'framework' dla posiadanych pojazdów z QBCore, Qbox lub ESX, 'store' dla właścicieli zapisanych przez ten skrypt. |
GetKeyHolders(plate) | Wszyscy inni posiadający klucz do tablicy jako lista { identifier, kind, name, expires }. |
SetVehicleLocked(vehicle, locked) | Blokuje lub odblokowuje pojazd dla wszystkich, bez sprawdzania klucza. Dla skryptów, które muszą otworzyć auto. |
IsVehicleLocked(vehicle) | Wartość true, gdy pojazd jest zamknięty. |
GetFramework() | Framework wykryty przez skrypt: qbcore, esx lub standalone. |
03Eventy
| Nazwa | Strona | Opis |
|---|---|---|
Agency:Keys:GiveServer | Serwer | Prosi o tymczasowy kluczyk do tablicy rejestracyjnej, tak jak robią to Agency Garage i Agency Vehicleshop. Wywołaj to z poziomu klienta z numerem rejestracyjnym. Pojazd musi znajdować się obok gracza lub należeć do niego. |
qb-vehiclekeys:server:AcquireVehicleKeys | Serwer | Główne zdarzenie qb-vehiclekeys, interpretowane w ten sam sposób, dzięki czemu garaże i sklepy stworzone dla qb-vehiclekeys nadal działają. |
vehiclekeys:client:SetOwner | Klient | Event clienta wywoływany przez wiele garaży i sklepów po zespawnowaniu auta. Zapewnia tymczasowy kluczyk do tej rejestracji po takich samych sprawdzeniach na serwerze. |
qb-vehiclekeys:client:AddKeys | Klient | Zdarzenie klienta qb-vehiclekeys do przekazywania kluczyków, interpretowane w ten sam sposób. |
simple_carkeys:client:toggleEngine | Klient | Wywoływane u klienta przy uruchamianiu lub gaszeniu silnika klawiszem, dzięki czemu interfejsy HUD, takie jak Agency-Hud, mogą śledzić stan silnika. |
+Warto wiedzieć
Agency-Vehiclekeys V2 oferuje eksporty i obsługuje standardowe zdarzenia kluczyków, dzięki czemu garaże, sklepy, prace i skrypty napadów mogą nadawać, sprawdzać i odbierać kluczyki.
- Przekazywanie i sprawdzanie kluczyków
- GiveKeys przydziela kluczyk tymczasowy lub stały, RemoveKeys go odbiera, a HasKeys sprawdza go, na serwerze przy użyciu source lub identyfikatora, a na kliencie dla samego gracza.
- Właściciele dla garaży standalone
- Na serwerach standalone nie ma tabeli frameworka z posiadanymi pojazdami. SetOwner czyni gracza właścicielem tablicy rejestracyjnej, RemoveOwner go usuwa, a GetOwner odczytuje ją z powrotem.
- Eventy używane przez inne skrypty
- Agency:Keys:GiveServer, qb-vehiclekeys:server:AcquireVehicleKeys, vehiclekeys:client:SetOwner oraz qb-vehiclekeys:client:AddKeys prowadzą do tymczasowego klucza po tych samych sprawdzeniach: samochód musi znajdować się obok gracza lub należeć do niego.
?Często zadawane pytania
Jak przekazać klucz z mojego skryptu garażu?
Po stronie serwera wywołaj exports['Agency-Vehiclekeys']:GiveKeys(source, plate) po zespawnowaniu auta lub wywołaj TriggerServerEvent('Agency:Keys:GiveServer', plate) po stronie klienta. Skrypty stworzone pod qb-vehiclekeys nie wymagają żadnych zmian.