QBESXStandalone

Agency-Vehiclekeys V2 Instalacja

Uniwersalne kluczyki do pojazdów dla FiveM na QBCore, Qbox, ESX lub w pełni standalone.

v2.0.0Płatny5 Strony

Kup w sklepie Powrót do katalogu

01Instalacja

1Umieść Agency-Vehiclekeys w folderze resources
2Dodaj ensure Agency-Vehiclekeys do server.cfg, po swoim frameworku, oxmysql i swoim ekwipunku
3Zatrzymaj inne skrypty kluczy, takie jak qb-vehiclekeys. Ich kluczowe eventy są obsługiwane, więc garaże i sklepy działają nadal
4Przedmioty wytrycha: większość serwerów QBCore posiada już lockpick oraz advancedlockpick, w przeciwnym razie sprawdź install/items_qbcore.lua, install/items_ox_inventory.lua lub install/items_esx.sql
5Opcjonalnie: add_ace group.admin agency.vehiclekeys.admin allow dla zakładek Administrator i Ustawienia w /keys
6Aktualizacja z V1: podmień stary folder i użyj nowego config.lua. Kluczyki rozdane w V1 (simple_carkeys_shared) zostaną przeniesione przy pierwszym uruchomieniu

02Zależności

Brak wymaganych zależności
QBCore, QBox lub ESX (opcjonalnie, działa standalone bez żadnego z nich)
oxmysql (opcjonalnie, bez tego klucze są zapisywane w Key Value Store serwera)
Ekwipunek na wytrychy (opcjonalnie: ox_inventory, qs-inventory, qb-inventory i jego forki lub ESX)
Skrypt dispatch (opcjonalnie: ps-dispatch, cd_dispatch, qs-dispatch, rcore_dispatch, core_dispatch, tk_dispatch lub lb-tablet)
Agency-Notify (opcjonalnie, wiadomości w klasycznym wyglądzie V1)

03Plik SQL

Opcjonalnie: resource tworzy te tabele automatycznie podczas uruchamiania. Zaimportuj ten plik tylko wtedy, gdy konfigurujesz bazę danych ręcznie:

-- Agency Vehiclekeys V2
-- Optional: the script creates this table by itself on the first start when
-- oxmysql runs. Run it by hand only if your database user may not create tables.

CREATE TABLE IF NOT EXISTS `agency_vehiclekeys` (
    `plate`      VARCHAR(16)  NOT NULL,
    `identifier` VARCHAR(96)  NOT NULL,
    `kind`       VARCHAR(12)  NOT NULL DEFAULT 'shared',
    `holder`     VARCHAR(64)  NULL DEFAULT NULL,
    `granted_by` VARCHAR(96)  NULL DEFAULT NULL,
    `model`      VARCHAR(32)  NULL DEFAULT NULL,
    `created`    INT UNSIGNED NOT NULL DEFAULT 0,
    PRIMARY KEY (`plate`, `identifier`),
    KEY `identifier` (`identifier`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

+Warto wiedzieć

Agency-Vehiclekeys V2 działa od razu po dopisaniu linijki ensure. Przed pierwszym uruchomieniem warto zwrócić uwagę na pięć kwestii: inne skrypty na kluczyki, przedmioty lockpick, bazę danych, uprawnienia adminów i klucze do prac oraz przejście z V1.

Inne kluczowe skrypty: Wyłącz qb-vehiclekeys, qbx_vehiclekeys i podobne skrypty, dwa skrypty kluczy kolidowałyby ze sobą przy tych samych pojazdach. Ich kluczowe eventy są obsługiwane, więc garaże i sklepy działają nadal. Skrypt, który wywołuje exports['qb-vehiclekeys']:HasKeys(plate) po stronie klienta, wymaga jedynie zmiany nazwy na Agency-Vehiclekeys.
Przedmioty wytrycha: Config.Lockpick.items definiuje przedmioty, domyślnie advancedlockpick oraz lockpick. Większość serwerów QBCore posiada oba. install/items_qbcore.lua, install/items_ox_inventory.lua i install/items_esx.sql zawierają wpisy dla pozostałych ekwipunków. Użycie przedmiotu z ekwipunku rozpoczyna próbę, klawisz H robi to samo.
Baza danych: Z oxmysql klucze są zapisywane w tabeli agency_vehiclekeys, którą skrypt tworzy automatycznie. Bez oxmysql trafiają do key-value store serwera. install/agency_vehiclekeys.sql jest potrzebny tylko wtedy, gdy twój użytkownik bazy danych nie ma uprawnień do tworzenia tabel.
Admini i klucze pracy: Admini to gracze z uprawnieniem ACE agency.vehiclekeys.admin, group.admin lub group.superadmin, albo grupą z Config.AdminGroups. Na serwerach standalone klucze do pracy pochodzą z uprawnień ACE, na przykład add_ace group.police agency.vehiclekeys.police allow.
Aktualizacja z V1: Zastąp stary folder nowym i użyj nowego pliku config.lua, konfiguracja z V1 nie pasuje. Klucze z simple_carkeys_shared są przenoszone przy pierwszym uruchomieniu. Klawisz G nadal blokuje zamek, uruchamianie silnika przeniesiono z M na U, a /givekey i /removekey nadal działają.

?Często zadawane pytania

Które ekwipunki są obsługiwane dla wytrychów?

ox_inventory, qs-inventory, qb-inventory i jego forki oraz ekwipunek ESX, wykrywane przez Config.Inventory = 'auto'. Serwery standalone bez ekwipunku mogą podłączyć własny za pomocą Config.Standalone.itemCount i removeItem albo pozwolić graczom zbierać bez przedmiotu.

Mój garaż używa własnej tabeli dla posiadanych pojazdów. Co mam zrobić?

Ustaw Config.OwnedVehicles na tabelę oraz jej kolumny dla właściciela i tablicy rejestracyjnej. Domyślnie używane są player_vehicles z citizenid (QBCore, Qbox) oraz owned_vehicles z owner (ESX).