fxmanifest.lua : Qu’est-ce que c’est ? + Exemple

Si vous développez ou personnalisez votre serveur FiveM, vous avez forcément croisé ce petit fichier nommé fxmanifest.lua.
On pourrait le comparer à la carte d’identité d’une ressource : sans lui, FiveM ne sait pas vraiment qui vous êtes, ni comment vous fonctionnez.

Mais alors, à quoi sert ce fichier ?

Imaginez que votre serveur FiveM soit un festival de musique. Chaque ressource (script) serait un groupe invité.
Eh bien, fxmanifest.lua, c’est l’affiche du festival :

  • Elle annonce le nom du groupe,
  • Son style musical (ou plutôt ici, le langage utilisé),
  • Les horaires de passage (les fichiers à charger et dans quel ordre).

En clair, ce fichier est lu en premier par FiveM lorsqu’une ressource est démarrée.
Il donne toutes les infos essentielles : auteur, version, fichiers utilisés, scripts côté client ou serveur, dépendances…

Pourquoi c’est important pour vous ?

Parce que sans un fxmanifest.lua bien construit, votre ressource risque :

  • de ne pas se lancer,
  • de provoquer des erreurs bizarres,
  • ou même de casser d’autres scripts (et là, bonjour les nuits blanches…).

C’est un peu comme partir en vacances sans GPS : vous pouvez essayer, mais vous risquez de tourner en rond.

Hebergeur FiveM

Structure de base d’un fxmanifest.lua

Voici un exemple simple pour comprendre :

fx_version 'cerulean'
game 'gta5'

author 'VotreNom'
description 'Ma super ressource FiveM'
version '1.0.0'

-- Scripts côté client
client_scripts {
    'client.lua'
}

-- Scripts côté serveur
server_scripts {
    'server.lua'
}

-- Fichiers partagés
shared_scripts {
    'config.lua'
}

Décryptage rapide :

  • fx_version : la “version” du manifest, la plus récente est souvent cerulean (mais il en existe d’autres comme bodacious ou adamant).
  • game : indique à quel jeu votre script s’adresse (gta5, parfois rdr3).
  • client_scripts : tout ce qui tourne sur le PC du joueur.
  • server_scripts : tout ce qui tourne sur la machine qui héberge le serveur.
  • shared_scripts : des fichiers utilisés des deux côtés.
A lire aussi :  Lancement des nouvelles offres FiveM Enhanced : propulsez votre serveur GTA

Les bonnes pratiques qu’on vous recommande

Pour éviter les mauvaises surprises, pensez à :

  • Toujours utiliser fx_version à jour,
  • Bien séparer vos scripts client et serveur,
  • Donner un nom clair à vos ressources,
  • Versionner vos fichiers (1.0.1, 1.0.2, etc.) pour mieux suivre vos mises à jour,
  • Ne pas surcharger le manifest : il doit rester lisible.

💡 Astuce de pro :
Si vous reprenez un vieux script qui utilise __resource.lua (ancienne méthode), pensez à le convertir en fxmanifest.lua. C’est plus moderne, mieux optimisé, et recommandé par l’équipe FiveM depuis 2019.

En résumé

Le fxmanifest.lua, c’est un peu le chef d’orchestre de vos scripts FiveM. Sans lui, c’est la cacophonie. Avec lui, tout se lance dans le bon ordre, avec les bonnes instructions.
Alors prenez le temps de le remplir proprement, votre serveur vous dira merci… et vos joueurs aussi.

fxmanifestlua