Installer et tester des voitures personnalisées sur un serveur FiveM

Pour installer un véhicule additionnel, placez sa ressource FiveM complète dans le dossier de ressources de votre serveur, démarrez cette ressource et faites apparaître le modèle nommé dans vehicles.meta. Testez le véhicule avant de l'ajouter à un concessionnaire ou de le fusionner avec d'autres packs.

Confirmez l’édition GTA visée avant d’installer ou d’exporter des éléments. Les paquets Legacy ne sont pas automatiquement compatibles avec Enhanced ; suivez les directives officielles de conversion d'assets Enhanced si c'est votre cible.

Vérifiez d'abord le paquet

Utilisez un paquet que vous avez le droit d’exécuter et de distribuer aux joueurs qui se connectent. Conservez son archive et son README d’origine. Une ressource prête pour FiveM comprend normalement un manifeste ainsi que des fichiers de modèles, de textures et de métadonnées. Un installateur .oiv pour le mode solo ou un plugin .asi n’est pas une ressource de serveur.

Un add-on introduit un modèle séparé. Un remplacement écrase intentionnellement un nom de modèle existant. Vérifiez le type que vous avez afin de ne pas remplacer accidentellement la flotte par défaut.

1. Installez une ressource

Pour une ressource nommée my_vehicle, le manifeste doit se trouver à resources/[cars]/my_vehicle/fxmanifest.lua, et non dans un dossier d'extraction imbriqué supplémentaire. Conservez les chemins et la casse des noms de fichiers fournis. Les hôtes Linux distinguent les majuscules des minuscules.

Conservez un manifeste fonctionnel fourni par l'auteur. L'exemple ci-dessous ne couvre qu'un paquet dont les quatre fichiers de métadonnées nommés existent réellement dans data/; d'autres paquets peuvent nécessiter des enregistrements supplémentaires.

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'

Conservez les modèles .yft et les textures .ytd fournis dans leurs chemins de streaming. Si l’auteur fournit des fichiers de disposition, des fichiers audio ou d’autres fichiers de données, conservez les entrées correspondantes du manifeste ; ne les supprimez pas pour faire correspondre le paquet à cet exemple.

2. Démarrez la ressource

Ajoutez ensure my_vehicle au fichier server.cfg actif. Sur un serveur de développement en cours d’exécution, lancez séparément ces deux commandes dans la console FXServer :

refresh
ensure my_vehicle

Lisez la sortie de démarrage. Résolvez les fichiers manquants, les XML mal formés ou les erreurs de dépendance avant de faire apparaître la voiture. Démarrez une nouvelle ressource à la fois afin qu'un échec ait un propriétaire clair.

3. Utilisez le nom du modèle

Ouvrez vehicles.meta et repérez le modelName du véhicule. C’est le nom du modèle utilisé pour le faire apparaître. gameName est un libellé d’affichage et peut être différent. Saisissez le nom du modèle dans votre outil d’administration installé et autorisé pour faire apparaître des véhicules.

Inspectez les roues, les lumières, les portes, les sièges, les livrées, le réglage, la collision et la maniabilité. Testez avec un autre joueur connecté et après une reconnexion. Un modèle apparaissant une fois ne prouve pas que toutes ses métadonnées fonctionnent.

4. Ajoutez la propriété et l'intégration au magasin

Une fois que l'apparition fonctionne, suivez la configuration réelle ou le schéma de base de données de la ressource du magasin de véhicules. Le nom du framework seul n'identifie pas ce schéma. Utilisez le même nom de modèle, la catégorie prévue et un prix délibéré.

Testez l'achat, l'attribution de clés, le stockage au garage, la récupération et la persistance après le redémarrage. Supprimez les véhicules de test et les achats de test via les outils administratifs appropriés. Sauvegardez toutes les données modifiées pendant l'intégration.

Si vous avez un DLC solo

Inspectez l'archive avec l'outil d'édition approprié et identifiez ses modèles, textures et toutes les dépendances de métadonnées. La conversion peut impliquer de l'audio personnalisé, des mises en page et des pièces de réglage au-delà de l'exemple à quatre fichiers. Préférez les instructions FiveM de l'auteur si disponibles ; l'extraction de deux fichiers de modèle n'est pas une conversion complète.

Dépannage par symptôme

Si rien n'apparaît, vérifiez le démarrage et le modelName. Si la mauvaise voiture apparaît, recherchez les collisions de noms de modèles entre les ressources. Pour les textures ou les réglages manquants, comparez les métadonnées et les dépendances diffusées avec le paquet original. Pour les plantages, enregistrez le plantage exact et testez le véhicule seul sur une version de jeu compatible.

Mesurez le comportement graphique/de streaming dans une scène reproductible avec le nombre attendu de véhicules. Le temps d'exécution du script client dans Resmon ne mesure pas la géométrie du modèle ou le coût de la texture GPU. Conservez une option de retour en arrière facile en conservant chaque paquet testé séparément.

Documentation de référence

Cfx.re — manifeste de ressource · Cfx.re — fichiers de données · Source : dexyfex/CodeWalker