doganddev
Accueil Blog Boutique

Serveur FiveM sur VPS Windows

DOG&DEV · 25/01/2025

Web Hosting Backups Windows
Serveur FiveM sur VPS Windows

Serveur FiveM sur VPS Windows

Ce guide décrit l’installation d’un serveur FiveM sur un VPS Windows : téléchargement des Artifacts, configuration de server.cfg, ajout des ressources, utilisation de txAdmin ou du démarrage manuel, et ouverture du port 30120 (pare-feu).

Prérequis

  • VPS Windows (Server 2016/2019/2022 ou 10/11) — 4 Go RAM minimum, 8 Go recommandé pour ESX/QBCore
  • Accès RDP et droits administrateur
  • Connexion Internet

1. Télécharger les Artifacts FiveM

Structure type après extraction :

C:\FXServer\
  FXServer.exe
  run.cmd / run.bat
  ...

2. Premier lancement et server.cfg

  • Lancer run.cmd (ou FXServer.exe selon le build). Au premier run, un assistant peut demander :

    • Clé de licence (CFX.re / Keymaster) : obligatoire pour un serveur public.
    • Créez un server.cfg : oui.
  • Si vous créez server.cfg à la main, créer le fichier server.cfg à la racine du serveur (à côté de FXServer.exe). Exemple minimal :

# Nom du serveur
sv_hostname "Mon serveur FiveM"

# Connexions
sv_maxclients 32

# Licence (Keymaster)
sv_licenseKey "cfxk_xxxxxxxx"

# OneSync (recommandé pour ESX/QBCore, script avancés)
set onesync on

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

# Votre BDD (oxmysql) et framework
set mysql_connection_string "mysql://user:pass@localhost/db?charset=utf8mb4"
ensure oxmysql
ensure es_extended
# ensure qb-core  # si QBCore

# Autres ressources
# ensure mon-script
  • sv_licenseKey : à obtenir sur keymaster.fivem.net. Sans clé valide, le serveur ne sera pas listé et les connexions seront limitées.

3. Ressources et dossiers

  • resources/ : y placer les dossiers des ressources (es_extended, oxmysql, jobs, mappings, etc.).
  • server.cfg : ensure nom_ressource pour chaque ressource à charger, dans le bon ordre (oxmysql → framework → bases → scripts → mappings).

Voir fivem-sql, fivem-mapping, esx-qbcore-setup, enable-onesync.

4. txAdmin (optionnel)

txAdmin est un panneau web pour gérer le serveur : démarrage/arrêt, console, joueurs, sauvegardes, mises à jour.

  • Télécharger txAdmin depuis github.com/tabarra/txAdmin (release Windows).
  • Lancer txAdmin.exe : l’assistant demande le chemin du serveur (C:\FXServer), les artifacts, la licence, et génère ou utilise un server.cfg.
  • Accès au panel : http://IP:40120 (ou le port indiqué). Pin et mot de passe à définir à la première configuration.

Avec txAdmin, le démarrage se fait depuis le panel ; run.cmd peut ne plus être utilisé directement.

5. Port 30120 et pare-feu

  • 30120 (UDP et TCP) : port par défaut de FiveM. À ouvrir dans le pare-feu Windows et chez l’hébergeur :

PowerShell (admin) :

New-NetFirewallRule -DisplayName "FiveM" -Direction Inbound -Protocol UDP -LocalPort 30120 -Action Allow -Profile Any
New-NetFirewallRule -DisplayName "FiveM TCP" -Direction Inbound -Protocol TCP -LocalPort 30120 -Action Allow -Profile Any
  • Si vous changez le port dans server.cfg (endpoint_add_tcp "0.0.0.0:30121" etc.), adapter les règles et l’ouverture chez l’hébergeur.

6. Démarrage manuel (sans txAdmin)

  • run.cmd ou FXServer.exe avec les paramètres adéquats. Un run.cmd type :
cd /d C:\FXServer
FXServer.exe +exec server.cfg

Pour un service Windows ou une tâche planifiée, créer une tâche qui lance run.cmd au démarrage (ou utiliser txAdmin qui gère les redémarrages).

Dépannage

Symptôme Cause possible Correctif
« No license » / serveur non listé Clé absente, expirée ou invalide Obtenir/mettre à jour la clé sur keymaster.fivem.net ; sv_licenseKey dans server.cfg
Joueurs ne peuvent pas se connecter Port 30120 fermé (pare-feu, hébergeur) Ouvrir 30120 UDP/TCP ; Test-NetConnection ou site de test de port
Crash au démarrage Ressource défectueuse, BDD inaccessible Désactiver les ensure un par un ; vérifier fivem-sql (MySQL, oxmysql)
« OneSync » / désync onesync non activé pour un framework enable-onesync : set onesync on

Bonnes pratiques

Ressources


Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.

Commentaires (0)

Laisser un commentaire