Comment installer un serveur QBCore : recette txAdmin et étapes manuelles

Vous voulez un serveur QBCore et vous choisissez entre la recette et une installation manuelle. Ce guide couvre les deux, le server.cfg dont vous avez besoin, quoi vérifier lors de votre premier démarrage, et les erreurs qui apparaissent sur presque tous les premiers serveurs QBCore.

#Option 1 : la recette txAdmin

La recette est le moyen recommandé. Dans la configuration de txAdmin, choisissez le modèle QBCore parmi les recettes populaires, comme décrit dans configuration txAdmin et recettes. Vous entrez votre clé de licence et les détails de la base de données, txAdmin télécharge tout, crée la base de données et écrit server.cfg. Examinez ce fichier, démarrez le serveur, et passez aux premières vérifications ci-dessous.

#Option 2 : installation manuelle

Utilisez cela si vous avez déjà un serveur et voulez ajouter QBCore. Vous avez besoin d'FXServer, d'une base de données MySQL ou MariaDB et d'une clé de licence.

#1. Obtenez les resources

QBCore n'est pas une seule resource. Vous avez besoin de :

• qb-core, le framework lui-même.
• Les resources qb autour de lui : inventaire, multicaractère, sélecteur de spawn, emplois, téléphone et ainsi de suite. Elles sont généralement regroupées dans un dossier comme [qb].
• oxmysql pour la base de données et ox_lib, dont beaucoup de resources actuelles dépendent.
• Ressources autonomes comme une resource vocale (voir pma-voice not working) et tout pack de carte ou de véhicule.

Copiez-les dans votre dossier resources, par exemple resources/[qb] et resources/[standalone].

#2. Créez la base de données et importez le SQL

CREATE DATABASE qbcore CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Importez le fichier SQL qui vient avec l'installation de QBCore (le référentiel de recette expédie celui-ci avec les tables de base) et ensuite le SQL de chaque resource qui a son propre fichier. Si un script dit plus tard qu'une table manque, voir table SQL doesn't exist.

#3. Modifiez server.cfg

set mysql_connection_string "mysql://user:password@localhost/qbcore?charset=utf8mb4"

ensure oxmysql
ensure ox_lib
ensure qb-core
ensure [qb]
ensure [standalone]

add_ace group.admin command allow
add_ace qbcore.god command allow
add_principal group.admin qbcore.god
add_principal identifier.license:YOUR_LICENSE_HERE qbcore.god

Remplacez YOUR_LICENSE_HERE par votre propre identifiant de licence FiveM. Vous le trouvez dans la liste des joueurs de txAdmin ou dans la console serveur quand vous rejoignez. Les lignes ACE sont couvertes dans permissions ACE.

Conseil : ensure [qb] démarre chaque resource à l'intérieur de ce dossier. Gardez qb-core lui-même en dehors, comme dans l'exemple, sinon il est assuré deux fois. Voir ordre ensure server.cfg.

#Premières vérifications

Démarrez le serveur et lisez la console avant de rejoindre :

1. oxmysql se connecte à la base de données sans erreur.
2. qb-core démarre. Si ce n'est pas le cas, chaque autre resource qb échoue après.
3. Pas d'erreurs rouges des resources dans [qb]. Quelques avertissements sont normaux ; les erreurs répétées ne le sont pas.
4. Vous pouvez rejoindre, obtenir la sélection des personnages, créer un personnage et spawner.
5. Une ligne est créée dans la table players pour votre personnage.

Si vous ne pouvez pas rejoindre ou rester sur l'écran de chargement, lisez joueurs bloqués sur l'écran de chargement.

#Erreurs courantes de première fois

QBCore est nil. Un script qui utilise une ancienne méthode pour obtenir l'objet core échoue avec :

attempt to index a nil value (global 'QBCore')

Utilisez local QBCore = exports['qb-core']:GetCoreObject() au début de chaque fichier. L'explication complète est dans QBCore nil : la correction GetCoreObject.

qb-core n'a pas démarré. D'autres resources signalent alors :

No such export GetCoreObject in resource qb-core

Regardez le haut de la console pour la première erreur de qb-core lui-même, qui est généralement la base de données. Voir erreur de connexion oxmysql.

La resource ne démarre pas. Problèmes de dépendance manquante ou de nom de dossier : could not find dependency, couldn't start resource.

Vous n'êtes pas administrateur. Votre identifiant dans server.cfg ne correspond pas au vôtre, ou vous n'avez pas redémarré après l'avoir édité.

#Prochaines étapes

Quand la base est stable, les tâches initiales habituelles ajoutent des emplois et des articles. Voir travail d'ajout QBCore et qb-inventory ajouter des articles. Si vous prévoyez de lancer la stack plus récente plus tard, lisez d'abord installer QBox, car la stack diffère.

#Liste de contrôle