Installer un serveur FiveM

Cette page vous emmène d’un serveur FiveM tout juste livré jusqu’à votre première connexion en jeu. Elle s’adresse à vous si vous venez de commander une offre FiveM chez CloudFive et que votre serveur n’a encore jamais démarré.

Comptez une trentaine de minutes la première fois : l’essentiel du temps part dans le téléchargement des fichiers et dans la relecture du server.cfg.

Ce qu’il faut avoir sous la main

• Un service FiveM actif. Il a été livré avec ses accès au panel de jeu. Si vous n’en êtes pas encore là, voir Commander un service.
• Vos accès à panel.cloudfive.xyz. Le panel est l’interface de pilotage de tous les serveurs de jeu CloudFive : Découvrir le panel.
• Une clé serveur Cfx.re. Sans elle, le serveur démarre mais refuse les joueurs. Créez-la d’abord : Obtenir et configurer sa clé Cfx.re.
• Un client FiveM installé sur votre PC, avec une copie légitime de GTA V.

Note

La procédure est identique pour un serveur RedM : seuls les artifacts et les ressources changent. Voir Mettre en place un serveur RedM.

Créer le serveur et choisir la version des artifacts

Les artifacts sont le moteur du serveur : le programme fourni par Cfx.re qui exécute vos ressources. Vous n’avez pas à les télécharger vous-même, le panel s’en charge, mais vous choisissez quelle version il récupère.

1. Connectez-vous à panel.cloudfive.xyz avec les identifiants reçus par email.

2. Ouvrez votre serveur FiveM dans la liste des serveurs.

3. Allez dans l’onglet qui regroupe les variables de démarrage du serveur. C’est là que se règlent la version des artifacts et les options passées au moteur.

4. Choisissez la version : gardez la valeur recommandée par défaut. Elle correspond à une build stable, celle que la grande majorité des ressources attendent.

5. Enregistrez, puis démarrez le serveur une première fois. Les fichiers se téléchargent pendant ce démarrage ; suivez la progression dans la console.

Attention

Changer de version d’artifacts déclenche un nouveau téléchargement au démarrage suivant, et peut casser des ressources. Notez le numéro de la build qui fonctionne avant d’en essayer une autre : vous pourrez revenir en arrière.

Ne courez pas après la dernière build

Une build très récente apporte surtout des changements internes. Les scripts publics, eux, sont testés sur les builds stables. Montez de version quand une ressource l’exige, pas par principe.

Choisir un framework de base

Un serveur FiveM nu ne contient aucun gameplay : ni argent, ni métiers, ni inventaire. C’est le rôle du framework, la couche sur laquelle vos scripts viennent se greffer. Le choix se fait maintenant, parce qu’en changer plus tard revient à recommencer.

Base	Ce que vous obtenez	Pour qui
Serveur vierge	Les ressources d’exemple de Cfx.re, rien de plus	Un projet développé de zéro, ou un serveur de test
ESX (es_extended)	Économie, métiers, inventaire, très gros catalogue de scripts	Un serveur RP classique, beaucoup de ressources trouvables
QBCore	Même principe qu’ESX, base de code plus récente	Un serveur RP monté à partir de zéro aujourd’hui

Trois règles qui évitent des semaines de dépannage :

• Un seul framework à la fois. ESX et QBCore ne cohabitent pas. Un script écrit pour l’un ne fonctionne pas sur l’autre sans adaptation.
• Un framework a besoin d’une base de données MySQL. Prévoyez-la tout de suite : Connecter la base de données (oxmysql).
• Le plus simple est de laisser txAdmin déployer la base. L’interface txAdmin, incluse avec les offres FiveM, sait installer ESX ou QBCore complets en une opération : Prendre en main txAdmin.

Configurer le server.cfg minimal

Le server.cfg est le fichier de configuration lu à chaque démarrage. Il se trouve à la racine des fichiers de votre serveur, que vous pouvez éditer depuis le gestionnaire de fichiers ou en SFTP.

• server.cfg
• Répertoireresources/

  • Répertoire[core]/

    • Répertoirees_extended/

      • …
    • Répertoireoxmysql/

      • …
  • Répertoire[local]/ vos ressources personnalisées

    • …
• Répertoirecache/

  • …

Voici le squelette qui suffit à démarrer. Ajoutez vos ressources ensuite, une par une.

server.cfg

# --- Réseau -------------------------------------------------
# Le port doit correspondre à l'allocation de votre serveur.
endpoint_add_tcp "0.0.0.0:30120"
endpoint_add_udp "0.0.0.0:30120"

# --- Identité du serveur ------------------------------------
sv_hostname "Mon serveur RP"
sv_projectName "Mon projet"
sv_projectDesc "Serveur francophone"
sets locale "fr-FR"
sv_maxclients 16
load_server_icon icon.png

# --- Ressources ---------------------------------------------
ensure mapmanager
ensure chat
ensure spawnmanager
ensure sessionmanager
ensure hardcap

# --- Administration -----------------------------------------
add_ace group.admin command allow
add_principal identifier.fivem:VOTRE_ID group.admin

# --- Clé serveur Cfx.re -------------------------------------
sv_licenseKey "VOTRE_CLE_CFX"

Trois points à vérifier avant d’enregistrer :

• Le port. Le panel attribue à votre serveur une allocation précise. Reprenez ce port exact dans les deux lignes endpoint_add_* ; 30120 n’est qu’une valeur par défaut. Voir Ports et allocations.
• sv_maxclients. Ne dépassez pas ce que votre palier annonce, sinon vous vendez des places que la machine ne peut pas tenir.
• L’ordre des ensure. Une ressource doit être démarrée après ses dépendances. oxmysql avant le framework, le framework avant les scripts qui s’en servent.

Palier FiveM	Prix	Joueurs annoncés	RAM
Starter	2,50 €/mois	~16	4 Go DDR5
Essentiel	6,50 €/mois	~32	8 Go DDR5
Avantage	11,50 €/mois	~64	16 Go DDR5
Performant	18,50 €/mois	~96	24 Go DDR5

Pour choisir, ou pour monter d’un cran : Combien de RAM pour un serveur FiveM ? et Changer de formule.

Attention

Le server.cfg contient votre clé Cfx.re. Ne le publiez jamais sur un dépôt Git public, et ne partagez pas de capture de la console sans masquer la clé.

Premier démarrage et vérification de la console

1. Démarrez le serveur depuis le panel, puis restez sur la console.

2. Attendez la fin du téléchargement des artifacts. Le premier démarrage est toujours le plus long.

3. Cherchez la ligne qui annonce que le serveur écoute sur son port, puis celle qui confirme son enregistrement auprès de Cfx.re.

4. Lisez les lignes en jaune et en rouge. Une ressource introuvable ou un script en erreur apparaît ici, avec son nom.

5. Dans la console, tapez status et validez. Le serveur doit répondre avec son nom et le nombre de joueurs connectés.

Un serveur sain, au repos, n’écrit presque rien dans la console. Si les messages défilent sans fin après le démarrage, une ressource boucle sur une erreur : coupez-la pour le vérifier.

Se connecter à son serveur en jeu

Connexion directe

Lancez FiveM, ouvrez la console du client avec la touche F8, puis tapez connect 203.0.113.10:30120 en remplaçant l’adresse et le port par les vôtres. C’est la méthode la plus fiable pour tester : elle ne dépend pas de la liste publique.

Liste des serveurs

Cherchez le nom défini par sv_hostname dans la liste des serveurs de FiveM. L’apparition dans cette liste dépend de l’enregistrement auprès de Cfx.re : comptez quelques minutes après le démarrage.

Favoris

Ajoutez l’adresse en favori dans le client FiveM. Pratique pour vos joueurs, et indispensable si vous gardez le serveur hors de la liste publique pendant le développement.

L’adresse IP et le port de votre serveur figurent sur sa fiche dans le panel. Pour donner à vos joueurs une adresse lisible du type jeu.exemple.fr, voir Utiliser un nom de domaine personnalisé.

Si ça ne marche pas

Le serveur démarre puis s’arrête tout seul. Dans neuf cas sur dix, c’est la clé Cfx.re : absente, mal recopiée, ou utilisée en même temps par un autre serveur. Reprenez Obtenir et configurer sa clé Cfx.re.

La console annonce une ressource introuvable. Le nom du dossier dans resources/ doit correspondre exactement au nom écrit après ensure, majuscules comprises. Vérifiez aussi qu’aucun dossier intermédiaire ne s’est glissé à l’extraction : resources/mon-script/mon-script/fxmanifest.lua ne sera pas vu.

Les joueurs ne se connectent pas, alors que la console est propre. Le port du server.cfg ne correspond pas à votre allocation. Comparez les deux, corrigez le fichier, redémarrez. Voir Ports et allocations.

L’écran de chargement tourne à l’infini. Le serveur accepte la connexion mais une ressource ne rend jamais la main : presque toujours la base de données. Vérifiez la chaîne de connexion dans Connecter la base de données (oxmysql).

Le serveur n’apparaît pas dans la liste publique. Laissez-lui quelques minutes. S’il reste invisible alors que la connexion directe fonctionne, c’est l’enregistrement auprès de Cfx.re qui échoue — la section « Erreurs fréquentes » de la page clé Cfx.re traite ce cas.

Ça tourne, mais ça saccade. Avant d’acheter de la RAM, mesurez : Optimiser les performances de son serveur FiveM.

Si le blocage persiste, ouvrez un ticket de support en joignant les dernières lignes de la console : c’est ce qui fait gagner le plus de temps.