Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

FiveM

Comment installer QBCore : recette txAdmin, installation manuelle et premier admin

26 août 2026 16 min de lecture Mis à jour :
Partager cet article

Dans ce guide, vous découvrirez deux façons d'installer QBCore sur un serveur FiveM : avec la recette prête à l'emploi de txAdmin et manuellement depuis les dépôts GitHub. Vous verrez aussi comment connecter MariaDB et oxmysql, l'ordre des lignes ensure dans server.cfg, comment créer le premier administrateur à la fois dans txAdmin et dans qb-core, ainsi que les solutions aux erreurs courantes ; un rapide tour d'horizon de Qbox figure à la fin.

Avant de commencer

QBCore est un framework open source conçu pour les serveurs roleplay sur FiveM : les données des joueurs, les métiers, l'inventaire et l'économie sont regroupés autour d'une seule ressource centrale (qb-core). Pour l'installation, il vous faut :

  • Un VDS : Windows Server ou Ubuntu/Debian. Sur FiveM, c'est la vitesse monocœur qui compte le plus ; chez HanHosting, la gamme recommandée pour cet usage est le VDS AMD Ryzen 9 9950X. Pour les offres prêtes à l'emploi, consultez la page Location de serveur FiveM.
  • Une clé de serveur Cfx.re : vous l'obtenez gratuitement sur portal.cfx.re (anciennement appelée clé de licence Keymaster ; txAdmin nomme ce champ « Server Registration Key »). Le même compte Cfx.re sert aussi à se connecter à txAdmin.
  • MariaDB : la documentation de QBCore, comme celle d'oxmysql, recommande MariaDB ; la documentation d'oxmysql déconseille d'installer XAMPP uniquement pour la base de données. Sous Windows, HeidiSQL suffit pour consulter les tables.
  • Des ports ouverts : 30120 en TCP+UDP (jeu) et 40120 en TCP (panel txAdmin) dans le pare-feu du système d'exploitation. Le pare-feu est entre vos mains : c'est depuis le système d'exploitation que vous ouvrez les ports.
  • Outils : 7-Zip et Git (qui inclut Git Bash) sous Windows ; git, xz-utils et screen sous Linux. Si vous installez un serveur « FiveM for GTAV Enhanced », il vous faut aussi le Microsoft Visual C++ 2017 Redistributable sous Windows.

1. Installez MariaDB et créez la base de données

Linux (Ubuntu/Debian) :

sudo apt-get update
sudo apt-get install mariadb-server
sudo mariadb-secure-installation
sudo mariadb

Ces outils peuvent aussi être appelés par leurs anciens noms (mysql_secure_installation, mysql). Dans la console SQL qui s'ouvre, créez une base de données distincte pour QBCore et un utilisateur qui n'a des droits que sur cette base. Remplacez YOUR_PASSWORD par votre propre mot de passe ; la documentation d'oxmysql demande d'éviter les caractères ; , / ? : @ & = + $ # dans la chaîne de connexion : ne les utilisez donc pas dans le mot de passe.

CREATE DATABASE qbcore CHARACTER SET utf8mb4;
CREATE USER 'qbcore'@'localhost' IDENTIFIED BY 'YOUR_PASSWORD';
GRANT ALL PRIVILEGES ON qbcore.* TO 'qbcore'@'localhost';
EXIT;

Comme la base de données tourne sur la même machine que le serveur de jeu, laissez bind-address sur 127.0.0.1 et n'ouvrez pas le port 3306 vers l'extérieur. Si vous voulez la consulter à distance avec HeidiSQL, utilisez un tunnel SSH.

Windows : téléchargez le paquet MSI sur mariadb.com et installez-le ; définissez un mot de passe root pendant l'installation. Ouvrez une session localhost dans HeidiSQL et exécutez les mêmes commandes SQL (sauf EXIT) dans la fenêtre de requête. Vous n'avez besoin ni d'Apache ni de XAMPP.

2. Téléchargez FXServer et lancez txAdmin

Les fichiers du serveur (artifacts) se téléchargent depuis la page « Download Server Artifact » de docs.fivem.net ; choisissez « Recommended » comme Update Branch. Vous obtenez server.7z pour Windows et fx.tar.xz pour Linux. La version officielle de ces étapes se trouve dans le guide d'installation txAdmin de FiveM.

Windows : extrayez l'archive dans un dossier tel que C:\FXServer\server et double-cliquez sur FXServer.exe (dans le build Enhanced, le fichier s'appelle cfx-server.exe). Tant que vous ne passez pas le paramètre +exec server.cfg, FXServer lance automatiquement txAdmin et la page d'installation s'ouvre dans votre navigateur.

Linux :

mkdir -p ~/FXServer/server && cd ~/FXServer/server
wget <fx.tar.xz-link-copied-from-the-download-page>
tar xf fx.tar.xz
screen -S fivem
bash run.sh

La console affiche l'adresse http://SERVER-IP:40120 et un PIN. Ouvrez cette adresse dans votre navigateur, vérifiez que le PIN est rempli, associez votre compte Cfx.re avec « Link Account » et définissez votre mot de passe d'administrateur txAdmin. Ce compte est l'administrateur Master de txAdmin. Au premier lancement, un dossier txData est créé pour les fichiers de txAdmin. Vous pouvez vous détacher de la session screen avec Ctrl+A puis D ; le serveur continue de tourner.

3. Installez QBCore avec la recette txAdmin

Lorsque l'assistant d'installation demande le type de déploiement, choisissez la recette QBCore Framework dans la section Popular Recipes et acceptez le chemin du dossier de données proposé par txAdmin. L'écran Recipe Deployer comporte quatre étapes :

  1. Review Recipe : parcourez le contenu de la recette et cliquez sur Next.
  2. Input Parameters : collez dans le champ « Server Registration Key » la clé obtenue sur le Cfx.re Portal. Dépliez les champs de base de données avec Show/Hide Database options (advanced) : hôte localhost, port 3306, l'utilisateur et le mot de passe créés à l'étape 1, nom de la base qbcore. Si l'option Delete Database est activée, une base existante portant le même nom est supprimée avec toutes ses données ; si vous utilisez une base qui contient déjà des données, désactivez cette option. Cliquez ensuite sur Run Recipe.
  3. Run Recipe : la recette se connecte d'abord à la base de données (connect_database) et exécute le fichier qbcore.sql qui contient toutes les tables (query_database), puis télécharge les ressources. Une fois terminé, cliquez sur Next.
  4. Configure server.cfg : vérifiez le fichier généré et démarrez le serveur avec Save & Run Server. N'interrompez pas le premier lancement ; la documentation de QBCore demande expressément d'attendre la fin de l'installation de yarn au premier démarrage.

Voici ce que fait la recette : elle télécharge les ressources cfx-server-data dans resources/[cfx-default], et qb-core avec plus d'une cinquantaine de ressources qb-* dans resources/[qb] ; elle place les dépendances comme oxmysql (version 2.14.1, figée dans la recette), menuv, PolyZone, progressbar, interact-sound et connectqueue dans le dossier [standalone], et pma-voice et qb-radio dans le dossier [voice] ; elle ajoute les maps de l'hôpital, de la concession automobile et de la prison sous [defaultmaps] et met en place un fichier server.cfg prêt à l'emploi.

4. Installation manuelle : depuis GitHub

Si vous ne voulez pas utiliser la recette, ou si vous voulez ajouter QBCore à une installation FXServer existante, vous pouvez mettre les mêmes éléments en place à la main. Il vous faut d'abord un dossier server-data fonctionnel, comme dans le guide Installer FXServer : un serveur FiveM de zéro (Windows et Linux). Les dépôts QBCore se trouvent dans l'organisation qbcore-fivem sur GitHub ; les anciennes adresses github.com/qbcore-framework redirigent vers celle-ci.

Les ressources dépendent les unes des autres : qb-inventory nécessite qb-weapons, qb-adminmenu nécessite menuv, qb-target nécessite PolyZone, qb-multicharacter et qb-spawn nécessitent qb-apartments, et qb-apartments nécessite à son tour qb-interior, qb-clothing et qb-weathersync. La liste ci-dessous est l'ensemble de base qui satisfait cette chaîne :

cd ~/FXServer/server-data/resources
mkdir -p "[qb]" "[standalone]" "[voice]"
cd "[qb]"
for r in qb-core qb-multicharacter qb-spawn qb-apartments qb-interior qb-clothing qb-weathersync qb-inventory qb-weapons qb-target qb-adminmenu qb-menu qb-input; do
  git clone https://github.com/qbcore-fivem/$r.git
done

Sous Windows, exécutez les mêmes commandes dans Git Bash ; remplacez la première ligne par cd /c/FXServer/server-data/resources. qb-hud, qb-phone, qb-garages, qb-policejob, qb-banking et les autres ressources de la recette se trouvent dans la même organisation ; la liste complète figure dans le fichier qbcore.yaml du dépôt txAdminRecipe.

Dépendances :

  • oxmysql : téléchargez le fichier oxmysql.zip de la dernière release sur github.com/overextended/oxmysql/releases et extrayez-le dans [standalone]. Ne clonez pas le dépôt ; la documentation d'oxmysql demande de télécharger le paquet de la release, et il n'y a pas de fxmanifest.lua à la racine du dépôt.
  • menuv : requis par qb-adminmenu. Extrayez le fichier menuv_v1.4.1.zip de github.com/ThymonA/menuv/releases dans le dossier [standalone]/menuv.
  • PolyZone, progressbar, interact-sound, connectqueue : clonez-les depuis l'organisation qbcore-fivem dans [standalone]. qb-clothing et qb-apartments utilisent aussi les fichiers de PolyZone.
  • pma-voice (github.com/AvarianKnight/pma-voice) et qb-radio : dans [voice].

Importez les tables de la base de données depuis le fichier qbcore.sql du dépôt qbcore-fivem/txAdminRecipe ; ce fichier crée 24 tables en utf8mb4, dont players, bans, player_vehicles, player_houses, bank_accounts, apartments, playerskins et inventories. Le qbcore.sql du dépôt qb-core ne contient que les tables players, bans et player_contacts ; il ne suffit pas à lui seul.

wget https://raw.githubusercontent.com/qbcore-fivem/txAdminRecipe/main/qbcore.sql
mariadb -u qbcore -p qbcore < qbcore.sql

Sous Windows, sélectionnez la base de données dans HeidiSQL, ouvrez le même fichier avec File → Load SQL file (Fichier → Charger un fichier SQL) et exécutez-le.

5. server.cfg : chaîne de connexion et ordre des ensure

Si vous avez installé avec la recette, server.cfg se modifie sur la page CFG Editor de txAdmin ; pour une installation manuelle, ouvrez le fichier server-data/server.cfg. Le squelette ci-dessous est une version simplifiée du fichier généré par la recette et suit le même ordre :

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
sv_maxclients 48
sv_licenseKey "cfxk_YOUR_KEY"
sv_enforceGameBuild 3095

set mysql_connection_string "mysql://qbcore:YOUR_PASSWORD@localhost:3306/qbcore"

ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure basic-gamemode
ensure hardcap
ensure baseevents

ensure qb-core
ensure [qb]
ensure [standalone]
ensure [voice]

setr qb_locale "en"
setr UseTarget false
setr voice_useNativeAudio true

Points à surveiller :

  • mysql_connection_string se définit toujours avec set ; la documentation d'oxmysql demande de n'utiliser que set. Le second format valide est : user=qbcore;password=YOUR_PASSWORD;host=localhost;port=3306;database=qbcore. En cas d'erreur de connexion, la documentation conseille de passer à l'autre format et de réessayer.
  • La documentation d'oxmysql demande de démarrer oxmysql avant les autres ressources. La recette le garantit non pas avec une ligne séparée mais par une dépendance : le fichier fxmanifest.lua de qb-core déclare oxmysql comme dependency, et FiveM le charge avant qb-core. Si vous placez oxmysql en dehors de [standalone], ajoutez ensure oxmysql en haut de la liste.
  • qb-core passe avant tout le reste du dossier [qb]. Un nom de dossier entre crochets, comme dans ensure [qb], démarre toutes les ressources de ce dossier. La recette ajoute aussi une ligne ensure [defaultmaps] pour les maps.
  • OneSync : si sv_maxclients vaut 32 ou plus, OneSync doit être activé. Si vous faites tourner le serveur avec txAdmin, OneSync se gère uniquement depuis les réglages de txAdmin et la ligne onesync de server.cfg est commentée ; la recette QBCore l'active d'elle-même. Si vous lancez le serveur sans txAdmin, ajoutez set onesync on au fichier.
  • sv_enforceGameBuild 3095 impose le build du DLC « The Chop Shop » ; la recette écrit cette valeur par défaut.
  • Si vous définissez setr UseTarget true, les interactions passent par qb-target ; si vous laissez false, les interactions se font avec la touche E, à l'aide d'un texte affiché à l'écran.

Pour une installation manuelle, démarrez le serveur depuis le dossier server-data avec le paramètre +exec. Linux :

cd ~/FXServer/server-data && bash ~/FXServer/server/run.sh +exec server.cfg

Windows :

cd /d C:\FXServer\server-data
C:\FXServer\server\FXServer.exe +exec server.cfg

6. Créez le premier administrateur : permissions txAdmin et qb-core

Il existe deux niveaux de permissions distincts : le panel txAdmin et les commandes qb-core en jeu.

Les permissions txAdmin servent à gérer le panel : démarrer/arrêter le serveur, gérer les ressources, les bans et les kicks. Le compte créé pendant l'installation est le Master et dispose de toutes les permissions. Pour ajouter d'autres admins, utilisez la page Admins (Admin Manager) du menu du haut ; les enregistrements sont conservés dans le fichier txData/admins.json. Les permissions s'accordent une par une, comme control.server, console.write, players.ban et server.cfg.editor. Les admins ne peuvent être gérés que par le compte Master et par ceux qui disposent de la permission all_permissions ou manage.admins.

Les permissions qb-core servent aux commandes en jeu et au menu /admin. Le server.cfg généré par la recette contient les définitions ACE suivantes ; pour une installation manuelle, ajoutez-les vous-même :

add_ace group.admin command allow
add_ace resource.qb-core command allow
add_ace qbcore.god command allow
add_principal qbcore.god group.admin
add_principal qbcore.god qbcore.admin
add_principal qbcore.admin qbcore.mod

Grâce à l'espace réservé {{addPrincipalsMaster}} du modèle de la recette, txAdmin accorde des permissions à votre compte Master pendant l'installation ; selon la documentation de QBCore, le propriétaire du serveur obtient ainsi automatiquement le niveau de permission le plus élevé. Pour une installation manuelle, ou si vous vous connectez avec un autre compte, ajoutez-vous à la main : connectez-vous au jeu, ouvrez votre propre fiche sur la page Players de txAdmin et copiez votre identifiant Rockstar qui commence par license:. Ajoutez-le ensuite dans la section des permissions du fichier server.cfg :

add_principal identifier.license:XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX qbcore.god # Your name

Redémarrez le serveur ; le menu /admin s'ouvre désormais. Vous pouvez donner des permissions à d'autres joueurs en sélectionnant le joueur dans l'onglet Player Management du menu et en utilisant l'élément Permissions, ou avec la commande /addpermission [id] admin. Les groupes sont définis dans la ligne QBCore.Config.Server.Permissions = { 'god', 'admin', 'mod' } de qb-core/config.lua. Vous pouvez par exemple ajouter 'leo' à la liste et affecter des joueurs à ce groupe avec add_principal identifier.license:... qbcore.leo ; les commandes enregistrées avec ce groupe obtiennent automatiquement la permission ACE correspondante. Les détails se trouvent dans le guide des permissions de QBCore.

Tableau d'exemples de réglages

RéglageEmplacementExemple / valeur par défautDescription
sv_maxclientsserver.cfg48Nombre de slots ; qb-core lit ici sa valeur MaxPlayers. 32 ou plus nécessite OneSync.
sv_enforceGameBuildserver.cfg3095Le build de DLC écrit par la recette (The Chop Shop).
mysql_connection_stringserver.cfg (set)mysql://user:password@localhost:3306/qbcoreN'utilisez pas de caractères spéciaux dans le mot de passe.
mysql_slow_query_warningserver.cfg (set)150 (l'exemple de la documentation d'oxmysql)Seuil à partir duquel un avertissement sur les requêtes lentes s'affiche dans la console.
qb_localeserver.cfg (setr)enfr pour le français ; qb-core est fourni avec un fichier de langue française.
UseTargetserver.cfg (setr)falsetrue : interactions via qb-target.
QBCore.Config.Server.Whitelistqb-core/config.luafalsetrue : seuls les joueurs disposant de la permission WhitelistPermission (par défaut admin) peuvent rejoindre le serveur.
QBCore.Config.Server.PVPqb-core/config.luatrueIndique si les joueurs peuvent se tirer dessus et se blesser entre eux.
QBCore.Config.Money.MoneyTypesqb-core/config.luacash = 500, bank = 5000, crypto = 0Argent de départ d'un nouveau personnage.
QBCore.Config.DefaultSpawnqb-core/config.luavector4(-1035.71, -2731.87, 12.86, 0.0)Point d'apparition par défaut.

QBCore ou Qbox ? Un rapide tour d'horizon

Qbox est né d'un fork de QBCore et repose sur les ressources ox d'Overextended ; sa ressource centrale est qbx_core, et son code se trouve dans l'organisation Qbox-project sur GitHub. Selon sa documentation, il est compatible avec presque tous les scripts QBCore, à quelques exceptions près. Il s'installe de la même façon : dans txAdmin, Popular Recipes → QBox Framework. Les prérequis sont indiqués dans la documentation d'installation de Qbox.

SujetQBCoreQbox
Base de donnéesMariaDB recommandéMariaDB uniquement (au moins 10.9.0 ; 12.3 LTS recommandée pour les nouveaux serveurs) ; MySQL et XAMPP ne sont pas pris en charge
Bibliothèques de baseSes propres ressources, comme qb-menu, qb-input et qb-targetLes ressources ox d'Overextended
Compatibilité des scriptsL'écosystème qb-*Presque tous les scripts QBCore ; les exceptions figurent dans la FAQ de Qbox

Pour vous aider à choisir le framework, consultez aussi le comparatif ESX, QBCore ou Qbox.

Erreurs courantes

  • Erreur de connexion à la base de données dans la console (access denied / connection refused) : le nom d'utilisateur, le mot de passe ou le nom de la base est incorrect ; le service MariaDB ne tourne pas (sudo systemctl status mariadb) ; ou le mot de passe contient des caractères comme @, #, ;. Simplifiez le mot de passe ou passez à l'autre format de chaîne de connexion.
  • « Table 'qbcore.players' doesn't exist » : le SQL n'a pas été importé. Exécutez le fichier qbcore.sql complet du dépôt de la recette ; n'oubliez pas non plus le fichier .sql de chaque script que vous ajouterez plus tard.
  • Une ressource ne démarre pas et la console signale une dépendance manquante : une dépendance manque ou l'ordre des ensure est incorrect. Vérifiez la chaîne de l'étape 4 (qb-inventory → qb-weapons, qb-adminmenu → menuv, qb-target → PolyZone) ; si vous avez renommé un dossier, mettez aussi à jour sa ligne ensure.
  • Erreurs liées à yarn au premier lancement : le premier démarrage a peut-être été interrompu avant la fin de l'installation de yarn. Redémarrez le serveur depuis txAdmin et attendez que la console se stabilise.
  • « No license key was specified » ou aucune ressource ne démarre : dans une installation manuelle, le paramètre +exec server.cfg a été oublié ou la commande a été lancée en dehors du dossier server-data. La clé doit provenir de portal.cfx.re et figurer entre guillemets sur la ligne sv_licenseKey.
  • Le panel txAdmin est inaccessible : le port TCP 40120 est fermé dans le pare-feu. Sous Linux, ouvrez-le avec sudo ufw allow 40120/tcp (pour le jeu, 30120 en TCP et en UDP) ; sous Windows, ajoutez une règle de trafic entrant dans « Windows Defender Firewall with Advanced Security » (pare-feu Windows Defender avec fonctions avancées de sécurité). Vous pouvez changer le port avec la variable d'environnement TXHOST_TXA_PORT ; l'ancienne convar txAdminPort est obsolète et cessera de fonctionner à l'avenir.

Questions fréquentes

De combien de RAM et de CPU QBCore a-t-il besoin ?

Il ne serait pas juste de donner un chiffre unique ; le besoin dépend du nombre de joueurs et de scripts, et MariaDB tourne aussi sur le même serveur. À mesure que vous ajoutez des scripts, augmentez les ressources en surveillant les graphiques d'utilisation en temps réel du panneau de gestion de votre VDS et les valeurs resmon en jeu. Chez HanHosting, la gamme recommandée pour FiveM est le Ryzen 9 9950X.

Puis-je l'installer avec XAMPP ?

Ce n'est pas recommandé : la documentation d'oxmysql demande d'installer MariaDB directement plutôt que XAMPP, et Qbox ne prend pas en charge XAMPP. La condition « Apache et MySQL doivent être lancés » des anciens guides ne s'applique plus ; Apache n'est pas nécessaire.

Puis-je passer la langue du jeu en français ?

Oui. qb-core est fourni avec un fichier de langue française (locale/fr.lua) ; écrivez setr qb_locale "fr" dans server.cfg et redémarrez le serveur. Chaque ressource qb-* possède son propre dossier de langues ; les ressources sans fichier français restent en anglais. Vous pouvez ajouter les fichiers manquants en copiant le fichier anglais et en le traduisant.

Puis-je passer à Qbox plus tard ?

Oui ; la documentation de Qbox comporte une section « Converting from QBCore », et la plupart des scripts qb-* fonctionnent tels quels. Faites néanmoins la migration sur une copie de test avant de l'essayer sur votre serveur en production.

Guides associés

Pour d'autres guides FiveM, consultez la page Guides FiveM.

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.