Pour installer un HUD FiveM, confirmez son framework et ses dépendances, ajoutez son dossier de ressources, démarrez-le après ces dépendances, et testez les valeurs affichées avec un joueur normal. Un HUD qui apparaît à l'écran a toujours besoin d'une vérification des données et de l'utilisabilité.
Vérifiez la compatibilité et conservez une option de restauration
Lisez la documentation du HUD pour la version du framework prise en charge, l'inventaire, le statut et les ressources vocales. Les intégrations ESX, QBCore et Qbox ne sont pas interchangeables, sauf si le créateur les prend explicitement en charge. Sauvegardez le HUD actuel, la configuration et toutes les tables de base de données que l'installation modifie.
Testez d'abord sur un serveur séparé. Désactivez l'ancien HUD pendant le test pour éviter les superpositions en double et les logiques de mini-carte ou de statut concurrentes.
Installez la ressource
- Extrayez le package. Le dossier de ressources doit contenir fxmanifest.lua à sa racine, plutôt qu'une autre copie imbriquée du dossier. Préservez les noms de dossiers documentés.
- Installez les dépendances requises et configurez l'intégration du framework pris en charge par le HUD. Gardez les secrets hors des fichiers client et NUI.
- Ajoutez ensure suivi du nom exact du dossier de ressources à server.cfg après ses dépendances. Démarrez le serveur de test et lisez la première erreur de ressource avant de continuer.
- Connectez-vous avec un compte ordinaire. Vérifiez la santé, l'armure, la faim/soif (le cas échéant), l’argent, le métier et les valeurs du véhicule par rapport à l'état réel du jeu.
Vérifiez l'interface
Testez différentes résolutions et échelles d'interface utilisateur, l'entrée et la sortie des véhicules, la reconnexion, les changements de personnage et un redémarrage complet du serveur. Confirmez que les menus restent cliquables et que le texte important est lisible sans se fier uniquement à la couleur. Inspectez les consoles F8 et du serveur pour les erreurs.
Trouvez la cause d'une panne
Pas d'interface : vérifiez l'erreur de démarrage de la ressource, le manifeste, les chemins de fichiers NUI et les actifs du navigateur. Une interface avec des valeurs incorrectes indique plutôt le framework ou l'intégration du statut. Des éléments qui se chevauchent suggèrent qu'une autre ressource HUD ou mini-carte est toujours en cours d'exécution.
Restaurez l'ancien HUD et la configuration si la nouvelle ressource échoue à ces vérifications. Restaurez une sauvegarde de base de données uniquement lorsque sa migration a modifié des données ; coordonnez cela afin que les progrès plus récents des joueurs ne soient pas écrasés.
Références officielles
Le manifeste de ressource explique les déclarations de script et d'interface utilisateur ; commandes du serveur documente ensure.