Oszczędź 20% z WELCOMEZobacz promocje

Jak zainstalować niestandardowe samochody (FiveM)

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)

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

Szybka mapa — wybierz swoją ścieżkę

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 (jeśli dostarczono)
 fxmanifest.lua
 vehicle_names.lua (opcjonalnie, dla nazwy wyświetlanej w grze)

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' -- opcjonalnie

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 (starsza wersja)
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()
 -- klucz musi odpowiadać nazwie spawnu w vehicles.meta 
 AddTextEntry('elegy', 'Elegy RH8 Custom')
end)

4) Uruchom zasób w server.cfg

# Uruchom wszystkie samochody w grupie [cars]
ensure [cars]

# (lub) uruchom tylko ten samochód
# ensure fm_elegy

Zrestartuj serwer lub uruchom odśwież + ensure fm_elegy z konsoli.

Gabz Lore Friendly Cars

5) Znajdź nazwę spawnu i przetestuj

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

...


elegy
elegy
  • 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 # scalone lub osobne pliki dla każdego auta
 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', -- kod spawnu
 ['price'] = 125000,
 ['category'] = 'sports',
 ['shop'] = 'pdm'
}

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 klucze: Połącz swój sklep z niezawodnym garażem I skryptem kluczy pojazdów aby gracze zachowywali własność po restartach:

Sterowanie pojazdem i tuning: Do sterowania oknami/drzwiami/światłami/miejscami oraz immersyjnego tuningu:

Lista kontrolna wydajności i bezpieczeństwa

Instalacja to tylko połowa sukcesu —utrzymaj szybkość i stabilność.

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

Rozwiązywanie problemów (szybkie poprawki)

Auto się nie spawnuje

  • Zły kod spawnu. Otwórz vehicles.meta i weź <gameName>.
  • Zasób nie uruchomił się. Sprawdź txAdmin → Konsola na żywo 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ą

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 pakiety samochodów
ensure [cars]

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

elegy
 elegy
 elegy
 elegy
 ANNIS
 VPT_DEFAULT
 VC_SPORT
 440010

vehicle_names.lua (opcjonalnie)

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

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

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?
Od twórców, którzy dostarczają pakiety gotowe na FiveM – lub przeglądaj nasz katalog: 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]// z stream/ + data/.
  2. Wrzuć YFT/YTD do stream/; meta do data/.
  3. Dodaj fxmanifest.lua z files { ... } + data_file ... linii.
  4. upewnić się, że [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

Produkty według kategorii

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 upewnić się, że [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.
Udostępnij to

Podobne wpisy