Comment Installer des Scripts FiveM

Vous voulez ajouter des scripts sur votre serveur FiveM mais vous ne savez pas comment faire ? Pas de panique.

Ce guide vous explique comment installer n’importe quelle ressource proprement et sans erreur, même si vous débutez.

Qu’est-ce qu’un script FiveM ? Les bases à maîtriser

Un script, ou une « ressource », est un ensemble de fichiers qui ajoute des fonctionnalités à votre serveur FiveM. C’est ce qui vous permet de créer des jobs, d’ajouter des véhicules, de gérer les joueurs ou de modifier l’interface.

Ces ressources contiennent différents types de fichiers (Lua, JavaScript, HTML, CSS) et fonctionnent de deux manières :

• Côté client : Ce sont les scripts qui modifient ce que le joueur voit et fait. Par exemple, un menu, un compteur de vitesse ou des notifications.
• Côté serveur : Ces scripts gèrent la logique globale du jeu. Par exemple, le système économique, la sauvegarde des données des joueurs ou la gestion des permissions.

Avant d’installer un script, vous devez savoir à quelle catégorie il appartient. Il en existe trois principales :

• Standalone : Ces scripts fonctionnent tout seuls, sans avoir besoin d’autres ressources pour tourner. C’est souvent le cas pour des ajouts simples.
• Scripts ESX : Ils nécessitent le framework ESX, et notamment la ressource de base `es_extended`.
• Scripts QBCore : Ils sont conçus pour le framework QBCore et dépendent de la ressource `qb-core`.

Les scripts peuvent aussi être classés par leur fonction : gameplay (jobs, inventaire), administration (modération), interface (menus, HUD), ou ajouts de véhicules et de cartes (mappings).

Prérequis indispensables avant d’installer un script

Avant de toucher à quoi que ce soit, assurez-vous d’avoir tout ce qu’il faut. Ça vous évitera 90% des problèmes.

Voici votre checklist :

• Un serveur FiveM fonctionnel. Le serveur doit déjà tourner correctement sans aucun script ajouté.
• Un accès FTP ou SFTP (comme FileZilla) ou un gestionnaire de fichiers web pour transférer les fichiers sur votre hébergement.
• Une base de données MySQL prête à l’emploi si le script en a besoin (c’est souvent le cas pour les scripts qui sauvegardent des informations).
• Les droits pour modifier le fichier `server.cfg`. C’est le fichier principal de configuration de votre serveur.
• Savoir quel framework vous utilisez : ESX, QBCore ou aucun (standalone). Installer un script ESX sur un serveur QBCore ne marchera jamais.

Guide complet : installer un script FiveM étape par étape

Maintenant que les bases sont posées, on passe à la pratique. Le processus est toujours le même, quel que soit le script que vous voulez installer. Il suffit de suivre les étapes dans l’ordre.

Étape 1 : Trouver et télécharger une ressource fiable

La sécurité de votre serveur commence ici. Ne téléchargez jamais de scripts depuis des sources inconnues ou douteuses. Privilégiez les plateformes reconnues par la communauté.

Voici les sources recommandées :

• GitHub : La majorité des scripts gratuits et open-source y sont publiés. C’est la source la plus sûre.
• FiveM Forums : Le forum officiel de FiveM (Cfx.re) a une section dédiée aux sorties de ressources.
• Tebex : C’est la plateforme officielle pour acheter des scripts payants en toute sécurité.

Étape 2 : Vérifier la compatibilité et les dépendances

Avant même de transférer le moindre fichier, lisez la description du script (souvent dans un fichier `README.md` sur GitHub). C’est une étape cruciale pour éviter les erreurs.

Vérifiez ces quatre points :

• Framework : Le script est-il pour ESX, QBCore, ou est-il Standalone ? Il doit correspondre à votre serveur.
• Version du serveur : Certains scripts exigent une version minimale de l’artefact de votre serveur FiveM.
• Dépendances requises : La plupart des scripts complexes ont besoin d’autres ressources pour fonctionner. Ces « dependencies » sont toujours listées. Par exemple, beaucoup de scripts récents demandent `oxmysql` pour la base de données.
• Date de mise à jour : Un script qui n’a pas été mis à jour depuis plusieurs années a plus de chances de causer des problèmes.

Étape 3 : Préparer et transférer les fichiers sur le serveur

Une fois le script téléchargé (souvent un fichier .zip), décompressez-le sur votre ordinateur. Vous obtiendrez un dossier qui porte le nom de la ressource.

Ouvrez ce dossier. À l’intérieur, vous devez trouver un fichier essentiel : le `fxmanifest.lua`. Si ce fichier n’est pas directement visible, c’est que vous êtes peut-être dans un sous-dossier. Le bon dossier à transférer est celui qui contient directement le `fxmanifest.lua`.

La structure typique d’un dossier de script est :

• nom_de_la_ressource/
• ├── fxmanifest.lua
• ├── client/ (scripts côté client)
• ├── server/ (scripts côté serveur)
• ├── config.lua

Connectez-vous à votre serveur via FTP/SFTP et allez dans le dossier `resources`. C’est ici que tous vos scripts doivent être placés. Uploadez le dossier complet de votre nouvelle ressource à cet endroit.

Étape 4 : Configurer le script (base de données et fichiers)

Certains scripts ont besoin d’une petite configuration avant d’être activés.

Il y a deux choses à vérifier :

1. Le fichier `.sql` : Si le dossier du script contient un fichier avec l’extension `.sql`, vous devez l’importer dans votre base de données MySQL. Utilisez un outil comme phpMyAdmin pour le faire. Ce fichier crée les tables nécessaires pour que le script puisse stocker ses informations.
2. Le fichier `config.lua` : La plupart des scripts ont un fichier de configuration, souvent nommé `config.lua`. Ouvrez-le avec un éditeur de texte. C’est ici que vous pouvez traduire le script, changer des paramètres ou lier le script à d’autres ressources.

Étape 5 : Activer le script dans le fichier server.cfg

Le script est en place, mais le serveur ne le connaît pas encore. Il faut lui dire de le démarrer.

Ouvrez le fichier principal de votre serveur, le `server.cfg`. Allez à la fin du fichier, là où les autres scripts sont listés.

Ajoutez une nouvelle ligne pour démarrer votre ressource. Vous avez deux options :

• start nom_de_la_ressource
• ensure nom_de_la_ressource

Remplacez `nom_de_la_ressource` par le nom exact du dossier que vous avez uploadé. La commande `ensure` est souvent préférable car elle gère mieux l’ordre de chargement des dépendances. Si un script A a besoin d’un script B, `ensure` s’assure que B est chargé avant A.

Étape 6 : Redémarrer le serveur et vérifier

C’est la dernière étape. Pour que les changements soient pris en compte, vous devez redémarrer votre serveur FiveM complètement.

Une fois le serveur redémarré, la première chose à faire est de regarder la console du serveur. Cherchez une ligne verte qui dit `Started resource [nom_de_la_ressource]`. Si vous la voyez, c’est bon signe.

Si vous voyez des messages d’erreur en rouge liés au script, c’est qu’il y a un problème. L’erreur la plus courante est une dépendance manquante. Lisez bien le message, il vous indiquera souvent la cause du problème.

Enfin, connectez-vous au serveur en tant que joueur pour tester si la nouvelle fonctionnalité est bien présente et fonctionne comme prévu.

Bonnes pratiques et erreurs courantes à éviter

Pour gérer votre serveur sur le long terme sans vous arracher les cheveux, suivez ces quelques règles simples. La plupart des serveurs qui plantent le font à cause d’une mauvaise gestion des scripts.

• Ne jamais utiliser de scripts « leaked » : On le répète, mais c’est la règle d’or. Vous mettez en danger votre serveur et les données de vos joueurs.
• Vérifier les dépendances avant tout : Si un script ne fonctionne pas, la première chose à vérifier est que vous avez bien installé et démarré toutes ses dépendances dans le `server.cfg`.
• Respecter l’ordre de démarrage : Si vous utilisez `start`, assurez-vous de démarrer les dépendances AVANT les scripts qui en ont besoin. Avec `ensure`, l’ordre a moins d’importance.
• Privilégier les scripts maintenus : Un script mis à jour régulièrement est un gage de qualité et de compatibilité avec les futures versions de FiveM.
• Faire des sauvegardes : Avant d’installer un gros script qui modifie beaucoup de choses, faites une sauvegarde de votre dossier `resources` et de votre base de données.

Vous savez maintenant comment installer des scripts FiveM. Le processus est logique et répétitif. Une fois que vous l’avez fait deux ou trois fois, ça devient un automatisme.

Le plus important est d’être méthodique : vérifier les sources, lire la documentation et tester proprement. C’est la clé pour construire un serveur stable et personnalisé. Maintenant, c’est à vous de jouer pour créer le serveur que vous voulez.