$ USD
FiveM server.cfg Full Guide – Complete Configuration
Le serveur.cfg Le fichier est au cœur de chaque serveur FiveM. Il définit le fonctionnement de votre serveur : emplacements, réseau, création de jeu, OneSync, journalisation et visibilité dans la liste des serveurs. Ce guide est destiné aux propriétaires et développeurs de serveurs qui recherchent des paramètres par défaut sûrs, un renforcement de la production et des pratiques optimales en matière de performances. Conservez toujours des sauvegardes et utilisez le contrôle de version. Si vous débutez, commencez par notre Comment créer un serveur FiveMPour des optimisations plus approfondies, consultez notre Centre de performance.
Sur cette page
TL;DR : Ligne de base prête pour la production (annotée)
Un nettoyage serveur.cfg est le fondement de la stabilité. Voici deux exemples : un minimum configuration de développement et un configuration de production renforcée.
Configuration de développement minimale
# server.cfg (développement) # Configuration de base pour les tests locaux # Réseau endpoint_add_tcp "0.0.0.0:30120" # Liaison de port TCP endpoint_add_udp "0.0.0.0:30120" # Liaison de port UDP # Informations sur le serveur sv_hostname "Mon serveur de développement" sv_maxclients 8 # OneSync définir onesync sur # Ressources (exemple de base) ensure mapmanager ensure chat ensure spawnmanager ensure sessionmanager ensure hardcap ensure baseevents # Autorisations (ACL par défaut) exec permissions.cfg
Configuration de production renforcée
# server.cfg (production) # Réseau endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" # Sécurité sv_endpointPrivacy true # Masquer l'IP dans la liste des serveurs sv_scriptHook 0 # Désactiver les mods client rcon_password "StrongRconPassword123" # Désactiver si non nécessaire # Emplacements sv_maxclients 64 # Ajuster à la capacité de l'hôte # Version du jeu (utiliser la dernière version recommandée) sv_enforceGameBuild 2944 # Ou alias : "mp2024_02" # Informations sur le projet sv_hostname "FIVEMX Roleplay | Serious RP" définit sv_projectName "Serveur RP FIVEMX" définit sv_projectDesc "RP réaliste avec QBCore et scripts personnalisés" définit les balises "roleplay, seriousrp, qbcore" définit les paramètres régionaux "en-US" load_server_icon mylogo.png définit banner_detail "https://cdn.example.com/banner.png" définit banner_connecting "https://cdn.example.com/loading.png" # OneSync définit onesync sur # Ressources (utiliser la liste des ressources) exec resources.cfg # Journalisation et ACL définit sv_logLevel 2 exec permissions.cfg # txAdmin intégration définit mysql_connection_string "mysql://user:pass@localhost/fivemdb"
Conseil: Validez toujours votre configuration après modification avec les contrôles d'intégrité et les journaux de la console txAdmin. Voir journaux txAdmin.
Informations et liste du serveur
Les variables suivantes contrôlent la façon dont votre serveur apparaît dans le navigateur de serveur et API :
| Convar | But | Exemple | Quand changer | Mises en garde |
|---|---|---|---|---|
sv_nom_hôte | Nom public dans la liste des serveurs | sv_hostname « Mon serveur RP [EN] » | Toujours régler | Évitez les caractères spéciaux, restez clair |
définit sv_projectName | Nom d'affichage du projet interne | définit sv_projectName "MyCommunityRP" | Image de marque, configurations multi-serveurs | Visible uniquement dans l'interface utilisateur de la liste |
ensembles sv_projectDesc | Description affichée dans la liste | définit sv_projectDesc « Serveur QBCore RP » | Ajouter des règles, une langue, des fonctionnalités | Gardez < 100 caractères |
définit des balises | Balises de la liste des serveurs | définit les balises « jeu de rôle, voitures, qbcore » | Améliorer la découvrabilité | Utilisez uniquement les tags officiels |
définit les paramètres régionaux | Langue par défaut | définit les paramètres régionaux « en-US » | Langue du serveur de match | Des paramètres régionaux incorrects peuvent masquer le serveur |
sv_endpointConfidentialité | Masquer l'adresse IP publique dans le navigateur | sv_endpointPrivacy vrai | Recommandé pour la production | Les joueurs se connectent via le relais Cfx |
icône_de_chargement_serveur | Icône PNG 96×96 | load_server_icon monlogo.png | Pour le branding | Doit être carré, <96×96 pixels |
définit banner_detail | Grande bannière dans la liste des serveurs | définit banner_detail "url" | Facultatif mais recommandé | Doit être une URL HTTPS |
définit banner_connecting | Bannière affichée lors de la connexion | définit banner_connecting "url" | Idéal pour le marquage/chargement | Utilisez CDN pour éviter les décalages |
Voir la [liste officielle des convars][1] pour une référence complète.
Réseautage et créneaux horaires
Utilisation des serveurs FiveM Points de terminaison TCP/UDP. Par défaut, le port 30120 est utilisé.
endpoint_add_tcp "0.0.0.0:30120" endpoint_add_udp "0.0.0.0:30120" sv_maxclients 64
- Exécutez plusieurs serveurs sur une seule machine avec décalages de port: par exemple
30121,30122. - Associez les règles de pare-feu pour ouvrir les ports TCP/UDP.
sv_maxclientsaffecte directement l'utilisation du processeur et de la RAM — ne définissez pas une valeur plus élevée que ce que votre matériel peut gérer. Voir les fournisseurs d'hébergement de serveurs
Avertissement: N'exposez pas les ports MySQL ou RCON à Internet.
Construction du jeu et artefacts
Chaque build de serveur (artefact) correspond à une build de jeu GTA V. Toujours épingler une version spécifique pour éviter des changements inattendus.
Exemple # forçant la build 2944 (mise à jour Los Santos Drug Wars) sv_enforceGameBuild 2944 # ou utilisez l'alias enforce_game_build mp2024_02
- [Documentation officielle des convars][1] répertorie les numéros de build valides.
- Ensemble intégré
serveur.cfgou dans txAdmin → Paramètres → FXServer → Arguments supplémentaires:
+set sv_enforceGameBuild 2944
- Télécharger la dernière version artefacts depuis [runtime.fivem.net][4] (Windows) ou la page de build Linux.
- Ne mélangez jamais les versions client et serveur.
Configuration de OneSync
OneSync permet synchronisation des entités côté serveur: plus de joueurs, des états précis, un meilleur streaming. Utilisez toujours OneSync activé pour les frameworks modernes (QBCore, ESX).
| Paramètre | Effet | Valeur typique | Impact sur le processeur/la mémoire | Documents |
OneSync | Active OneSync | sur | Utilisation accrue du processeur | [Documentation OneSync][3] |
onesync_population | Contrôle les PNJ/le trafic locaux | sur (facultatif) | Ajoute de la charge CPU | [Documentation OneSync][3] |
onesync_distanceCullVehicles | Flux de véhicules efficace | vrai | Meilleures performances, économie de bande passante | [Documentation OneSync][3] |
Conseil: Échelle
sv_maxclientsavec du matériel. Utiliser Guide Resmon pour mesurer l’impact des ressources.
Ordre de démarrage des ressources et dépendances
Les ressources se chargent dans l'ordre défini par assurerCommencez toujours par les dépendances.
# resources.cfg (fichier divisé) ensure oxmysql ensure qb-core ensure qb-adminmenu ensure qb-inventory ensure qb-policejob ensure my-custom-scripts
Dans serveur.cfg:
ressources exécutives.cfg
- Gardez les frameworks et les connecteurs de base de données en premier.
- Ressources liées au groupe.
- Éviter
assurer *en production ; cela provoque un ordre non déterministe.
Renforcement de la sécurité et des abus
Un sécurisé serveur.cfg prévient les fuites et les abus.
Liste de contrôle:
sv_endpointPrivacy vraisv_scriptHook 0(bloquer les mods clients)- Fort ou handicapé
mot de passe rcon - Utiliser
ajouter_principaletajouter_acepour les ACL - Masquer les clés API dans
.env, pas dansserveur.cfg - Mettre à jour régulièrement les artefacts
- Moniteur journaux txAdmin
- Utiliser Guide Resmon pour attraper des scripts lourds
Exemple d'ACL :
La commande add_ace group.admin autorise add_principal identifier.steam:110000112345678 group.admin
CDN et streaming d'actifs (quand les utiliser)
Pour les grands MLO, les voitures personnalisées et les textures, utilisez un CDN pour réduire rejoindre les heures.
- Héberger des fichiers sur un CDN comme Cloudflare R2 (définir [en-têtes CORS][6]).
- Pour des performances élevées, BunnyCDN prend en charge les [requêtes de plage][7] (nécessaires pour
.rpfstreaming). - Ajoutez des URL versionnées pour éviter les conflits de cache.
Voir notre Optimiser les temps de chargement guide.
Mythes et drapeaux déconseillés
De nombreuses configurations en ligne s'affichent toujours Cvars du moteur source comme:
sv_maxrate 0 sv_minrate 30000 sv_maxupdaterate 60
Ne pas utiliser. Ces variables ne sont pas prises en charge par FiveM et n'ont aucun effet. Voir [convars officielles][1].
Convars obsolètes/héritées :
sv_master1→ n'est plus nécessaire.sv_useDirectListing→ remplacé parsv_endpointConfidentialité.
Validation et dépannage
Vérifications clés après l'édition serveur.cfg:
| Symptôme | Cause probable | Réparer | Temps |
| Le serveur ne démarre pas | Erreur de syntaxe dans la configuration | Vérifiez la console, supprimez les lignes invalides | 5 m |
| Pas dans la liste des serveurs | Manquant sv_nom_hôte/tags | Ajoutez le nom d'hôte/les balises, vérifiez le pare-feu, sv_master1 | 10 m |
| Les joueurs ne peuvent pas se connecter | Ports fermés / IP incorrecte | Ouvrir 30120 TCP+UDP, vérifier point_de_terminaison_* | 15 m |
| Utilisation élevée du processeur | Trop d'emplacements / mauvais scripts | Inférieur sv_maxclients, utiliser Réglage des performances | 20 m |
| Temps de chargement longs | De gros actifs non optimisés | Utiliser Optimiser les temps de chargement + CDN | 20 m |
| Plantages après la mise à jour | Inadéquation de construction | Épingle sv_enforceGameBuild, mise à jour [artefacts][4] | 15 m |
Ressources internes et prochaines étapes
FAQ
1. Qu'est-ce que serveur.cfg dans FiveM ?
Il s'agit du fichier de configuration principal qui définit le nom du serveur, les emplacements, les ressources, la mise en réseau, la sécurité et la visibilité.
2. Où dois-je placer serveur.cfg?
Dans le dossier racine de votre serveur (à côté de serveur.exe ou Serveur FX point d'entrée). txAdmin le charge automatiquement.
3. Quelle est la différence entre ensemble, ensembles, et setr?
ensemble: variable réservée au serveur.ensembles: apparaît dans la liste des serveurs (informations publiques).setr: synchronisé avec les clients.
4. Mon serveur n'apparaît pas dans la liste. Pourquoi ?
Vérifier sv_nom_hôte, définit des balises, définit les paramètres régionaux, et sv_endpointConfidentialitéAssurez-vous également que vos ports sont ouverts.
5. Comment puis-je augmenter le nombre d'emplacements de joueurs ?
Changement sv_maxclients. Évoluez progressivement et surveillez avec Guide ResmonAssurez-vous que votre matériel et votre réseau peuvent le gérer.
6. Qu'est-ce que sv_enforceGameBuild?
Une variable de configuration qui force les clients à utiliser une version spécifique de GTA V. Elle prévient les plantages dus à des versions incompatibles. Voir [Documentation sur les variables de configuration][1].
7. Dois-je utiliser des numéros de build ou des alias ?
Les deux fonctionnent. Numérique (2944) est explicite ; alias (mp2024_02) est plus facile à suivre. Les deux sont pris en charge.
8. Où dois-je régler sv_enforceGameBuild dans txAdmin ?
Dans txAdmin → Paramètres → FXServer → Arguments supplémentaires. Exemple : +set sv_enforceGameBuild 2944.
9. Qu'est-ce que OneSync ?
Un système permettant d'accueillir davantage de joueurs, de diffuser des entités avec précision et d'obtenir une autorité de serveur. Nécessaire pour les frameworks modernes. Voir [Documentation OneSync][3].
10. Infinity ou Legacy OneSync ?
Legacy = jusqu'à 64 emplacements. Infinity = prend en charge 128 emplacements et plus, synchronisation avancée des entités. À utiliser systématiquement. OneSync activé (Infini par défaut).
11. Comment organiser les ressources ?
Utiliser ressources exécutives.cfg. Démarrez d'abord les connecteurs de base de données, puis les frameworks, puis les tâches/scripts. Évitez assurer *.
12. Mes bannières n'apparaissent pas dans la liste des serveurs.
Assurez-vous que les URL sont HTTPS, publiques et pointent vers des images de taille correcte. Utilisez un CDN pour plus de fiabilité.
13. À quoi servent les journaux txAdmin ?
Ils affichent des erreurs, des plantages et des problèmes de ressources. Voir journaux txAdmin.
14. Comment puis-je vérifier les problèmes de performances ?
Utiliser résmon 1 dans la console. Voir notre Guide Resmon pour plus de détails.
15. Les indicateurs de taux du moteur source sont-ils nécessaires ?
Non. sv_maxrate, sv_minrate, sv_maxupdaterate Ne faites rien dans FiveM. Utilisez plutôt [Convars doc][1].
Crédits :
