Custom voertuigen zijn een van de populairste toevoegingen aan een FiveM-server. Of het nu gaat om politieauto's, supercars of vrachtwagens, addon cars maken je server uniek. In dit artikel leggen we uit hoe je ze installeert.
Wat is een addon car?
Een addon car is een voertuigmodel dat niet in het standaard GTA V zit. Het bestaat uit:
- .yft: het 3D-model van het voertuig.
- .ytd: de textures (verfkleur, details, stickers).
- vehicles.meta: voertuigeigenschappen (snelheid, handling, klasse).
- handling.meta: gedetailleerde rijdynamica.
- carvariations.meta: kleurvariaties en extras.
- carcols.meta: lichtconfiguratie (noodverlichting, koplampen).
Stap 1: Resource-structuur
Maak een resource-map voor elk voertuig of een groep voertuigen:
resources/
[cars]/
mijn-auto/
fxmanifest.lua
stream/
mijn-auto.yft
mijn-auto_hi.yft
mijn-auto.ytd
data/
vehicles.meta
handling.meta
carvariations.meta
carcols.meta
Stap 2: fxmanifest.lua
Maak een fxmanifest.lua in de resource-map:
fx_version 'cerulean'
game 'gta5'
files {
'data/vehicles.meta',
'data/handling.meta',
'data/carvariations.meta',
'data/carcols.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'
Stap 3: server.cfg
Voeg de resource toe aan je server.cfg:
ensure mijn-auto
Of als je een categorie-map gebruikt:
ensure [cars]
Stap 4: In-game spawnen
Start de server en spawn het voertuig in-game. Met vMenu: Voertuig Spawner en zoek op de modelnaam. Of via de console/chat:
/car [modelnaam]
Veelvoorkomende problemen
| Probleem | Oorzaak | Oplossing |
|---|---|---|
| Auto is onzichtbaar | Ontbrekend .yft-bestand | Controleer of het model in de stream-map staat met de juiste bestandsnaam. |
| Zwarte/witte textuur | Ontbrekend of corrupt .ytd | Herdownload het voertuig of zoek de juiste texture. |
| Server crash bij laden | Te groot model of corrupt bestand | Controleer de bestandsgrootte. Modellen boven 50 MB zijn verdacht. |
| Voertuig rijd niet goed | Foute handling.meta | Gebruik de handling.meta van het originele voertuig als basis. |
| Resource start niet | Fout in fxmanifest.lua | Controleer op typefouten en ontbrekende bestanden. |
Waar vind je addon cars?
- GTA5-Mods.com: de grootste bron voor GTA V-voertuigen. Niet alles is FiveM-compatible.
- FiveM-forums: specifiek voor FiveM geoptimaliseerde voertuigen.
- Betaalde marktplaatsen: Tebex-winkels van modders voor exclusieve, geoptimaliseerde modellen.
Tips voor prestaties
- Beperk het aantal addon cars. Elk voertuig verhoogt de downloadgrootte voor spelers.
- Optimaliseer textures: 1024x1024 is voldoende voor de meeste voertuigen, 2048x2048 voor hero-voertuigen.
- Gebruik een CDN of snelle server voor streaming. Grote auto-packs (100+ voertuigen) vereisen aanzienlijke bandbreedte.
- Groepeer voertuigen per categorie (politie, civiel, sport) in aparte resources.
Hoeveel addon cars kan ik installeren?
Technisch honderden, maar houd rekening met downloadtijden. Elke auto is 5-50 MB aan streaming-bestanden. Met 100 auto's ben je snel 2-5 GB aan downloads kwijt, wat nieuwe spelers lang laat wachten. Begin met 20-30 goed gekozen voertuigen en breid uit op basis van feedback.
Werken addon cars met ESX en QBCore?
Ja. Addon cars zijn framework-onafhankelijk. De voertuigbestanden worden gestreamed door FiveM, ongeacht welk framework je gebruikt. Je kunt ze wel toevoegen aan de voertuig-shop van je framework.
Moet ik een auto-hash genereren?
Nee, FiveM genereert automatisch een hash op basis van de modelnaam in vehicles.meta. Zorg alleen dat de modelnaam uniek is en geen conflict heeft met bestaande GTA V-voertuigen of andere addons.
Installeer je addon cars op een FiveM server bij HostValues met volledige bestandstoegang en txAdmin.
