Sådan tilføjer du custom biler og scripts til din FiveM-server

Enhver FiveM-server er i virkeligheden bare en stak af resources: scripts, biler, maps og jobs, der hver ligger i deres egen mappe og bliver tændt i server.cfg. Denne guide dækker, hvordan resources er struktureret, hvordan du installerer et script på den rigtige måde, og hvordan du tilføjer streamede vehicle-addons til en DoomHosting FiveM-server uden at ødelægge din boot-rækkefølge.

Hvor ligger resources på en FiveM-server?

Alt ligger ét sted: mappen resources. Åbn fanen Files i panelet og gå ind i resources. Hvert script, hver bil eller map er sin egen undermappe med en fxmanifest.lua inde i sig.

Mapper pakket ind i firkantede parenteser som [cars] eller [esx] er blot grupperingsmapper. FiveM indlæser automatisk enhver resource inde i en parentesmappe, hvilket er en ryddelig måde at holde alle dine biler eller alle dine framework-resources samlet. En parentesmappe kan ikke indeholde en anden parentesmappe, og den bør ikke indeholde løse filer, kun resource-undermapper.

Hvordan installerer jeg et script på min FiveM-server?

1. Download scriptet. Kvalitets-resources kommer fra de officielle Cfx.re forum-udgivelser og velrenommerede GitHub-repos.

2. Åbn resources i fanen Files og upload scriptets mappe dertil. Til store uploads bør du forbinde over SFTP (detaljerne står på SFTP-knappen i Files-fanen) i stedet for browser-uploaderen.

3. Læs scriptets egen README for dependencies. De fleste scripts kræver et framework (es_extended eller qb-core) og ofte oxmysql, som allerede kører.

4. Tilføj en ensure-linje til server.cfg efter dets dependencies:

   ensure oxmysql
   ensure es_extended
   ensure your-new-script
   

   

5. Genstart serveren og hold øje med fanen Console for en ren start uden røde fejl.

Bør jeg bruge start eller ensure i server.cfg?

Brug ensure. Den starter en resource, hvis den er stoppet, og genstarter den, hvis den allerede kører, hvilket er præcis, hvad du vil have ved boot. start starter kun en resource og er den ældre syntaks. Der er ingen grund til at blande dem, så gør hver linje i din config til en ensure.

Hvordan tilføjer jeg en custom bil til min FiveM-server?

Add-on-køretøjer er "streamede" resources: modelfilerne streames til spillerne, når de tilslutter sig. Det er mappestrukturen, der betyder noget.

1. Opret en resource-mappe til bilen (eller læg den i din [cars]-gruppemappe), for eksempel resources/[cars]/police_charger.

2. Læg køretøjets modelfiler (.yft, .ytd) i en stream-undermappe inde i den, og metadatafilerne (vehicles.meta, carvariations.meta, handling.meta og så videre) ved siden af en fxmanifest.lua:

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

3. Filen fxmanifest.lua fortæller FiveM, at modellen skal streames, og at meta-filerne skal indlæses:

   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 i server.cfg, genstart, og spawn-navnet fra vehicles.meta kan nu bruges i spillet.

De fleste biler, du downloader, indeholder allerede en fungerende fxmanifest.lua og de korrekte mapper, så i praksis uploader du mappen og tilføjer én ensure-linje. Byg kun strukturen manuelt, hvis bilen kom som løse filer.

Skal jeg matche FiveM-artifact eller gamebuild?

Nogle gange. To versionsindstillinger påvirker, om en resource indlæses:

• Artifact (serverversion): sættes af variablen fivem version på panelets fane Startup. Lad den stå på recommended, medmindre et bestemt script kræver en nyere build.
• Gamebuild: nogle nyere køretøjer og MLO'er kræver en bestemt game build. Sæt den i server.cfg med for eksempel sv_enforceGameBuild 2802. Hvis en bil eller et map er usynligt eller crasher spillere ved spawn, er en fejlmatchet gamebuild en almindelig årsag.

Hæv kun disse, når en resource udtrykkeligt beder om det. At tvinge en højere gamebuild, end dine resources understøtter, kan give flere problemer, end det løser.

Almindelige fejl

• Resource starter ikke: mappenavnet skal matche ensure-linjen nøjagtigt, og fxmanifest.lua skal ligge direkte inde i resource-mappen, ikke et niveau dybere. En mappe-inde-i-en-mappe er den absolut hyppigste årsag.
• Failed to load af en streamet model: modelfilerne ligger ikke i en stream-mappe, eller .yft/.ytd-navnene matcher ikke det, meta-filerne refererer til.
• Manglende dependency: konsollen navngiver den manglende export eller resource. Tilføj dens ensure-linje over den fejlende resource.
• Bil spawner, men kører forkert eller er usynlig: en manglende eller fejlmatchet handling.meta / vehicles.meta, eller en gamebuild-mismatch.

Et ord om, hvor du downloader resources

Hold dig til det officielle Cfx.re udgivelsesforum og de oprindelige udvikleres GitHub-sider. Lækkede eller "gratis" kopier af betalte resources er den mest almindelige måde, FiveM-servere bliver backdooret på, hvilket kan stjæle din database eller kapre din server. Hvis en resource er obfuskeret eller kommer fra en tilfældig Discord, så kør den ikke.

Næste skridt

For at koble biler og scripts ind i en fuld roleplay-base skal du først installere ESX eller QBCore på din FiveM-server. For et web-dashboard til at håndtere resources og genstarter kan du opsætte txAdmin på din FiveM-server.

Ny her? Se FiveM server hosting eller det fulde game control panel.