Comment installer un script FiveM (ressource) étape par étape

Pour installer un script FiveM, copiez le dossier de sa ressource (celui qui contient fxmanifest.lua) dans le répertoire resources de votre serveur, démarrez d'abord ses dépendances, configurez-le, ajoutez une ligne ensure après celles-ci dans server.cfg et lisez la console. Faites d'abord une sauvegarde.

Vérifié d'après la documentation de Cfx.re et des frameworks liée ici, le 2026-10-13. Il s'agit d'une revue de documentation, pas d'un test pratique : RPScripts n'a pas exécuté ces étapes dans un environnement de test isolé. Les étapes supposent GTA V Legacy ; Enhanced n'est signalé qu'à l'étape 1. Tout ce qui est écrit en monospace, comme resource_name, est un espace réservé pour votre propre valeur.

Étape 1 : vérifier l'édition, le framework et les dépendances

Lisez la page produit ou le readme et notez : le framework (ESX, QBCore, Qbox ou standalone), les bibliothèques requises, les ressources d'inventaire et de target, ainsi que l'édition de GTA V prise en charge. Un badge de framework ne vous indique pas l'édition.

La page Legacy/Enhanced de Cfx.re décrit un serveur Enhanced avec des fichiers serveur nommés différemment, un dossier stream_enhanced pour les assets qui diffèrent de stream, et indique Asset Escrow comme “Not implemented yet” pour Enhanced. Demandez au créateur quelle version exacte utiliser si vous êtes sous Enhanced. Contexte : FiveM Standard vs Enhanced : quelle version choisir ?.

Vérification de réussite : vous pouvez lister le framework, l'édition et les dépendances à partir du texte du créateur lui-même. Si ce n'est pas le cas : arrêtez-vous et interrogez le vendeur avant d'installer.

Étape 2 : sauvegarder pour pouvoir revenir en arrière

Copiez server.cfg, les dossiers de ressources que vous allez modifier et tous les fichiers partagés d'objets ou de métiers, puis exportez la base de données. Essayez d'abord l'installation sur un serveur de test avec une base de test. Voir Comment sauvegarder et restaurer un serveur FiveM.

Vérification de réussite : vous savez où se trouvent les copies et quel fichier vous restaureriez en premier.

Étape 3 : décompresser et trouver le dossier de la ressource

Extrayez l'archive. Une ressource est un dossier contenant fxmanifest.lua directement à sa racine ; l'introduction aux ressources de Cfx.re indique : “Every resource is required to contain a resource manifest by the name of fxmanifest.lua”. Un même téléchargement peut contenir plusieurs ressources, et un zip peut ajouter un dossier enveloppe supplémentaire.

Vérification de réussite : chaque dossier que vous allez copier a fxmanifest.lua à son niveau supérieur, et non un dossier plus bas. Preuve en cas d'erreur : une liste du contenu du dossier montrant où se trouve le manifeste.

Téléchargez la bonne version. Deux exemples documentés indiquent d'utiliser une release et non l'archive source du dépôt : la documentation QBCore demande d'utiliser le build release d'oxmysql, et la documentation ox_inventory précise que l'interface doit être compilée (bundled) et recommande la release pré-compilée (ox_inventory.zip).

Étape 4 : placer dans resources en gardant le nom du dossier

Déplacez chaque dossier de ressource dans resources, ou dans un dossier à crochets tel que resources/[scripts]. Les commandes serveur de Cfx.re acceptent les noms entre crochets comme catégories, par exemple start [cars].

Dans l'arborescence d'exemple de Cfx.re, la ressource porte le nom de son dossier : le nom du dossier est donc celui que vous passez à ensure, et les scripts qui en dépendent s'y réfèrent généralement sous ce nom. La page de Cfx.re dit que vous êtes libre de nommer les dossiers comme vous voulez, mais renommer un script acheté est un risque que RPScripts déconseille, sauf si le créateur l'indique.

Vérification de réussite : le chemin ressemble à resources/[optional_group]/resource_name/fxmanifest.lua. Sous Linux, la casse compte.

Étape 5 : lire le manifeste

Ouvrez fxmanifest.lua sans le modifier. La référence du manifeste liste fx_version et game (gta5 fonctionne sur FiveM, rdr3 sur RedM), et dit de dependency : “Requires the specified resource to load before the current resource.” Chaque fichier nommé dans client_script, server_script, shared_script ou files doit exister dans le dossier. Pour en écrire un vous-même, voir Comment écrire et vérifier un fxmanifest.lua FiveM et le générateur de fxmanifest.

Vérification de réussite : vous pouvez nommer chaque dépendance et chaque fichier listé existe.

Étape 6 : installer et démarrer les dépendances

Dépendance	Pourquoi c'est important	Source
oxmysql	Accès à la base de données. Définissez mysql_connection_string avec set avant le démarrage de toute ressource, et démarrez oxmysql tout en haut de la liste.	documentation oxmysql
ox_lib	Utilisée via shared_scripts { '@ox_lib/init.lua' } dans le manifeste d'une ressource ; la bibliothèque doit donc être installée.	documentation ox_lib
Framework	es_extended, qb-core ou qbx_core doivent tourner avant les scripts qui les utilisent.	Voir le tableau des frameworks à l'étape 12
Inventaire et target	Doivent correspondre aux options de la config du script (par exemple ox_inventory contre qb-inventory).	Le readme du script

Lister vous-même chaque dépendance dans server.cfg, dans l'ordre, est une précaution de RPScripts, pas une exigence documentée.

Vérification de réussite : chaque dépendance est installée et fonctionne déjà seule.

Étape 7 : importer le SQL avec précaution

Seuls certains scripts fournissent un fichier .sql. Lisez-le avant de l'exécuter : DROP TABLE, TRUNCATE, DELETE, REPLACE et ALTER TABLE peuvent supprimer ou modifier des données existantes, et CREATE TABLE IF NOT EXISTS ne vérifie pas qu'une table existante a les bonnes colonnes. Un fichier d'installation neuve n'est pas une mise à jour. Importez dans la base nommée dans votre chaîne de connexion, d'abord sur la base de test. Détails et erreurs courantes : fichiers SQL et erreurs de base de données.

La page d'installation de Qbox exige MariaDB 10.9.0 ou plus récent, pas MySQL. Comparez votre propre moteur de base de données à l'exigence du framework avant d'importer.

Vérification de réussite : l'import ne signale aucune erreur et les tables attendues existent. Preuve en cas d'échec : l'instruction en échec et l'erreur exacte, mots de passe retirés.

Étape 8 : la configurer

Modifiez config.lua (ou le dossier config) pour que les options de framework, d'inventaire, de target et de notification pointent vers des ressources que vous exécutez réellement. Enregistrez les objets dont le script a besoin dans le système d'objets de votre framework. Les notes par framework se trouvent dans le tableau de l'étape 12.

Vérification de réussite : chaque nom de ressource de la config existe dans votre dossier resources.

Étape 9 : ajouter la ligne ensure dans le bon ordre

# server.cfg (placeholders: use your own framework and resources)
set mysql_connection_string "..."   # your own value, keep it private
ensure oxmysql
ensure ox_lib
ensure your_framework
ensure your_inventory_and_target

ensure resource_name

La documentation d'oxmysql dit d'ajouter start oxmysql “to the top of your resource list” et la page ox_inventory pour Qbox dit de le démarrer “immediately after qbx_core” : l'ordre compte donc. Votre script vient après tout ce dont il dépend. Ordre de démarrage par framework : QBCore, ESX, Qbox ; référence générale : Configurer le server.cfg de FiveM et vérifier vos modifications et le générateur de server.cfg. Les commentaires dans server.cfg commencent par #, comme dans le modèle QBCore.

Vérification de réussite : votre ligne se trouve sous celle de chaque dépendance.

Étape 10 : la démarrer et vérifier le résultat

La page commandes serveur de Cfx.re documente refresh, qui réanalyse resources et charge les manifestes pour que les nouvelles ressources puissent être démarrées, et ensure, qui démarre une ressource ou la redémarre si elle tourne déjà. Dans la console du serveur, exécutez refresh, puis ensure resource_name ; redémarrer le serveur la charge aussi. Après l'ajout d'objets, de métiers ou de SQL, RPScripts suggère par précaution un redémarrage complet (conseil éditorial, pas une affirmation de Cfx.re).

1. Aucune ligne d'erreur ne mentionne resource_name dans la console du serveur.
2. Connectez-vous avec un compte de test et appuyez sur F8 : aucune ligne d'erreur pour la ressource.
3. Utilisez la fonctionnalité (ouvrez son menu, utilisez l'objet, entrez dans la zone).
4. Reconnectez-vous et redémarrez une fois pour confirmer que les données enregistrées sont conservées.

Éléments à rassembler si une vérification échoue : la première ligne d'erreur après le démarrage (pas la dernière), le nom de la ressource, votre framework et sa version, le numéro d'artefact FXServer, l'édition, et le bloc ensure au-dessus et en dessous de votre ligne. Si elle ne démarre pas, poursuivez avec Une ressource FiveM ne démarre pas : corriger les erreurs selon le message de la console.

Étape 11 : revenir en arrière proprement

Exécutez stop resource_name, mettez un # devant sa ligne ensure, puis restaurez les fichiers de config et la base de données à partir de votre sauvegarde de l'étape 2. Conservez l'export de la base de données de l'étape 2, car un fichier SQL partiellement importé n'est pas annulé en arrêtant la ressource.

Étape 12 : différences entre frameworks

Framework	Ressource principale	Objets et données	Source
ESX	es_extended	Les objets et les métiers se trouvent dans des tables de la base de données, sauf si vous utilisez ox_inventory (voir les notes ESX de RPScripts). La page de dépannage d'ESX liste “Error ESX = nil” avec la solution “update your es_extended to the latest version”.	documentation ESX
QBCore	qb-core	Le modèle démarre ensure qb-core, puis ensure [qb] et [standalone].	documentation QBCore
Qbox	qbx_core	Utilise ox_inventory : ajoutez setr inventory:framework "qbx" avant le démarrage des ressources et démarrez ox_inventory juste après qbx_core.	configuration d'ox_inventory pour Qbox
Standalone	aucune	N'a besoin que de ce que son readme indique.	Créateur

Un script conçu pour un framework ne s'installe pas sur un autre par simple copie ; voir Convertir des scripts FiveM entre ESX, QBCore et Qbox. RPScripts vend des scripts, ce lien de catégorie est donc commercial : Scripts QBCore. Les étapes décrites ici s'appliquent à une ressource de n'importe quelle origine.

Ressources protégées par escrow

Les ressources protégées par Cfx.re Asset Escrow contiennent généralement un fichier .fxap ; voir Qu'est-ce qu'un fichier .fxap dans une ressource FiveM ?. Ne modifiez, ne fusionnez et ne supprimez pas les fichiers protégés. Selon la documentation Cfx.re Asset Escrow, un serveur sans le bon droit d'accès (entitlement) ne peut pas démarrer la ressource et affiche “You lack the required entitlement” dans la console ; les solutions se trouvent dans Comment corriger l'erreur d'entitlement requis de FiveM. La documentation décrit une directive escrow_ignore qui permet à un créateur de laisser certains fichiers, comme une config, non protégés ; ne modifiez que les fichiers que le créateur nomme. Les documentations de vendeurs signalent que des transferts de fichiers corrompus cassent les ressources sous escrow. JG Scripts recommande d'envoyer le .zip tel quel et de l'extraire après le transfert plutôt que de transférer les fichiers un par un, et indique que FileZilla peut corrompre des fichiers (essayez WinSCP) ; Lation indique que FileZilla corrompt fréquemment les fichiers sous escrow et recommande WinSCP. Il s'agit de conseils de vendeurs, pas d'une affirmation de Cfx.re.

FAQ

Dois-je redémarrer le serveur après avoir ajouté un script ?

Pas toujours. refresh puis ensure resource_name charge une nouvelle ressource, selon la documentation de Cfx.re. Après l'ajout d'objets, de métiers ou de modifications SQL, un redémarrage complet est une précaution de RPScripts.

Puis-je installer un script QBCore sur ESX ou Qbox ?

Pas par simple copie. Consultez la page produit pour votre framework ; un script qui appelle l'inventaire ou les fonctions principales d'un autre framework nécessite une conversion ou un bridge documenté par le créateur.