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 package que vous avez l'autorisation d'exécuter et de distribuer aux joueurs connectés. Conservez son archive originale et son README. Une ressource prête pour FiveM inclut normalement un manifeste ainsi que des fichiers de modèle, de texture et de métadonnées. Un joueur seul .oiv installer ou .asi le plugin n'est pas une ressource 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 fichiers fournis .yft modèles et .ytd textures dans leurs chemins de flux. Si l'auteur fournit des agencements, de l'audio ou d'autres fichiers de données, conservez leurs entrées de manifeste correspondantes ; ne les supprimez pas pour correspondre à cet exemple.

2. Démarrez la ressource

Ajouter ensure my_vehicle to the active server.cfg. Sur un serveur de développement en cours d'exécution, exécutez ces deux commandes séparément 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

Ouvrir vehicles.meta et trouvez le véhicule modelName. C'est le nom du modèle/spawn. gameName est une étiquette de texte d'affichage et peut différer. Entrez le nom du modèle dans votre spawner de véhicule d'administration installé et autorisé.

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