Pour commencer la configuration, tu dois déjà avoir téléchargé sur ton PC une base de serveur prête à l’emploi depuis Internet et avoir extrait son archive.
Le contenu d’une base de serveur peut varier selon le type de serveur et les éléments qu’elle contient. Les fichiers peuvent donc être différents. En règle générale, ta base de serveur doit toutefois contenir les éléments suivants :
- Configuration du serveur -
server.cfg (obligatoire) : le fichier de configuration du serveur contient toutes les commandes et tous les paramètres importants pour ton serveur.
- Dossier des ressources -
resource (obligatoire) : le dossier des ressources contient toutes les ressources prêtes à l’emploi utilisées dans la base de serveur.
- Fichier SQL -
filenameXY.sql (facultatif) : ce fichier contient la structure de base de données prête à l’emploi, nécessaire pour utiliser les ressources et les faire communiquer avec la base de données (si elle est utilisée).
Les données (server.cfg, resources) de la base de serveur que tu as téléchargée doivent être téléversées sur ton serveur de jeu. Le fichier SQL doit être importé dans la base de données ZAP que nous mettons à ta disposition.
Le téléversement des données de ta base de serveur s’effectue via FTP. Si tu ne sais pas encore exactement comment procéder, consulte notre guide : Accès FTP
Connecte-toi à ton serveur de jeu via FTP et accède au dossier fivem. Crée-y un dossier pour ta base de serveur s’il n’existe pas encore. Dans cet exemple, la base de serveur prête à l’emploi s’appelle ExampleServer.
Une fois le dossier créé, téléverse les données de la base de serveur. Pour cela, accède au dossier que tu viens de créer et téléverse le dossier des ressources ainsi que ta configuration du serveur. Le résultat devrait ressembler à ceci :
Si ta base de serveur nécessite également une base de données, tu dois importer le fichier SQL fourni dans ta base de données ZAP. Si tu ne sais pas encore exactement comment procéder, consulte notre guide : Importer un fichier SQL
Importe ton fichier SQL dans ta base de données comme indiqué dans le guide. Avant cela, vérifie que tu as adapté le contenu du fichier SQL et indiqué le nom correct de ta base de données ZAP. Pour cela, remplace la valeur d’origine dans la commande Use '...' par le nom de ta base de données ZAP.
Vérifie attentivement le contenu du fichier SQL avant de l’importer
Assure-toi que le contenu du fichier SQL a été adapté et qu’il est entièrement correct avant de l’importer. Sinon, le message d’erreur suivant s’affichera :
Access denied for user ‘zapXXXXX-X’@’%’ to database ’originalDatabaseName’
La préparation de la configuration du serveur est maintenant terminée. La suite de la configuration, l’installation et le paramétrage du serveur s’effectuent via le processus de configuration de l’interface txAdmin. Le guide suivant t’explique en détail comment accéder à txAdmin et comment se déroule la configuration : Configuration de txAdmin
Définis le nom que tu souhaites utiliser pour ton projet. Ce nom n’est pas destiné à la liste des serveurs ; il sert uniquement dans l’interface txAdmin et pour les messages de chat et Discord. Passe à l’étape Deployment Type.
Dans Deployment Type, tu dois maintenant choisir comment configurer ton serveur. Tu as le choix entre Popular Recipes, Existing Server Data, Remote URL Template et Custom Template. Pour ton cas, sélectionne Existing Server Data.
Tu dois ensuite indiquer le chemin vers ta base de serveur. Le chemin à saisir dépend de l’emplacement où ton serveur fonctionne :
- Serveur de jeu ZapX : le dossier principal que tu vois via FTP/SFTP se trouve dans le serveur sous
/data. Si tu as, par exemple, téléversé ta base de serveur dans le dossier ExampleServer du dossier principal, le chemin est /data/ExampleServer et la configuration du serveur se trouve sous /data/ExampleServer/server.cfg. Si server.cfg et resources se trouvent directement dans le dossier principal, saisis /data.
- Classic-Panel (serveur de jeu Docker) : le dossier
fivem visible via FTP est monté sur le serveur sous /home/server. Le chemin est donc /home/server/ExampleServer (ou /home/server/<Ordnername>), et non le chemin FTP précédé de g<ID>/fivem.
Reprends les noms de dossiers à l’identique
Remplace ExampleServer par le nom du dossier de ta base de serveur. Respecte exactement les majuscules et les minuscules.
Clique sur Next. Le fichier de configuration du serveur server.cfg devrait maintenant être détecté. Confirme-le, puis termine la configuration habituelle avec le bouton Save & Start.
Il est très probable que le serveur ne puisse pas démarrer, car certaines informations nécessaires ne sont pas correctes. Cela peut notamment être dû à une adresse IP et à un port incorrects, à l’absence d’informations de base de données nécessaires pour établir une connexion, ou à une clé de licence manquante. Tu dois donc apporter quelques dernières modifications à la configuration du serveur pour terminer la configuration.
Par défaut, l’adresse IP et le port sont absents ou incorrects. Vérifie que les entrées des points de terminaison figurent bien dans le fichier de configuration de ton serveur et qu’elles sont correctes. La syntaxe est la suivante :
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"
Remplace l’adresse IP (0.0.0.0) et le port (30120) par les données de ton serveur. Tu les trouveras dans la gestion de ton serveur de jeu.
Adresse IP/port incorrects
Si les informations que tu as configurées sont incorrectes, le message d’erreur suivant te le signalera :
Line XX: [ZAP-Hosting] the 'endpoint_add_tcp' interface MUST be 'XXX.XXX.XXX.XXX'
Line XX: [ZAP-Hosting] the 'endpoint_add_udp' interface MUST be 'XXX.XXX.XXX.XXX'
Pour que ton serveur puisse se connecter à la base de données, tu dois renseigner une chaîne de connexion MySQL contenant les informations de la base de données dans le fichier de configuration du serveur server.cfg. Par défaut, elle se présente ainsi :
set mysql_connection_string "mysql://username:password@dataBaseHostname/databaseName?charset=utf8mb4"
La présence d’une chaîne de connexion MySQL dans la configuration de ton serveur dépend de la base de serveur utilisée. Si elle n’existe pas encore ou ne contient pas les informations nécessaires sur la base de données, tu dois l’ajouter et la modifier. Tu trouveras les informations de la base de données dans la gestion de ton serveur de jeu, sous Bases de données. Le résultat pourrait, par exemple, ressembler à ceci :
set mysql_connection_string "mysql://zapXXXXXXX-X:yourDatabasePassword@mysql-mariadb-XX-XXX.zap-hosting.com/zapXXXXXX-X?charset=utf8mb4"
Fais simple
Si tu souhaites éviter cette étape, tu peux aussi cliquer sur le bouton Reconfigurer la chaîne de connexion MySQL tout en bas de la section Configuration, dans la gestion de ton serveur de jeu.
Si le fichier server.cfg de ta base de serveur contient des informations sur Onesync, supprime-les. Onesync se gère plutôt dans les paramètres de l’interface txAdmin. Pour l’activer, accède à Settings ⟶ FXServer.
Pour faire fonctionner ton serveur, tu as besoin de ta propre clé de licence CFX. Le guide suivant t’explique comment en créer une : Ta propre clé de licence
Ajoute la clé de licence au fichier de configuration du serveur :
sv_licenseKey "deinLizenzschluesselHier"