Serveur FiveM sur VPS Windows
DOG&DEV · 25/01/2025
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
- Aller sur runtime.fivem.net/artifacts/fivem/build_server_windows/master (ou la page officielle / txAdmin qui pointe vers les artifacts).
- Télécharger le dernier build recommandé (lien server Windows, archive .zip).
- Extraire dans un dossier dédié, ex.
C:\FXServer\.
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
- Sauvegardes :
server.cfg,resources/, base MySQL. - Mises à jour : Artifacts, txAdmin, ressources (ESX, oxmysql, etc.).
- Liens : fivem-sql, fivem-mapping, esx-qbcore-setup, ace-fivem, enable-onesync ; windows-firewall.
Ressources
Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.