Skrypt na kluczyki do pojazdów FiveM: Poradnik Agency-Vehiclekeys 2026

Problem z domyślnym dostępem do pojazdów w FiveM

Domyślnie GTA V i FiveM pozwalają każdemu graczowi wsiąść do dowolnego pojazdu i prowadzić go bez ograniczeń. Nie ma kluczyków, mechaniki własności ani konsekwencji za wskoczenie do cudzego auta i odjechanie. Na serwerach casualowych ma to niewielkie znaczenie, ale dla każdej poważnej społeczności roleplay to domyślne zachowanie całkowicie niszczy immersję. Każdy samochód staje się wspólną taksówką. Kradzież pojazdu traci jakikolwiek sens. Zaparkowanie auta w pobliżu banku na czas załatwiania sprawy staje się loterią, w której inni gracze po prostu się częstują.

Skrypt kluczyków FiveM rozwiązuje ten problem na poziomie frameworka. Przypisuje własność i fizyczne kluczyki do każdego pojazdu zespawnowanego lub kupionego na serwerze, wymagając od graczy posiadania odpowiedniego przedmiotu kluczyka w ekwipunku, aby odblokować, odpalić i prowadzić auto. Pojazdy bez kluczyka są zamknięte, a gracz próbujący do nich wsiąść po prostu odbija się od drzwi. Aby poprowadzić samochód, którego nie jesteś właścicielem, musisz pożyczyć kluczyk, odpalić go na krótko (hotwire) lub wytrychem sforsować zamek. Te trzy mechaniki razem przekształcają interakcję z pojazdem ze zwykłej formalności w istotny element rozgrywki roleplay.

W 2026 roku Agency-Vehiclekeys to bezkonkurencyjny wybór dla serwerów szukających dopracowanego systemu z głęboką integracją z QBCore i ESX, wciągającą minigrą hotwire oraz niską, jednorazową opłatą. Ten przewodnik zawiera wszystko, co musisz wiedzieć.

Co oferuje Agency-Vehiclekeys

Agency-Vehiclekeys opiera się na pięciu głównych filarach funkcji, które sprawiają, że posiadanie pojazdu wydaje się realistyczne:

1. Fizyczne przedmioty: klucze

Gdy gracz spawnuje lub kupuje pojazd, w jego ekwipunku umieszczany jest unikalny przedmiot kluczyka. Ten przedmiot jest jedynym sposobem na odblokowanie i uruchomienie tego konkretnego pojazdu, jest powiązany z network ID lub tablicą rejestracyjną pojazdu. Kluczyk można fizycznie przekazać innemu graczowi, upuścić, przechować w schowku (stash) lub zgubić. Jeśli zgubisz kluczyk, nie uruchomisz samochodu bez użycia hotwire lub wezwania ślusarza (mechanika pracy, którą możesz skonfigurować). Ta pojedyncza decyzja projektowa, przekształcenie kluczyków w prawdziwe przedmioty ekwipunku, tworzy kaskadę autentycznych scenariuszy roleplay, których domyślny FiveM po prostu nie obsługuje.

2. Udostępnianie kluczy

System udostępniania kluczy pozwala właścicielowi pojazdu utworzyć duplikat klucza i przekazać go dowolnemu innemu graczowi. Jest to niezbędne w przypadku pojazdów współdzielonych, samochodów rodzinnych, warsztatów mechanicznych, które muszą przestawiać pojazdy, oraz ekip przestępczych dzielących auto do ucieczki. Udostępnianie odbywa się za pomocą prostej interakcji w grze: wyceluj w gracza, wybierz "Give Vehicle Key", a duplikat pojawi się w jego ekwipunku. Właściciel zachowuje swój klucz, a odbiorca otrzymuje działającą kopię, która funkcjonuje identycznie jak oryginał. Właściciele mogą również w dowolnym momencie cofnąć wszystkie udostępnione klucze, odbierając dostęp każdemu, kto wcześniej go posiadał.

3. Minigra: odpalanie na krótko

Gdy gracz próbuje wsiąść do zamkniętego pojazdu, do którego nie ma kluczyka, otrzymuje opcję połączenia kabli na krótko (hotwire). Agency-Vehiclekeys zawiera dopracowaną minigrę NUI do łączenia kabli: ograniczone czasowo wyzwanie dopasowywania przewodów, które wymaga umiejętności gracza, a nie zwykłego rzutu kością. Pomyślne ukończenie minigry uruchamia samochód, ale wywołuje zdarzenia po stronie serwera, pod które mogą podpiąć się inne skrypty: powiadomienie właściciela auta, zaalarmowanie dyspozytorni policji, zapis incydentu w MDT. Poziom trudności i limit czasu minigry są w pełni konfigurowalne, możesz też ustawić różne progi trudności w oparciu o klasę pojazdu (auta ekonomiczne łatwiejsze, supersamochody trudniejsze).

4. System wytrychów

System wytrychów obejmuje etap otwierania drzwi oddzielnie od odpalania na krótko. Gracz posiadający w ekwipunku wytrych może spróbować otworzyć zamek w drzwiach pojazdu. Jest to warunek konieczny do wejścia do pojazdu przy odpalaniu na krótko: najpierw otwierasz drzwi, potem odpalasz na krótko. Otwieranie zamków ma własną minigrę, konfigurowalną szansę na sukces oraz szansę na zużycie przedmiotu. Nieudane próby mogą złamać wytrych (konfigurowalne) i opcjonalnie wysłać powiadomienie do pobliskich graczy lub policji. Ten dwuetapowy proces: otwórz zamek, potem odpal na krótko, sprawia, że kradzież pojazdu wiąże się z realnym ryzykiem i wymaga czasu, dokładnie tak, jak powinno być w poważnym RP.

5. Głęboka integracja z QBCore i ESX

Agency-Vehiclekeys integruje się bezpośrednio z ekwipunkiem QBCore (kompatybilny z ox_inventory) oraz ekwipunkiem ESX od razu po instalacji. Przedmioty kluczyków pojawiają się jako pełnoprawne obiekty w ekwipunku z ikonami i metadanymi. Własność pojazdów łączy się z bazą danych posiadanych pojazdów QBCore (player_vehicles) oraz odpowiednik w ESX. Gdy gracz odbiera samochód z salonu lub parkingu policyjnego, jego klucz jest automatycznie generowany i umieszczany w ekwipunku. Wszystkie powiadomienia, potwierdzenia zablokowania/odblokowania, alerty o odpalaniu na krótko, próby użycia wytrycha korzystają z natywnego systemu powiadomień Twojego frameworka, dzięki czemu pasują do reszty UI Twojego serwera.

Dodatkowe funkcje

Poza pięcioma głównymi filarami Agency-Vehiclekeys zawiera kilka mechanik poprawiających wygodę rozgrywki (quality-of-life):

• Animacje blokowania/odblokowywania: Postać odtwarza realistyczną animację sięgania podczas blokowania lub odblokowywania pojazdu, czemu towarzyszy słyszalny dźwięk kliknięcia.
• Blokowanie zbliżeniowe: Zamykaj i otwieraj z konfigurowalnej odległości za pomocą skrótu klawiszowego lub menu kołowego, bez konieczności stania tuż przy drzwiach.
• Alarm pojazdu: Opcjonalnie włącz alarm samochodowy podczas próby użycia wytrychu lub odpalania na krótko. Alarm zwraca uwagę pobliskich graczy i może powiadomić właściciela przez powiadomienie na telefonie (jeśli Agency Phone jest zainstalowany).
• Pojazdy zwolnione z wymogu pracy: Zdefiniuj listę pojazdów frakcyjnych (radiowozy, karetki, holowniki) wyłączonych z systemu kluczyków, dzięki czemu funkcjonariusze mogą wsiadać do pojazdów służbowych bez konieczności posiadania przedmiotu kluczyka.
• Integracja z systemem odholowywania: Gdy pojazd trafia na parking policyjny (impound), powiązany kluczyk jest automatycznie unieważniany. Gdy pojazd zostanie odebrany z parkingu, generowany jest nowy kluczyk.
• API eksportu: Przejrzyste export API pozwala innym skryptom sprawdzać własność kluczy, generować klucze programowo lub je unieważniać, co jest przydatne w skryptach mechaników, salonów samochodowych i niestandardowych integracjach prac.

Instalacja: krok po kroku

Krok 1: Kup Agency-Vehiclekeys

Przejdź do agencyscripts.dev/en/products/vehiclekeys i sfinalizuj jednorazowy zakup €7.99. Po zakupie otrzymujesz dostęp do pobrania przez portal sklepu Agency Scripts. Bez subskrypcji, bez odnawiania, masz to na zawsze.

Krok 2: Umieść zasób

Rozpakuj pobrane archiwum i przenieś agency-vehiclekeys folder do katalogu twojego serwera resources katalogu (lub podfolderze takim jak resources/[scripts]/).

Krok 3: Dodaj do server.cfg

Otwórz swój server.cfg i dodaj linijkę ensure po zasobach frameworku i ekwipunku:

ensure agency-vehiclekeys

Krok 4: Skonfiguruj Config.lua

Otwórz agency-vehiclekeys/config/Config.lua oraz ustaw swój framework, system ekwipunku i preferencje funkcji. Zobacz poniższy przykład reprezentatywnej konfiguracji.

Krok 5: Dodaj przedmioty kluczy do swojego ekwipunku

Jeśli używasz QBCore lub ESX, dodaj definicję przedmiotu klucza do pliku ze wspólnymi przedmiotami. Dokładna definicja przedmiotu znajduje się w dokumentacji pod adresem docs.agencyg.de/vehiclekeys. W przypadku użytkowników ox_inventory dodaj zamiast tego przedmiot do swojego items.lua.

Krok 6: Zrestartuj i przetestuj

Zrestartuj serwer. Zespawnuj pojazd, sprawdź w ekwipunku przedmiot klucza, zamknij pojazd, odejdź, wróć i spróbuj wsiąść bez klucza. Następnie przetestuj przekazanie klucza innemu graczowi, interakcję z wytrychem oraz minigrę hotwire.

Przykład Config.lua

Poniżej znajduje się przykładowa konfiguracja przedstawiająca najważniejsze opcje w Agency-Vehiclekeys:

-- Agency-Vehiclekeys: Config.lua

Config = {}

-- Framework: "qbcore" or "esx"
Config.Framework = "qbcore"

-- Inventory system: "qb-inventory", "ox_inventory", or "esx"
Config.Inventory = "ox_inventory"

-- Item name for vehicle keys in your inventory
Config.KeyItem = "vehicle_key"

-- Item name for lockpicks
Config.LockpickItem = "lockpick"

-- Distance (metres) from which player can lock/unlock their vehicle
Config.LockDistance = 8.0

-- Enable vehicle alarm on hotwire/lockpick attempt
Config.EnableAlarm = true
Config.AlarmDuration = 30  -- seconds

-- Hotwire mini-game settings
Config.Hotwire = {
    enabled    = true,
    timeLimit  = 20,         -- seconds to complete mini-game
    difficulty = "medium",   -- "easy", "medium", "hard"
    -- Per-class overrides (GTA vehicle class numbers)
    classOverrides = {
        [6]  = "easy",   -- off-road: easier
        [7]  = "hard",   -- supercars: harder
        [14] = "hard",   -- military: very difficult
    },
}

-- Lockpick settings
Config.Lockpick = {
    enabled          = true,
    breakChance      = 0.25, -- 25% chance lockpick breaks on failure
    alertPolice      = true, -- send notification to online police on attempt
    alertRadius      = 30.0, -- metres within which police are notified
}

-- Job-exempt vehicles (these jobs can enter any vehicle without a key)
Config.ExemptJobs = { "police", "ambulance", "mechanic", "tow" }

-- Notification system: "qb", "esx", "okok", "ox"
Config.NotifySystem = "qb"

-- Enable export API for other scripts to interact with the key system
Config.EnableExports = true

Kompatybilność z frameworkami i ekwipunkami

Agency-Vehiclekeys obsługuje następujące kombinacje od razu po instalacji:

• QBCore + qb-inventory: Pełna integracja, kluczyki pojawiają się w UI ekwipunku QBCore, własność pojazdu synchronizuje się z player_vehicles
• QBCore + ox_inventory: Pełna integracja, kluczyki renderowane jako przedmioty ox z metadanymi, kompatybilne ze wszystkimi funkcjami ox_inventory
• ESX + ESX inventory: Pełna integracja, kluczyki w systemie ekwipunku ESX, własność zsynchronizowana z tabelą pojazdów ESX

Jeśli używasz innego systemu ekwipunku, API exportów i otwarty kod Lua ułatwiają dodanie własnego bridge'a. Dokumentacja zawiera szablon bridge'a.

Dokumentacja

Pełna dokumentacja, wszystkie opcje konfiguracji, definicje przedmiotów ekwipunku, dokumentacja export API, konfiguracja wyłączeń dla prac oraz FAQ są dostępne pod adresem docs.agencyg.de/vehiclekeys. Dokumentacja jest aktualizowana przy każdym wydaniu i zawiera gotowe do skopiowania definicje przedmiotów dla QBCore, ESX i ox_inventory.

Cena: €5.99 jednorazowo

Agency-Vehiclekeys kosztuje €7.99 w formie pojedynczej, jednorazowej płatności w sklepie Agency Scripts. Nie ma subskrypcji, odnawiania ani opłat za serwer. Płacisz raz i masz go na zawsze, a wszystkie przyszłe aktualizacje do bieżącej wersji głównej są zawarte bez dodatkowych kosztów. Za mniej niż sześć euro to jeden z najbardziej opłacalnych skryptów premium FiveM na rynku. Porównywalny system kluczyków do pojazdów od innego dewelopera w modelu subskrypcyjnym kosztowałby tyle w jeden miesiąc; Agency-Vehiclekeys zapewnia taką samą lub lepszą jakość za jednorazową cenę, którą większość właścicieli serwerów wydaje na kawę w tydzień.

Kto powinien używać Agency-Vehiclekeys?

Agency-Vehiclekeys to właściwy wybór dla:

• Serwery Serious RP które chcą, aby posiadanie pojazdu miało realne znaczenie: koniec z wsiadaniem do każdego napotkanego auta
• Społeczności criminal RP które chcą autentycznych mechanik odpalania na krótko i wytrychów, czyniących kradzież pojazdów wymagającym i ryzykownym zajęciem
• Serwery z salonami samochodowymi, bezproblemowa integracja oznacza, że generowanie klucza odbywa się automatycznie w momencie zakupu
• Serwery Police RP, alarmy i powiadomienia policji przy próbach użycia wytrychu lub odpalenia na krótko tworzą realistyczne scenariusze reakcji
• Serwery QBCore i ESX szukasz gotowego do wdrożenia, dobrze utrzymanego systemu kluczyków, który respektuje istniejące konwencje frameworka

Podsumowanie

Kluczyki do pojazdów to fundamentalna mechanika dla każdego serwera traktującego roleplay na poważnie. Agency-Vehiclekeys dostarcza kompletny pakiet: fizyczne przedmioty kluczyków, współdzielenie kluczy, minigrę hotwire opartą na zręczności, dwuetapowy system wytrychów, alarmy pojazdów oraz głęboką integrację z frameworkami, za jednorazową kwotę €7.99. Obiektywnie rzecz biorąc, to jeden z najbardziej opłacalnych zakupów dla Twojego serwera FiveM. Odwiedź sklep, kup go i zmień sposób działania pojazdów na swoim serwerze już dziś.