Comment installer QBCore sur mon serveur FiveM avec txAdmin ?

QBCore est le framework roleplay le plus populaire pour FiveM, mais l'installer à la main — des dizaines de resources, une base de données et un server.cfg fonctionnel — est un travail propice aux erreurs. Bonne nouvelle : txAdmin propose une recipe prête à l'emploi qui met en place le framework complet en quelques minutes. Dans ce guide, vous allez d'abord créer une base de données dans le panel, puis déployer la recipe QBCore via l'assistant de configuration de txAdmin, et enfin vous connecter à votre propre ville en tant qu'admin.

QBCore ou Qbox ? Qbox (qbx_core) est une évolution moderne de QBCore, avec un développement actif, de meilleures performances et une sécurité renforcée. La liste de recipes de txAdmin contient les deux frameworks et les étapes ci-dessous sont identiques pour l'un comme pour l'autre ; si vous préférez Qbox, sélectionnez simplement cette recipe à l'étape 3. Vous partez de zéro et n'avez encore acheté aucun script spécifique à QBCore ? Alors Qbox mérite d'être envisagé.

Étape 1 : créez une base de données dans le panel

1. Connectez-vous au panel MC-Node et ouvrez votre serveur FiveM.
2. Allez dans l'onglet Databases et cliquez sur New Database. Si vous ne voyez pas le bouton ou si vous avez atteint votre limite, consultez Comment créer et gérer une base de données ?
3. Donnez à la base de données un nom reconnaissable, par exemple qbcore, puis confirmez.
4. Ouvrez les détails de la nouvelle base de données et notez quatre informations : l'endpoint (l'hôte, avec le numéro de port qui le suit), le nom de la base de données, le nom d'utilisateur et le mot de passe (visible via l'icône en forme d'œil).

Attention : l'hôte est une adresse de base de données dédiée, pas localhost. Si vous saisissez malgré tout localhost ou 127.0.0.1 plus tard, votre serveur ne pourra jamais joindre la base de données. Plus de détails dans Comment me connecter à ma base de données ?

Étape 2 : ouvrez txAdmin

1. Vérifiez que txAdmin est activé sur votre serveur. Si ce n'est pas encore le cas, suivez d'abord Comment activer txAdmin ?
2. Démarrez votre serveur depuis l'onglet Console.
3. La sortie de la console affiche l'adresse txAdmin accompagnée d'un code PIN à quatre chiffres. Ce PIN n'est valable que quelques minutes ; s'il a expiré, redémarrez votre serveur pour en obtenir un nouveau.
4. Ouvrez l'adresse (http://ip-serveur:port-txadmin) dans votre navigateur, connectez-vous avec votre compte Cfx.re et saisissez le PIN. Cette liaison n'est nécessaire que la première fois : votre compte devient ensuite le compte master de ce txAdmin.

Étape 3 : déployez la recipe QBCore via l'assistant de configuration

1. Comme aucun serveur n'est encore configuré, txAdmin ouvre automatiquement l'assistant de configuration. Donnez un nom à votre serveur.
2. Pour le type d'installation, choisissez Popular Recipes et sélectionnez QBCore Framework (ou Qbox).
3. Renseignez votre license key Cfx.re. Vous pouvez en créer une gratuitement sur portal.cfx.re ; le fonctionnement exact est expliqué dans J'ai acheté un serveur FiveM, et maintenant ?
4. Dans les champs de base de données, saisissez exactement les informations de l'étape 1 : hôte (avec le numéro de port), nom d'utilisateur, mot de passe et nom de la base de données.
5. Lancez le déploiement. txAdmin télécharge alors toutes les resources QBCore, importe les tables SQL dans votre base de données et génère un server.cfg. Cela prend généralement quelques minutes.
6. Vérifiez ensuite le server.cfg généré (les valeurs par défaut conviennent très bien pour commencer) et cliquez sur Save & Run Server.

Étape 4 : premier démarrage, devenir admin et entrer en ville

1. Suivez le premier démarrage dans la console txAdmin et attendez que toutes les resources soient chargées et qu'aucune erreur rouge ne défile plus.
2. Ouvrez le client FiveM, appuyez sur F8 et tapez connect ip:port avec l'adresse de votre serveur (vous la retrouverez dans le panel).
3. Vous arrivez dans le menu des personnages : créez votre premier personnage et choisissez un lieu de départ ou un appartement.
4. Devenir admin : ouvrez la page Live Console dans txAdmin et tapez setgroup 1 god, en remplaçant 1 par votre ID serveur (visible sur la page Players de txAdmin). Avec le groupe god, vous ouvrez le menu admin en ville, par défaut via /admin.

Problèmes fréquents

• Connection refused ou Access denied (oxmysql) — les informations de base de données sont incorrectes. La recipe les écrit sur la ligne set mysql_connection_string du server.cfg ; ouvrez ce fichier via l'onglet Files et vérifiez l'hôte avec son numéro de port, le nom d'utilisateur (préfixe éventuel compris), le mot de passe et le nom de la base de données. N'utilisez jamais localhost. Redémarrez ensuite votre serveur.
• Recipe exécutée par-dessus une installation existante — le deployer attend un environnement vierge. Si vous lancez l'assistant par-dessus une installation antérieure, vous vous retrouvez avec des resources en conflit et des tables de base de données en double. Faites d'abord une sauvegarde via l'onglet Backups, supprimez ensuite les anciens fichiers du serveur (ou faites réinstaller votre serveur) et utilisez une base de données vide ou neuve.
• License key manquante ou déjà utilisée — sans key valide, FiveM ne démarre pas, et une même key ne peut tourner que sur un seul serveur actif à la fois. Créez une nouvelle key sur Keymaster et mettez-la à jour via l'onglet Startup ; les détails sont dans Comment changer ma license key FiveM ?
• La page txAdmin ne se charge pas — vérifiez que le port txAdmin est bien configuré et que votre serveur tourne réellement ; les étapes figurent dans l'article txAdmin de l'étape 2.

Besoin d'aide ?

Félicitations, votre ville est en ligne ! À partir d'ici, vous pouvez ajouter des resources, configurer des jobs et continuer à aménager votre serveur. Vous bloquez malgré tout quelque part, par exemple sur un déploiement qui s'arrête en cours de route ? Ouvrez un ticket via notre page de support en indiquant le nom de votre serveur et le message d'erreur de la console txAdmin — nous y jetterons un œil avec vous.