Installer des scripts FiveM : étape par étape

Les serveurs FiveM tournent grâce aux « resources » : des scripts qui ajoutent des fonctionnalités. Une voiture de police, un système bancaire, une station-service, un garage, une boutique de vêtements : tout est une resource. L'installation suit toujours le même schéma, mais il y a des pièges qui peuvent casser votre serveur si vous ne les connaissez pas.

Où trouver des scripts

• Forums Cfx.re : sorties gratuites de la communauté.
• Tebex (anciennement buycraft) : scripts premium payants. Boutiques populaires : ESX Scripts, QBCore Framework, Renewed Scripts.
• GitHub : beaucoup de scripts open-source. Cherchez « fivem qbcore » ou « fivem esx » suivi de la fonction.

Vérifiez toujours que le script est compatible avec votre framework (ESX, QBCore, Qbox ou standalone).

Installer en cinq étapes

1. Télécharger : téléchargez le script en zip ou clonez le dépôt Git.
2. Extraire : décompressez le zip et renommez le dossier si nécessaire. Le nom du dossier est le nom de la resource.
3. Envoyer : envoyez le dossier dans resources/ sur votre serveur. La plupart des serveurs organisent les scripts en sous-dossiers : resources/[esx]/, resources/[qb]/, resources/[standalone]/.
4. Configurer : ouvrez le fichier config.lua ou shared/config.lua dans le dossier du script et ajustez les paramètres. Langue, prix, emplacements, niveaux d'accès : tout est dans le config.
5. Ajouter à server.cfg : ajoutez ensure nomscript à votre server.cfg. L'ordre est important : les dépendances doivent précéder les scripts qui en ont besoin.

Dépendances

La plupart des scripts ont des dépendances. Les plus courantes :

• oxmysql ou mysql-async : connecteur de base de données. Voir connecter une base de données.
• ox_lib : bibliothèque utilitaire utilisée par de nombreux scripts modernes. Téléchargez depuis GitHub.
• ox_inventory ou qb-inventory : le système d'inventaire de votre framework.
• ox_target ou qb-target : le système d'interaction (cibles 3D sur les objets).

Les dépendances sont listées dans le fxmanifest.lua du script. Si une dépendance manque, vous obtenez un message d'erreur dans la console au démarrage.

Le bon ordre dans server.cfg

L'ordre des ensure détermine dans quel ordre les resources sont chargées. Une structure courante :

ensure oxmysql
ensure ox_lib
ensure es_extended    # ou qb-core/qbx_core
ensure ox_inventory
ensure ox_target
ensure esx_policejob  # ou vos scripts

La règle de base : les bases de données d'abord, puis les bibliothèques, puis le framework, puis les scripts qui s'y appuient.

Importer le SQL

Les scripts qui stockent des données (garages, propriétés, emplois) ont besoin de tables SQL. Le fichier SQL se trouve généralement dans le dossier principal du script. Importez-le via phpMyAdmin (bouton dans le panneau de jeu à côté de la base de données). Faites-le une seule fois ; les tables persistent.

Erreurs courantes

• Le nom du dossier commence par un point ou contient des espaces : FiveM ne charge pas la resource. Utilisez uniquement des lettres, chiffres et tirets.
• Nom de resource en double : deux dossiers avec le même nom. Le premier est chargé, le second ignoré sans message d'erreur.
• Script pour un autre framework : un script ESX sur un serveur QBCore donne des erreurs incompréhensibles. Vérifiez la compatibilité avant de télécharger.
• config.lua manquant : certains scripts s'attendent à ce que vous renommiez config.lua.example en config.lua.

Puis-je recharger des scripts en direct sans redémarrage ?

Oui. Tapez ensure nomscript dans la console du serveur ou dans txAdmin. La resource est rechargée. Attention : tous les scripts ne supportent pas le rechargement à chaud. Si le script se comporte étrangement après un rechargement, redémarrez le serveur entier.

Combien de scripts mon serveur peut-il supporter ?

Cela dépend de la qualité des scripts et de la mémoire. Un serveur 4 Go fait facilement tourner 50 à 80 scripts légers. Les scripts lourds (grandes maps, beaucoup d'assets en streaming) coûtent plus. Surveillez les FPS du serveur dans txAdmin : en dessous de 30, c'est un signe que vous devez optimiser ou mettre à niveau.

Les scripts payants sont-ils meilleurs que les gratuits ?

Pas forcément. Il existe d'excellents scripts gratuits (ox_inventory, qb-target, okokGarage) et de mauvais scripts payants. Lisez les avis sur le forum avant d'acheter. Les créateurs premium les plus connus (Renewed, ox-team) livrent généralement une haute qualité.

Les scripts tournent sur tous les packs FiveM de HostValues. Pour les questions sur l'installation, vous pouvez ouvrir un ticket.