Jak zainstalować niestandardowe samochody (FiveM)

To jest autorytatywny, bez ogródek przewodnik do instalowania niestandardowych samochodów na serwerze FiveM—bezpiecznie, poprawnie, i z gotowymi do produkcji konfiguracjami, które możesz skopiować i wkleić. Omówimy pojedyncze samochody typu add‑on, pakiety wielu samochodów, konwersję DLC dla trybu jednoosobowego oraz podłączanie pojazdów do sklepów ESX/QBCore.

---

Co będzie potrzebne (wymagania wstępne)

• Działający serwer FiveM oraz dostęp FTP/FS do resources falcówka.
• Podstawowy edytor tekstu (VS Code) oraz możliwość ponownego uruchomienia serwera.
• (Opcjonalnie dla konwersji) OpenIV do rozpakowania DLC trybu jednoosobowego → użyj naszego bezpiecznego linku: https://fivemx.com/openiv-download/
• (Zalecane) Menu administracyjne lub narzędzie do spawnu (np., vMenu) do testowania: https://fivemx.com/free/vmenu/
• (Wydajność) Wiedz, jak używać Resmon aby znaleźć ciężkie samochody: https://fivemx.com/how-to-use-resmon-in-fivem-optimize-resources/

Subiektywna najlepsza praktyka: Grupuj wszystkie pojazdy w folderze kategorii zasobów, np. resources/[cars]/.... Utrzymuje to porządek na serwerze i pozwala ensure [cars] aby uruchomić każdy pakiet jednocześnie.

---

Szybka mapa — wybierz swoją ścieżkę

• Mam samochód typu add‑on gotowy na FiveM (jest już dostarczany z fxmanifest.lua i metami): przejdź do Zainstaluj pojedynczy dodatek samochodu.
• Mam DLC SP (tylko dlc.rpf z metami i modelami): przejdź do Konwertuj DLC SP na FiveM.
• Chcę wiele samochodów w jednym pakiecie: zobacz Zasób wielosamochodowy (partia).
• Chcę, aby samochody były dostępne do kupienia w grze: zobacz Podłącz do sklepów pojazdów ESX/QBCore.

---

Zainstaluj pojedynczy dodatek samochodu (przypadek 90%)

Załóżmy, że twój samochód nazywa się elegy i otrzymałeś pliki modeli YFT/YTD oraz standardowe pliki meta pojazdu.

1) Utwórz strukturę zasobu

resources/
 [cars]/
 fm_elegy/
 stream/
 elegy.yft
 elegy_hi.yft
 elegy.ytd
 data/
 handling.meta
 vehicles.meta
 carcols.meta
 carvariations.meta
 vehiclelayouts.meta (if provided)
 fxmanifest.lua
 vehicle_names.lua (optional, for in‑game display name)

Zasady, które oszczędzają godziny

• Nie upuść .asi/.oiv instalatory na serwerze. Tylko zasoby strumieniowe i mety.
• Trzymaj modele w stream/, metadane w data/.
• Nazwy plików są wrażliwe na wielkość liter w systemie Linux – dopasuj dokładnie.

2) fxmanifest.lua (kopiuj-wklej)

fx_version 'cerulean'
game 'gta5'

files {
 'data/handling.meta',
 'data/vehicles.meta',
 'data/carcols.meta',
 'data/carvariations.meta',
 'data/vehiclelayouts.meta'
}

data_file 'HANDLING_FILE' 'data/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'CARCOLS_FILE' 'data/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'
data_file 'VEHICLE_LAYOUTS_FILE' 'data/vehiclelayouts.meta'

client_script 'vehicle_names.lua' -- optional

Uwaga dotycząca starszej wersji: __resource.lua jest przestarzałe. Jeśli musisz obsługiwać tylko starszą wersję, użyj tego minimalnego pliku:

-- __resource.lua (legacy)
resource_manifest_version '77731fab-63ca-442c-a67b-abc70f28dfa5'

files {
 'data/handling.meta',
 'data/vehicles.meta',
 'data/carcols.meta',
 'data/carvariations.meta',
 'data/vehiclelayouts.meta'
}

data_file 'HANDLING_FILE' 'data/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'data/vehicles.meta'
data_file 'CARCOLS_FILE' 'data/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'data/carvariations.meta'
data_file 'VEHICLE_LAYOUTS_FILE' 'data/vehiclelayouts.meta'

client_script 'vehicle_names.lua'

3) Opcjonalnie vehicle_names.lua

Niektóre pakiety nie zawierają etykiety GXT. Dodaj jedną, aby samochód wyświetlał czystą nazwę w UI.

-- vehicle_names.lua
CreateThread(function()
 -- key must match spawn name in vehicles.meta <gameName>
 AddTextEntry('elegy', 'Elegy RH8 Custom')
end)

4) Uruchom zasób w server.cfg

# Start all cars inside the [cars] group
ensure [cars]

# (or) start this car only
# ensure fm_elegy

Zrestartuj serwer lub uruchom refresh + ensure fm_elegy z konsoli.

Gabz Lore Friendly Cars

5) Znajdź nazwę spawnu i przetestuj

Otwórz data/vehicles.meta i znajdź:

<Item type="CHandlingData">
 ...
</Item>
<!-- Look for -->
<modelName>elegy</modelName>
<gameName>elegy</gameName>

• Twój kod spawnu to zazwyczaj <gameName> Lub <modelName> (np., elegy).
• Przetestuj za pomocą narzędzia administracyjnego:
  • vMenu → Spawner Pojazdów → Add‑on → elegy
  • lub użyj swojej komendy administracyjnej (zależy od twojego menu administracyjnego).

Jeśli pojazd się spawnuje, a koła, światła i części tuningowe wyglądają poprawnie — gotowe.

---

Konwertuj DLC dla trybu single‑player na resource FiveM

Wiele samochodów “SP‑only” jest dostępnych jako dlc.rpf paczek. Przekonwertuj je w ten sposób:

1. Otwórz OpenIV → wejdź do folderu DLC dlc.rpf.
2. Wyodrębnij modele z x64/vehicles.rpf (YFT/YTD) → włóż do stream/.
3. Wyodrębnij metas z common/data/ do data/:
   • handling.meta, vehicles.meta, carcols.meta, carvariations.meta, vehiclelayouts.meta (jeśli występują).
4. Tworzyć fxmanifest.lua dokładnie tak, jak pokazano powyżej.
5. Uruchom resource i przetestuj nazwę spawnu z <gameName>.

Wskazówka: Jeśli samochód posiada niestandardowe zestawy dźwiękowe (audio), pakiet może zawierać .awc routing, który nie działa po stronie serwera. Preferuj pakiety już oznaczone jako FiveM‑ready lub zamień <audioNameHash> na standardowy zestaw.

---

Zasób wielosamochodowy (partia)

Możesz streamować wiele samochodów z jednego zasobu, aby uprościć zarządzanie.

Układ folderów

resources/[cars]/vip_pack/
 stream/
 elegy.yft
 elegy_hi.yft
 elegy.ytd
 supra.yft
 supra_hi.yft
 supra.ytd
 ...
 data/
 handling.meta # merged or per‑car files
 vehicles.meta
 carcols.meta
 carvariations.meta
 fxmanifest.lua

fxmanifest.lua dla danych z wildcardami

fx_version 'cerulean'
game 'gta5'

files {
 'data/*.meta'
}

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

Scalanie metadanych: Używaj tylko sprawdzonych scalonych plików. Zduplikowane <initDatas> lub źle umieszczone <kit> wpisy w carcols.meta są #1 powodem czarnych kół lub zepsutych dodatków.

---

Podłącz do sklepów pojazdów ESX/QBCore

Spawning jest w porządku do testowania. Dla prawdziwej ekonomii podłącz samochody do sklepu swojego frameworka.

QBCore (przykładowy wpis)

Dodaj do qb-core/shared/vehicles.lua (lub konfiguracji sklepu):

['elegy'] = {
 ['name'] = 'Elegy RH8',
 ['brand'] = 'Annis',
 ['model'] = 'elegy', -- spawn code
 ['price'] = 125000,
 ['category'] = 'sports',
 ['shop'] = 'pdm'
}

• Użyj sklep z pojazdami który obsługuje samochody dodatkowe. Polecamy sprawdzone opcje:
  • Brutal Scripts Vehicle Shop → https://fivemx.com/fivem-vehicle-shop-brutal-scripts/
  • Wais VehicleShop → https://fivemx.com/wais-vehicleshop/
  • AV VehicleShop → https://fivemx.com/av-vehicleshop/

ESX (szybkie dodawanie SQL)

Jeśli Twój sklep odczytuje z bazy danych:

INSERT INTO vehicles (name, label, price, category) VALUES
 ('elegy', 'Elegy RH8', 125000, 'sports');

Garaż i kluczyki: Połącz swój sklep z niezawodnym garażem I kluczyki pojazdów skrypt, aby gracze zachowywali własność po restartach:

• Garaże: https://fivemx.com/advanced-garages/ / https://fivemx.com/the-garage-system/
• Kluczyki: https://fivemx.com/renewed-vehicle-keys/

Sterowanie samochodem i tuning: Dla sterowania szybami/drzwiami/światłami/fotelami i immersji tuningu:

• Sterowanie pojazdem (inspirowane NoPixel): https://fivemx.com/nopixel-4-0-car-control-script/
• System tuningu: https://fivemx.com/tuning-system/

---

Lista kontrolna wydajności i bezpieczeństwa

Instalacja to tylko połowa pracy—utrzymuj to szybkie i stabilne.

• Budżety tekstur: Trzymać .ytd poniżej ~16 MB; preferuj tekstury 1k–2k. Zmniejsz skalę ciężkich malowań w OpenIV.
• LODy modelu: Upewnij się, że samochody mają LODy (_hi.yft + base). Brakujące LODy → duże spadki FPS w ruchu.
• UV kół/opon: Czarne koła zazwyczaj oznaczają brakujące carcols.meta lub złe ID materiałów – napraw metę, zanim obwiniasz ELS.
• Konflikty spawnu: Jeśli twój <gameName> pasuje do standardowego pojazdu, zmień nazwę modelu i wszystkich odniesień konsekwentnie.
• Kolejność strumieniowania: Nie polegaj na hackach kolejności ładowania. Umieść wszystkie mety w tym samym zasobie który strumieniuje model.
• Użyj Resmon: Po każdej instalacji jeźdź przez 1–2 minuty i obserwuj resmon skoki. Poradnik: https://fivemx.com/how-to-use-resmon-in-fivem-optimize-resources/
• Wyczyść pamięć podręczną klienta po dużych paczkach, jeśli gracze zgłaszają niewidzialne samochody: https://fivemx.com/how-to-clear-fivem-cache/

---

Rozwiązywanie problemów (szybkie poprawki)

Samochód się nie spawnuje

• Zły kod spawnu. Otwórz vehicles.meta i weź <gameName>.
• Zasób nie uruchomił się. Sprawdź txAdmin → Live Console pod kątem błędów; uruchom ensure fm_elegy.

Koła są czarne \/ lakiery zepsute

• Brak carcols.meta/carvariations.meta lub złe scalenia. Dodaj ponownie właściwe zestawy & modkitów.

Gra wywala się przy spawnie

• Przetłuszczone tekstury lub brakujące kości. Zmniejsz skalę .ytd i potwierdź, że base\/_hi para istnieje.

Wnętrze lub tarcze nie działają

• Paczka wymaga nowszej wersji gry. Zapytaj autora—lub przetestuj na nowszej wersji. (Jeśli potrzebne, włącz DLC: https://fivemx.com/how-to-enable-dlcs-for-fivem-server/)

Nazwy wyświetlają się jako NULL

• Dodaj vehicle_names.lua z AddTextEntry('SPAWN', 'Nice Name').

---

Rada: Utrzymuj samochody w porządku

• Umieść wszystkie pojazdy w [cars] i nazywaj paczki z przedrostkiem, np., fm_ → fm_civ_sports, fm_pd_fleet.
• Prowadź prosty CHANGELOG.md wewnątrz każdej paczki dla siebie.
• Unikaj mieszania ELS pakietów zaprojektowanych dla SP, chyba że autor udostępnia wariant FiveM.

---

Przykład: gotowy do użycia pakiet samochodów, który możesz wrzucić

Powiel ten szablon dla każdego dodawanego pakietu samochodów.

fxmanifest.lua

fx_version 'cerulean'
game 'gta5'

files {
 'data/handling.meta',
 'data/vehicles.meta',
 'data/carcols.meta',
 'data/carvariations.meta'
}

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

server.cfg

# FiveM car packs
ensure [cars]

data/vehicles.meta (minimalny fragment pokazujący, gdzie znajduje się nazwa spawnu)

<CVehicleModelInfo__InitDataList>
 <initDatas>
 <Item>
 <modelName>elegy</modelName>
 <txdName>elegy</txdName>
 <handlingId>elegy</handlingId>
 <gameName>elegy</gameName>
 <vehicleMakeName>ANNIS</vehicleMakeName>
 <plateType>VPT_DEFAULT</plateType>
 <vehicleClass>VC_SPORT</vehicleClass>
 <flags>440010</flags>
 </Item>
 </initDatas>
</CVehicleModelInfo__InitDataList>

vehicle_names.lua (opcjonalnie)

CreateThread(function()
 AddTextEntry('elegy', 'Elegy RH8')
end)

---

Zmień instalacje w treść i retencję (kolejne kroki)

• Zbuduj doświadczenie salonu samochodowego które gracze zapamiętają. Spróbuj:
  • Sklepy pojazdów: https://fivemx.com/fivem-vehicle-shop-brutal-scripts/ / https://fivemx.com/wais-vehicleshop/
  • Systemy garaży: https://fivemx.com/advanced-garages/
  • Sterowanie samochodem: https://fivemx.com/nopixel-4-0-car-control-script/
  • Klucze/zamykanie: https://fivemx.com/renewed-vehicle-keys/
• Zoptymalizuj czasy ładowania i wydajność, aby samochody były responsywne:
  • Centrum wydajności → https://fivemx.com/performance/
  • Jak używać Resmon → https://fivemx.com/how-to-use-resmon-in-fivem-optimize-resources/
  • Osiągnięcia w czasie ładowania → https://fivemx.com/optimize-loading-times/
• Odkryj więcej starannie wybranych samochodów i pakietów:
  • FiveM Samochody (kategoria) → https://fivemx.com/fivem-cars/
  • Wszystkie samochody (HiFiveM) → https://fivemx.com/cars/

---

Często zadawane pytania

Czy to działa z OneSync i dużymi serwerami?
Tak – pojazdy strumieniowane są normą. Utrzymuj rozsądne rozmiary tekstur i uważaj resmon.

Skąd wziąć wysokiej jakości samochody?
From creators who ship FiveM‑ready packs—or browse our curated catalog: https://fivemx.com/fivem-cars/.

Czy mogę połączyć floty policyjne/cywilne?
Tak. Organizuj według roli (fm_pd_fleet, fm_civ_sports), aby szybko włączać/wyłączać pakiety.

Czy muszę ustawić konkretną wersję gry?
Tylko jeśli mod opiera się na nowszych funkcjach. Autor zwykle to zaznacza. Jeśli coś pojawia się uszkodzone, przetestuj na nowszej wersji i spróbuj ponownie.

---

Podsumowanie do skopiowania (lista kontrolna)

1. Tworzyć resources/[cars]/<pack>/ z stream/ + data/.
2. Wrzuć YFT/YTD do stream/; meta do data/.
3. Dodaj fxmanifest.lua z files { ... } + data_file ... linii.
4. ensure [cars] (lub pakiet) w server.cfg.
5. Znajdź <gameName> w vehicles.meta i spawnuj przez vMenu/admin.
6. Podłącz do sklepu (ESX SQL lub QBCore tabela) i sparuj z garaż/klucze.
7. Test Resmon, sprawdzenie budżetu tekstur i gotowe.

---

Jesteś gotowy. Jeśli chcesz jeszcze szybszej ścieżki, weź gotowy pakiet serwerowy i zacznij dostosowywać: https://fivemx.com/fivem-servers/

Płatne pakiety samochodów

Add-on versus replacement cars

An add-on vehicle introduces a separate spawn model and keeps the original GTA vehicle intact. A replacement vehicle reuses an existing model name and overrides that base vehicle. Prefer add-ons when you want several custom vehicles without changing the default fleet; use replacements only when overriding that exact base model is intentional.

Safe pack and folder checks

• Keep vehicle resources grouped under a folder such as resources/[cars]/, but start each actual resource or use ensure [cars] only after verifying the server resolves the group correctly.
• Inspect the supplied fxmanifest.lua, streamed model files and every referenced metadata file. Do not replace a working manifest with a generic template without comparing its declared files and data types.
• Check model and spawn names, filename case and metadata references for duplicates before combining packs. A name collision can load the wrong vehicle even when the resource starts without an obvious error.
• Add one resource at a time, restart on staging, spawn every added model and inspect both server and client consoles. Roll back the last resource if models, textures, handling or shop entries fail.