Jak dodać własne samochody i scripts do serwera FiveM

Każdy serwer FiveM to tak naprawdę tylko stos resources: scripts, samochody, mapy i prace, z których każde znajduje się we własnym folderze i jest włączane w server.cfg. Ten poradnik omawia, jak zbudowane są resources, jak poprawnie zainstalować script oraz jak dodać streamowane dodatki z pojazdami do serwera FiveM w DoomHosting bez psucia kolejności bootowania.

Gdzie znajdują się resources na serwerze FiveM?

Wszystko jest w jednym miejscu: w folderze resources. Otwórz zakładkę Files w panelu i wejdź do resources. Każdy script, samochód czy mapa to osobny podfolder z plikiem fxmanifest.lua w środku.

Foldery ujęte w nawiasy kwadratowe, takie jak [cars] czy [esx], to jedynie foldery grupujące. FiveM automatycznie ładuje każdy resource wewnątrz folderu w nawiasach, co jest schludnym sposobem trzymania wszystkich pojazdów lub wszystkich resources frameworka razem. Folder w nawiasach nie może zawierać innego folderu w nawiasach i nie powinien zawierać luźnych plików, a jedynie podfoldery resources.

Jak zainstalować script na moim serwerze FiveM?

1. Pobierz script. Wartościowe resources pochodzą z oficjalnych wydań na forum Cfx.re oraz renomowanych repozytoriów GitHub.

2. W zakładce Files otwórz resources i wgraj tam folder scriptu. Przy dużych przesyłkach połącz się przez SFTP (szczegóły znajdziesz na przycisku SFTP w zakładce Files) zamiast korzystać z uploadera w przeglądarce.

3. Przeczytaj README samego scriptu w poszukiwaniu zależności. Większość scripts wymaga frameworka (es_extended lub qb-core) i często już działającego oxmysql.

4. Dodaj linię ensure do server.cfg po jego zależnościach:

   ensure oxmysql
   ensure es_extended
   ensure your-new-script
   

   

5. Zrestartuj serwer i obserwuj zakładkę Console pod kątem czystego startu bez czerwonych błędów.

Czy powinienem używać start czy ensure w server.cfg?

Używaj ensure. Uruchamia ona resource, jeśli jest zatrzymany, i restartuje go, jeśli już działa, co jest dokładnie tym, czego chcesz przy bootowaniu. start tylko uruchamia resource i jest starszą składnią. Nie ma powodu, by je mieszać, więc uczyń każdą linię w swojej config linią ensure.

Jak dodać własny samochód do mojego serwera FiveM?

Pojazdy typu add-on to "streamowane" resources: pliki modelu są streamowane do graczy, gdy dołączają. To struktura folderów ma znaczenie.

1. Utwórz folder resource dla samochodu (lub umieść go w folderze grupującym [cars]), na przykład resources/[cars]/police_charger.

2. W jego wnętrzu umieść pliki modelu pojazdu (.yft, .ytd) w podfolderze stream, a pliki metadanych (vehicles.meta, carvariations.meta, handling.meta i tak dalej) obok pliku fxmanifest.lua:

   police_charger/
     fxmanifest.lua
     stream/
       police_charger.yft
       police_charger.ytd
     vehicles.meta
     carvariations.meta
     handling.meta
   

3. Plik fxmanifest.lua mówi FiveM, aby streamował model i ładował pliki meta:

   fx_version 'cerulean'
   game 'gta5'
   
   files {
     'vehicles.meta',
     'carvariations.meta',
     'handling.meta'
   }
   
   data_file 'VEHICLE_METADATA_FILE' 'vehicles.meta'
   data_file 'CARCOLS_FILE' 'carvariations.meta'
   data_file 'HANDLING_FILE' 'handling.meta'
   

4. ensure police_charger w server.cfg, zrestartuj, a nazwa spawn z vehicles.meta jest teraz używalna w grze.

Większość pobieranych samochodów zawiera już działający fxmanifest.lua i poprawne foldery, więc w praktyce wgrywasz folder i dodajesz jedną linię ensure. Buduj strukturę ręcznie tylko wtedy, gdy samochód dostarczono jako luźne pliki.

Czy muszę dopasować artifact lub gamebuild FiveM?

Czasami. Dwa ustawienia wersji wpływają na to, czy resource się załaduje:

• Artifact (wersja serwera): ustawiany przez zmienną fivem version w zakładce Startup panelu. Pozostaw ją na recommended, chyba że konkretny script wymaga nowszej buildy.
• Gamebuild: niektóre nowsze pojazdy i MLO wymagają określonej game build. Ustaw ją w server.cfg, na przykład sv_enforceGameBuild 2802. Jeśli samochód lub mapa są niewidoczne albo wywalają graczy przy spawnie, niedopasowany gamebuild jest częstą przyczyną.

Podnoś te wartości tylko wtedy, gdy resource wyraźnie tego wymaga. Wymuszenie wyższej gamebuild niż wspierają twoje resources może powodować więcej problemów, niż rozwiązuje.

Częste błędy

• Resource się nie uruchamia: nazwa folderu musi dokładnie odpowiadać linii ensure, a fxmanifest.lua musi znajdować się bezpośrednio wewnątrz folderu resource, a nie o poziom głębiej. Folder-w-folderze to najczęstsza przyczyna.
• Failed to load streamowanego modelu: pliki modelu nie znajdują się w folderze stream albo nazwy .yft/.ytd nie odpowiadają temu, do czego odwołują się pliki meta.
• Brakująca zależność: konsola nazywa brakujący export lub resource. Dodaj jego linię ensure ponad zawodzącym resource.
• Samochód się spawnuje, ale źle jeździ lub jest niewidoczny: brakujący lub niedopasowany handling.meta / vehicles.meta, albo niezgodność gamebuild.

Słowo o tym, skąd pobierać resources

Trzymaj się oficjalnego forum wydań Cfx.re i stron GitHub oryginalnych twórców. Wyciekłe lub "darmowe" kopie płatnych resources to najczęstszy sposób, w jaki serwery FiveM dostają backdoora, co może wykraść twoją bazę danych lub przejąć serwer. Jeśli resource jest zaciemniony lub pochodzi z przypadkowego Discorda, nie uruchamiaj go.

Kolejne kroki

Aby wpiąć samochody i scripts w pełną bazę roleplay, najpierw zainstaluj ESX lub QBCore na swoim serwerze FiveM. Aby uzyskać panel webowy do zarządzania resources i restartami, skonfiguruj txAdmin na swoim serwerze FiveM.

Jesteś tu nowy? Zobacz FiveM server hosting lub pełny game control panel.