Économisez 20 % avec WELCOMEVoir les promotions
Configuration de fxmanifest.lua (FiveM)

Configuration de fxmanifest.lua pour FiveM (Exemples à copier-coller)

Réponse rapide : chaque ressource FiveM a besoin d'un fxmanifest.lua fichier dans le dossier des ressources. Il indique à FXServer quel jeu la ressource prend en charge, quels scripts charger et quels fichiers envoyer aux clients. Ci-dessous se trouvent des exemples à copier-coller pour une ressource de script standard, des scripts partagés/client/serveur, des ressources NUI (page_interface utilisateur + fichiers) et des cartes (ceci_est_une_carte 'oui' avec des flux ymap), ainsi que des corrections pour les erreurs courantes de manifeste.

Dernière mise à jour : 25 juin 2026

fxmanifest.lua minimal

fx_version 'cerulean' jeu 'gta5' script_client 'client.lua' script_serveur 'server.lua''

La documentation officielle du manifeste des ressources de Cfx.re identifie fxmanifest.lua comme le fichier manifeste actuel et note que l'ancien __ressource.lua Les manifestes sont obsolètes. Utilisez fx_version 'céruléen' pour les ressources FiveM modernes, sauf si l'auteur de la ressource documente une exigence différente.

Exemple complet avec des métadonnées

fx_version 'cerulean'
game 'gta5'

auteur 'Votre Nom'
description 'Exemple de ressource FiveM'
version '1.0.0'

lua54 'yes'

shared_script 'config.lua'
client_script 'client.lua'
server_script 'server.lua'

Le auteur, description, et version Les champs sont des métadonnées : ils ne modifient pas l'exécution des scripts, mais FXServer affiche un avertissement dans la console tel que “ version est requis. veuillez spécifier une version dans votre fxmanifest.lua. ” lorsque version est manquant. Ajoutez une version '1.0.0' ligne pour le corriger. La ligne optionnelle lua54 'oui' active Lua 5.4 pour la ressource et est requise par de nombreux frameworks et bibliothèques actuels.

Scripts client, serveur et partagés

fx_version 'cerulean'
game 'gta5'

shared_scripts {
 'config.lua',
 '@ox_lib\/init.lua'
}

client_scripts {
 'client\/*.lua'
}

server_scripts {
 '@oxmysql\/lib\/MySQL.lua',
 'server\/*.lua'
}

Utiliser scripts partagés Utilisez ce format uniquement pour les fichiers sécurisés des deux côtés. Ne stockez pas de secrets de serveur, de clés de licence, de mots de passe de base de données ni d'URL de webhook dans les fichiers partagés.

Exemple de ressource NUI

fx_version 'cerulean'
game 'gta5'

ui_page 'web\/index.html'

files {
 'web\/index.html',
 'web\/style.css',
 'web\/app.js'
}

client_script 'client.lua'

Si l'interface utilisateur est vide dans le jeu, vérifiez que chaque fichier HTML, CSS, JavaScript, police et image est répertorié sous fichiers. Les fichiers manquants sont une cause fréquente de dysfonctionnement des écrans NUI.

Exemple de carte ou de ressource MLO

fx_version 'cerulean'
game 'gta5'

this_is_a_map 'yes'

files {
 'stream\/*.ymap',
 'stream\/*.ytyp'
}

Pour les cartes et les intérieurs, conservez les fichiers diffusés en continu dans un flux Vérifiez le dossier et assurez-vous que la ressource démarre sans avertissement dans la console. Si une carte ne se charge pas, consultez la console FiveM et les journaux txAdmin avant de modifier des ressources non liées.

Erreurs courantes

  • En utilisant __ressource.lua dans une nouvelle ressource.
  • Putting serveur.lua sous scripts_clients.
  • Oublier les fichiers NUI sous fichiers.
  • Mettre des secrets à l'intérieur scripts partagés.
  • Dossiers comportant des fautes d'orthographe, en particulier client, serveur, et flux.

Liste de contrôle de validation

  1. Le dossier de ressources contient fxmanifest.lua au plus haut niveau.
  2. jeu 'gta5' est présent pour FiveM.
  3. Les fichiers client sont chargés sur le client, les fichiers serveur sont chargés sur le serveur.
  4. Chaque fichier NUI/statique est répertorié sous fichiers.
  5. serveur.cfg comprend assurer le nom de la ressource.

Guides associés

Ordre des dépendances dans server.cfg

Le manifeste indique à FiveM quels fichiers appartiennent à une ressource, mais serveur.cfg Ce paramètre contrôle toujours l'ordre de démarrage. Démarrez les bibliothèques partagées et les dépendances du framework avant les ressources qui les utilisent.

assurer oxmysql assurer ox_lib assurer qb-core assurer my-script

Si une ressource génère des erreurs d'exportation au démarrage, vérifiez si la dépendance est installée, correctement nommée et assurée avant le script qui l'appelle.

Notes spécifiques au cadre

Les ressources ESX, QBCore et Qbox nécessitent souvent des importations de frameworks, des bibliothèques de base de données et des fichiers de configuration. Conservez la configuration du framework dans des fichiers documentés. Ne dissimulez pas des éléments de configuration importants dans des fichiers clients non détaillés. Un manifeste clair facilite le support technique, car l'équipe peut ainsi visualiser tous les fichiers chargés.

Liste de vérification à consulter avant de publier un scénario

  • Aucun secret dans les fichiers partagés ou clients.
  • Aucun fichier de test inutilisé n'est répertorié dans le manifeste.
  • Tous les actifs NUI répertoriés sous fichiers.
  • Dépendances documentées dans le fichier README ou la description du produit.
  • La ressource redémarre correctement après un redémarrage complet du serveur.

L'ordre des dépendances compte toujours

Le manifeste indique à FXServer quels fichiers appartiennent à une ressource, mais serveur.cfg contrôle toujours l'ordre de démarrage. Démarrez les bibliothèques partagées, les frameworks et les dépendances de base de données avant les scripts qui les appellent. Si une ressource génère des erreurs d'exportation au démarrage, vérifiez le nom et l'ordre des dépendances avant de modifier le script lui-même.

assurer oxmysql assurer ox_lib assurer qb-core assurer my-script

Vérifiez avant de livrer une ressource

Vérifiez que les fichiers clients ne contiennent pas de secrets, que les fichiers serveur ne sont pas envoyés au client, que les ressources NUI sont répertoriées sous fichiers, et les dépendances sont nommées exactement comme elles sont installées. Un manifeste fonctionnel devrait rendre la ressource compréhensible pour un autre développeur sans avoir à ouvrir chaque fichier Lua.

Si un script utilise des exports de framework, des bibliothèques de base de données ou une configuration partagée, documentez cela dans le README ou les notes du produit. La plupart des problèmes d'installation proviennent de dépendances manquantes ou d'un ordre de démarrage incorrect, et non de la syntaxe du manifeste elle-même.

Après avoir modifié le manifeste, redémarrez le serveur complet une fois. Les rechargements à chaud peuvent masquer des fichiers manquants ou des problèmes d'ordre qui n'apparaissent que lors d'un démarrage propre.

Si le démarrage propre échoue, lisez la première erreur, pas la dernière cascade d'erreurs après que les dépendances sont déjà cassées.

Couches de fxmanifest.lua pour les métadonnées, les scripts, les dépendances et les fichiers
Un manifeste de ressource déclare des métadonnées, des scripts exécutables, des dépendances et des fichiers empaquetés.

Lire un fxmanifest en quatre couches

  • Métadonnées : déclarer la version de FX, le jeu pris en charge et les détails utiles de l'auteur, de la description et de la version.
  • Scénarios : séparer délibérément l'exécution client, serveur et partagée ; ne pas exposer la logique serveur uniquement aux clients.
  • Dépendances: état des ressources ou des contraintes d'exécution qui doivent exister avant que cette ressource ne puisse s'exécuter.
  • Fichiers: inclure des NUI et des actifs de données dont les clients ont besoin. Cfx.re note qu'un local page_interface utilisateur et ses dépendances doivent être référencés dans fichiers.

Le manifeste est un Lua semi-déclaratif exécuté séparément des scripts de la ressource. Gardez-le explicite, supprimez les entrées obsolètes et vérifiez chaque chemin référencé sur un système de fichiers de production sensible à la casse.

Cfx.re référence du manifeste de ressource

Laisser un commentaire