Ce guide explique comment installer des ressources (scripts) sur votre serveur FiveM, configurer une base de données MySQL pour des frameworks comme ESX ou QBCore, et comprendre l'ordre de chargement des ressources. Si vous n'avez pas encore terminé la configuration initiale du serveur, commencez par le Guide de configuration du serveur FiveM.
server.cfg opérationnel. Consultez le Guide de configuration du serveur FiveM pour les étapes de configuration initiale.
Installation des ressources et des scripts
Les serveurs FiveM sont étendus avec des ressources (aussi appelées scripts). Les ressources ajoutent des fonctionnalités comme des concessionnaires automobiles, des métiers, des éléments HUD, des frameworks, et bien plus encore.
Comment installer une ressource
- Téléchargez la ressource depuis sa source (GitHub, forums Cfx.re, Tebex, etc.).
- Extrayez le dossier de la ressource depuis l'archive ZIP si nécessaire.
- Uploadez le dossier de la ressource dans le répertoire
resources/de votre serveur en utilisant l'onglet Files du GPanel ou via SFTP. - Ouvrez
server.cfget ajoutez une ligneensurepour la ressource :
# Add your custom resources
ensure my-new-resource- Redémarrez le serveur depuis GPanel ou TXAdmin pour que la ressource se charge.
ensure doit correspondre exactement au nom du dossier de la ressource (sensible à la casse). Si le dossier est my-cars, la ligne doit être ensure my-cars.
Manifestes de ressources
Chaque ressource valide doit contenir un fichier manifeste. Les ressources modernes utilisent fxmanifest.lua, tandis que les plus anciennes utilisent __resource.lua. Si un dossier de ressource téléchargé ne contient aucun de ces fichiers, la ressource ne se chargera pas. Certains téléchargements imbriquent le véritable dossier de ressource dans un dossier externe — assurez-vous que le dossier que vous placez dans resources/ est celui qui contient le manifeste.
Ordre de chargement des ressources
Les ressources se chargent dans l'ordre où elles apparaissent dans server.cfg. Si une ressource dépend d'une autre (par exemple, un script de métier qui dépend d'un framework comme ESX ou QBCore), assurez-vous que la dépendance est listée avant la ressource qui en a besoin :
# Database resource first
ensure oxmysql
# Framework second
ensure es_extended
# Then resources that depend on the framework
ensure esx_basicneeds
ensure esx_jobs
ensure esx_vehicleshopOrganiser les ressources avec des dossiers de catégories
Vous pouvez organiser les ressources dans des sous-dossiers à l'intérieur du répertoire resources/. Utilisez la notation entre crochets dans server.cfg pour charger un dossier de catégorie entier :
# Ensure all resources inside resources/[esx]/
ensure [esx]
# Ensure all resources inside resources/[standalone]/
ensure [standalone]Cela charge toutes les ressources contenues dans le sous-dossier nommé. C'est un moyen pratique de regrouper des scripts liés sans les lister individuellement.
Chargement à chaud des ressources via TXAdmin
Vous n'avez pas toujours besoin d'un redémarrage complet du serveur pour charger une nouvelle ressource. TXAdmin peut démarrer, arrêter et redémarrer des ressources individuelles depuis sa page Resources. Après avoir uploadé une nouvelle ressource et ajouté sa ligne ensure, vous pouvez exécuter la commande suivante dans la console en direct de TXAdmin :
refresh
ensure my-new-resourceLa commande refresh indique au serveur de rescanner le répertoire resources/ pour détecter les nouvelles entrées.
Configuration de la base de données (MySQL / MariaDB)
De nombreux frameworks et ressources FiveM (comme ESX, QBCore ou vRP) nécessitent une base de données MySQL ou MariaDB. Legion Hosting fournit les identifiants de base de données avec votre serveur.
Trouver vos identifiants de base de données
- Dans GPanel, allez dans l'onglet Databases.
- Si aucune base de données n'existe encore, cliquez sur New Database pour en créer une.
- Notez les informations suivantes :
- Hôte de la base de données (adresse et port)
- Nom de la base de données
- Nom d'utilisateur
- Mot de passe (cliquez sur l'icône en forme d'œil pour le révéler)
Configurer la connexion à la base de données
Les détails de connexion à la base de données sont définis dans server.cfg à l'aide d'une chaîne de connexion. Le format exact dépend de la ressource MySQL que vous utilisez, mais le format le plus courant est :
# MySQL connection string (oxmysql / mysql-async format)
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"Remplacez les espaces réservés par vos identifiants réels depuis l'onglet Databases. Par exemple :
set mysql_connection_string "mysql://u123_fivem:[email protected]:3306/s123_fivem?charset=utf8mb4"localhost ni 127.0.0.1.
@, # ou %, vous devez les encoder en URL dans la chaîne de connexion. Par exemple, @ devient %40 et # devient %23.
Choisir une ressource MySQL
| Ressource | Statut | Notes |
|---|---|---|
| oxmysql | Recommandé | Moderne, activement maintenu, meilleures performances. Utilisé par la plupart des frameworks actuels. |
| mysql-async | Ancien | Plus ancien mais fonctionne toujours. Certains anciens scripts en dépendent spécifiquement. |
| ghmattimysql | Ancien | Une autre option plus ancienne. Consultez la documentation de votre framework s'il le nécessite. |
Quelle que soit la ressource MySQL que vous utilisez, elle doit être chargée dans server.cfg avant toute ressource qui en dépend :
# Database connection
set mysql_connection_string "mysql://USERNAME:PASSWORD@HOST:PORT/DATABASE_NAME?charset=utf8mb4"
# MySQL resource — must load before framework
ensure oxmysql
# Framework
ensure es_extendedLes bases des frameworks
Un framework fournit les systèmes de gameplay de base sur lesquels les autres ressources s'appuient — des éléments comme l'identité des joueurs, l'argent, l'inventaire, les métiers et les véhicules. Les deux frameworks FiveM les plus populaires sont :
| Framework | Nom de la ressource | Description |
|---|---|---|
| ESX | es_extended |
Le framework le plus largement utilisé. Grand écosystème de scripts gratuits et payants. Idéal pour les serveurs roleplay. |
| QBCore | qb-core |
Alternative moderne à ESX. Code plus propre, développement actif. Écosystème de scripts en croissance. |
La plupart des frameworks sont installés via le système de recettes de TXAdmin lors de la configuration initiale. Si vous avez choisi une recette comme « QBCore » ou « ESX » lors de la configuration de TXAdmin, le framework et ses dépendances principales sont déjà installés. Si vous devez installer un framework manuellement, suivez sa documentation officielle :
Obtenir de l'aide
Si vous avez besoin d'assistance pour l'installation de ressources ou la configuration de la base de données :
- Consultez la documentation de la ressource ou sa page GitHub pour les instructions d'installation et les problèmes connus.
- Vérifiez la console GPanel ou les logs TXAdmin pour les messages d'erreur.
- Ouvrez un ticket de support à https://legionhosting.net/submitticket.php avec vos messages d'erreur et le nom de la ressource que vous essayez d'installer.
