Configurer votre serveur FiveM : clé de licence, server.cfg et ressources

Un serveur FiveM a besoin de trois choses pour fonctionner : une clé de licence Cfx.re gratuite, un server.cfg fonctionnel et vos ressources (scripts, cartes et frameworks). Ce guide vous aide à configurer les trois correctement afin que votre serveur démarre et apparaisse dans la liste des serveurs.

1. Générer une clé de licence Cfx.re

Chaque serveur FiveM a besoin d'une clé de licence de keymaster de Cfx.re — c'est gratuit.

1. Allez sur keymaster.fivem.net et connectez-vous avec votre compte Cfx.re (Forum).
2. Cliquez sur New server key / Register.
3. Pour l'adresse IP, vous pouvez enregistrer une clé sur l'adresse IP de votre serveur ou générer une clé non listée (ce qui convient à la plupart des configurations). Remarque : une clé est liée à la façon dont vous l'enregistrez, donc si vous changez de serveur, vous pourriez avoir besoin d'une nouvelle clé.
4. Copiez la clé — elle ressemble à une longue chaîne aléatoire.

2. Ajouter la clé à server.cfg

1. Ouvrez votre serveur et cliquez sur File Manager.

2. Ouvrez server.cfg à la racine.

3. Trouvez la ligne sv_licenseKey (ou ajoutez-en une) et collez votre clé :

   sv_licenseKey your_key_here
   

4. Enregistrez et redémarrez depuis l'onglet Console.

Sans clé valide, la console affichera Invalid license key et le serveur ne se connectera pas.

3. Comprendre server.cfg

server.cfg est le cœur de votre serveur. Les lignes que vous toucherez le plus :

endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

sv_hostname "My ServerPrism FiveM Server"
sv_maxclients 32
sets locale "en-US"

# Load resources
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure my-custom-resource

sv_licenseKey your_key_here

• sv_hostname — le nom de votre serveur dans le navigateur de serveurs FiveM.
• sv_maxclients — le nombre de slots de joueurs (jusqu'à 48 sur les builds par défaut).
• ensure <name> — démarre une ressource au démarrage. C'est ainsi que vous activez les scripts.

Ne changez pas le port de l'endpoint sauf si vous connaissez votre allocation. Le port de jeu de FiveM est défini par votre allocation ServerPrism — le 30120 par défaut est correct pour la plupart des serveurs. Vérifiez l'onglet Startup/Network si vous n'êtes pas sûr.

4. Ajouter des ressources

Les ressources (scripts, cartes, frameworks comme ESX ou QBCore) vont dans le dossier resources/.

1. Téléchargez le dossier de ressources dans resources/ via le File Manager ou SFTP (SFTP est préférable pour les grands frameworks — voir Gestionnaire de fichiers et SFTP).
2. Ajoutez une ligne ensure <resource-name> à server.cfg pour chaque ressource que vous souhaitez exécuter.
3. Redémarrez. Surveillez la console — chaque ressource affiche Started resource <name> lorsqu'elle se charge.

Pour un framework de roleplay complet, installez ses ressources de base dans l'ordre spécifié par sa documentation (généralement une base de données + le framework de base en premier, puis les scripts dépendants).

Bases de données (ESX/QBCore)

Les frameworks de roleplay nécessitent une base de données MySQL. Créez-en une dans l'onglet Databases et pointez la configuration du framework (généralement via mysql_connection_string dans server.cfg ou un fichier de configuration du framework) vers les identifiants. Voir Créer et se connecter à une base de données MySQL.

Particularité de la base de données sur le même nœud : si votre base de données et votre serveur FiveM sont sur le même nœud et que le framework ne peut pas se connecter via l'adresse IP publique, ouvrez un ticket de support — c'est un cas de réseau connu que nous pouvons résoudre rapidement en reliant les conteneurs.

Problèmes courants

• Invalid license key : la clé est incorrecte, expirée ou enregistrée sur une adresse IP différente — régénérez-la dans keymaster.
• Le serveur n'apparaît pas dans le navigateur : il est toujours en cours de démarrage, sv_hostname n'est pas défini, ou une ressource génère une erreur — lisez la console pour la première error.
• Une ressource ne démarre pas : vérifiez la console pour la première ligne d'erreur sous cette ressource ; il s'agit généralement d'une dépendance manquante ou d'une base de données inaccessible.
• Erreurs ghmattimysql/oxmysql : la chaîne de connexion à la base de données est incorrecte — copiez les identifiants à nouveau depuis l'onglet Databases.

Toujours bloqué ?

Ouvrez un ticket de support avec la première ligne error de votre console et la ressource qu'elle mentionne. Nous pouvons examiner la configuration directement sur le nœud.