Custom voertuigen toevoegen aan uw FiveM-server

Custom voertuigen zijn op de meeste FiveM-servers het eerste wat opvalt. Er zijn twee soorten: replace-mods die een bestaand GTA-voertuig vervangen, en addon-mods die een nieuw voertuig toevoegen naast de bestaande. Addon is de standaard op RP-servers omdat u het originele GTA-voertuig behoudt.

Wat u nodig heeft

Een voertuigmod, gedownload van GTA5-Mods of het cfx.re Releases-forum. Zoek mods die "FiveM ready" zijn; die hebben de juiste mapstructuur en een fxmanifest.lua.
SFTP-toegang tot uw server (sneller dan het webpaneel voor veel bestanden).

Mapstructuur van een addon-voertuig

Een correct FiveM-voertuig ziet er zo uit:

resources/[voertuigen]/mijn-auto/
    fxmanifest.lua
    stream/
        mijn-auto.yft       (het 3D-model)
        mijn-auto_hi.yft    (hoge-kwaliteit model)
        mijn-auto.ytd       (texturen)
        vehicles.meta       (voertuigeigenschappen)
        handling.meta       (rijgedrag)
        carvariations.meta  (kleuren en onderdelen)
        carcols.meta        (lichten en sirenes)

De fxmanifest.lua bevat minimaal:

fx_version 'cerulean'
game 'gta5'
this_is_a_map 'yes'
files { 'stream/**/*.meta' }
data_file 'HANDLING_FILE' 'stream/handling.meta'
data_file 'VEHICLE_METADATA_FILE' 'stream/vehicles.meta'
data_file 'CARCOLS_FILE' 'stream/carcols.meta'
data_file 'VEHICLE_VARIATION_FILE' 'stream/carvariations.meta'

Installatie stap voor stap

Stop de server.
Upload de voertuigmap naar resources/[voertuigen]/. De vierkante haken in de mapnaam zijn een FiveM-conventie voor categorisatie.
Open server.cfg en voeg toe: ensure mijn-auto (de mapnaam van het voertuig).
Start de server.
Join de server en spawn het voertuig met /car spawnnaam (de naam uit vehicles.meta).

Spawnen via vMenu of uw framework

Op een freeroam-server met vMenu verschijnt het voertuig automatisch in de voertuiglijst als het correct is geinstalleerd. Op een RP-server met ESX of Qbox voegt u het voertuig toe aan de dealership-database of de garageconfig, zodat spelers het via de economie kunnen kopen.

Texturen optimaliseren

Ongeoptimaliseerde YTD-bestanden zijn de grootste oorzaak van FPS-problemen op FiveM-servers. Veel custom voertuigen worden geleverd met 4096px-texturen, terwijl FiveM intern capt op 1024px. Comprimeer YTD's naar 1024px voordat u ze uploadt. Tools als OpenIV doen dit. Een server met 200 voertuigen die elk 20 MB aan texturen heeft, streamt 4 GB aan data naar elke client; na optimalisatie is dat 800 MB.

Veel voorkomende problemen

Voertuig spawnt niet. Controleer of de mapnaam exact overeenkomt met de regel in server.cfg en of de fxmanifest.lua aanwezig is.
Voertuig is onzichtbaar. Het YFT-bestand ontbreekt of de naam in vehicles.meta komt niet overeen met de bestandsnaam.
Texturen zijn verkeerd. De YTD-bestandsnaam moet exact overeenkomen met de modelnaam.
Server hitch bij laden. Te veel voertuigen tegelijk, of ongecomprimeerde texturen. Zie hitch warnings oplossen.

Hoeveel voertuigen kan mijn server aan?

Met geoptimaliseerde texturen: honderden. Zonder optimalisatie: elk voertuig kost geheugen en bandbreedte. Een vuistregel: 100 geoptimaliseerde voertuigen op een 8 GB-server is comfortabel.

Moet ik replace of addon gebruiken?

Addon voor RP-servers, zodat het originele voertuig beschikbaar blijft. Replace alleen als u alle GTA-voertuigen wilt vervangen en een strak gecontroleerd voertuigaanbod wilt.

Moeten spelers de voertuigen ook downloaden?

Nee. FiveM streamt de bestanden automatisch naar de client bij het verbinden. Dat kost bandbreedte en laadtijd, maar de speler hoeft niets handmatig te installeren.

Voertuigen draaien op alle FiveM-pakketten. Voor servers met veel custom assets raden wij 8 GB of meer aan.