🚓 Jak zainstalować niestandardowe pojazdy w FiveM

Custom pojazdy (dodatkowe samochody, motocykle, pojazdy służbowe) to jeden z najpopularniejszych sposobów wyróżnienia serwera FiveM. W tym poradniku pokazujemy jak dodać pojazd typu "add-on" (dodatkowy, obok istniejących) bez podmieniania oryginalnych modeli gry.

Krok 1: Pobierz pojazd

Pobierz paczkę pojazdu ze sprawdzonego źródła (forum.cfx.re, znani twórcy społeczności)
Rozpakuj paczkę - powinna zawierać pliki .ytd, .yft oraz pliki konfiguracyjne .meta

⚠️ UWAGA: Pobieraj pojazdy tylko z legalnych, darmowych źródeł lub zakupione od twórcy. Piracki content może zawierać złośliwy kod i naraża Twój serwer na problemy prawne.

Krok 2: Wgraj pojazd przez FTP

Połącz się z serwerem przez FTP/SFTP w panelu TierHost
Utwórz folder w katalogu resources/[vehicles]/nazwa_pojazdu/
Wgraj wszystkie pliki paczki do tego folderu

Krok 3: Skonfiguruj plik fxmanifest.lua

Jeśli paczka nie zawiera gotowego manifestu, utwórz plik fxmanifest.lua:

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
    'stream/*.ytd',
    'stream/*.yft',
}

data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'
data_file 'HANDLING_FILE' 'data/handling.meta'

Krok 4: Skonfiguruj vehicles.meta i carvariations.meta

Pliki vehicles.meta i carvariations.meta definiują parametry pojazdu (nazwa, kategoria, statystyki) i muszą znajdować się w folderze data/ zasobu. Większość gotowych paczek pojazdów już je zawiera - wystarczy sprawdzić, czy nazwa modelu (model name) nie koliduje z innym zainstalowanym pojazdem.

Krok 5: Dodaj zasób do server.cfg

ensure nazwa_pojazdu

Zrestartuj serwer, aby zasób został załadowany.

Krok 6: Dodaj pojazd do sklepu lub garażu w grze

Sam wgrany model nie pojawi się automatycznie w grze - musisz dodać jego nazwę (spawn code) do skryptu sklepu z pojazdami lub systemu garaży (np. qb-garages, cd_garage), żeby gracze mogli go kupić lub przetestować komendą:

/car nazwa_modelu

Podmiana istniejącego pojazdu (replace)

Jeśli chcesz podmienić model istniejącego pojazdu (np. ulepszyć wygląd radiowozu policyjnego) zamiast dodawać nowy, użyj trybu "replace" - w fxmanifest.lua ustaw ten sam model name co oryginalny pojazd. Pamiętaj, że przy tym podejściu wszystkie kopie oryginalnego pojazdu w grze zostaną zastąpione nowym modelem.

Najczęstsze problemy

❌ Problem: Pojazd wyświetla się jako szary blok (błąd tekstury)

Rozwiązanie:

Sprawdź, czy wszystkie pliki .ytd zostały poprawnie wgrane
Upewnij się, że ścieżki w fxmanifest.lua zgadzają się ze strukturą folderów

❌ Problem: Serwer crashuje po dodaniu pojazdu