Optimiser un serveur FiveM : lire resmon et augmenter les FPS
Resmon (resource monitor) est l'outil intégré de FiveM : il indique combien de millisecondes chaque ressource consomme par image sur l'ordinateur du joueur. Dans ce guide, vous apprendrez à lire le tableau de resmon, à trouver avec le profiler le script qui fait chuter les FPS, et à comprendre comment OneSync, la base de données et le matériel influencent les saccades (hitches) du serveur ; une checklist d'optimisation vous attend à la fin.
Avant de commencer
- Un FXServer fonctionnel et un accès à la console : la fenêtre du serveur sous Windows, le terminal ouvert avec
run.shsous Linux, ou la console en direct de txAdmin. Pour l'installation, consultez le guide d'installation de FXServer. - Un client FiveM à jour et un artifact serveur à jour (le paquet serveur compilé) ; le profiler exige les deux.
- Google Chrome pour afficher les enregistrements du profiler.
- Un accès administrateur à MariaDB/MySQL (HeidiSQL ou ligne de commande) pour l'étape consacrée à la base de données.
- Faites vos mesures pendant que des joueurs sont connectés ; la plupart des scripts problématiques ne se révèlent qu'en charge.
1. Ouvrez resmon et lisez correctement le tableau
En jeu, ouvrez la console avec F8 et tapez la commande suivante (pour la fermer, utilisez resmon false) :
resmon true
Dans la fenêtre « Resource Monitor » qui s'ouvre, chaque ligne correspond à une ressource ; vous pouvez trier en cliquant sur l'en-tête d'une colonne (pour la liste des commandes, voir les commandes de la console client). Voici comment lire les colonnes :
| Colonne | Signification | Comment l'interpréter |
|---|---|---|
Resource | Le nom de la ressource | Identique au nom inscrit sur la ligne ensure du fichier server.cfg. |
CPU msec | Temps moyen que la ressource consomme par tick | Vert sous 1 ms, il passe au jaune entre 1 et 8 ms et au rouge à partir de 8 ms. Un script isolé qui reste en permanence au-dessus de 1 ms est anormal. |
Time % | Part de cette ressource dans le temps total des scripts | Si une ressource occupe la moitié du total, examinez-la en premier. |
CPU (inclusive) | Inclut le temps passé dans les autres ressources que la ressource appelle | Augmente pour les scripts qui appellent d'autres ressources via des exports. |
Memory | Mémoire utilisée par l'environnement d'exécution des scripts de la ressource | Si elle ne cesse d'augmenter au fil des heures, il peut s'agir d'une fuite de mémoire. |
Streaming | Taille en mémoire des fichiers stream chargés par la ressource | Augmente avec les packs de véhicules et de MLO ; les textures occupent la mémoire de la carte graphique. |
La ligne [Total CPU] en haut indique le temps total des scripts et sa part dans le temps d'une image. À 60 FPS, une image dure environ 16,7 ms ; chaque milliseconde consommée par les scripts est prise sur ce budget. Si une ressource dépasse en moyenne 6 ms, FiveM affiche sur l'écran du joueur l'avertissement « X is taking Y ms (or -Z FPS @ 60 Hz) » ; les joueurs qui voient cet avertissement peuvent vous transmettre le nom de la ressource.
2. Trouvez le script en cause : boucles Wait(0) et profiler
Ouvrez les fichiers client de la ressource qui arrive en tête de resmon. L'erreur la plus courante est une boucle infinie qui s'exécute à chaque image sans contrôle de distance. Wait(0) (identique à Citizen.Wait(0)) ne met le thread en pause que jusqu'au tick de jeu suivant ; à 60 FPS, la boucle s'exécute 60 fois par seconde, et encore plus souvent pour un joueur qui a plus de FPS. Si la boucle commence par un Wait(0) fixe, la distance est calculée à chaque image, même lorsque le joueur se trouve à l'autre bout de la map. La version corrigée :
-- Runs once per second when far away, every frame when close
CreateThread(function()
while true do
local sleep = 1000
local coords = GetEntityCoords(PlayerPedId())
if #(coords - vector3(215.0, -810.0, 30.0)) < 50.0 then
sleep = 0
-- draw the marker, check for the key press
end
Wait(sleep)
end
end)
Cette seule modification peut faire passer un script de 0,10 ms à 0,01 ms.
Pour les saccades que vous ne trouvez pas en lisant le code, utilisez le profiler (guide officiel du profiler). Dans la console F8 :
profiler record 500
profiler status
profiler view
record 500 enregistre cinq cents images, status vous indique l'état de l'enregistrement et view ouvre l'enregistrement dans Chrome. Les pics du graphique jaune du temps CPU, en haut, correspondent aux chutes de FPS ; zoomez sur cette zone de la chronologie avec la molette de la souris. En survolant un événement, vous voyez sa durée en ms, le nom du fichier et le numéro de ligne.
3. Mesurez côté serveur : avertissements de hitch et txAdmin
Même si les FPS côté client sont bons, les joueurs voient des téléportations et des inventaires lents quand le serveur sature. La ligne server thread hitch warning: timer interval of ... milliseconds dans la console du serveur signifie qu'un passage du thread principal du serveur a duré plus de 150 ms ; les variantes network thread et sync thread du même avertissement concernent les threads réseau et de synchronisation OneSync.
Le profiler fonctionne aussi sur le serveur : tapez profiler record 500 puis profiler view dans la console du serveur ; le serveur n'ouvre pas de navigateur, collez donc dans Chrome le lien qu'il vous donne. Pour conserver l'enregistrement, tapez profiler saveJSON recording.json ; le fichier est créé dans le dossier depuis lequel vous avez lancé le serveur et s'ouvre dans Chrome DevTools → onglet Performance, via clic droit → « Load profile ». Cherchez les pics de CPU qui dépassent nettement les images normales.
Le graphique de performance des threads de txAdmin affiche les performances du serveur à côté du nombre de joueurs ; si les temps augmentent avec le nombre de joueurs, optimisez le côté serveur (voir le guide txAdmin). Sous Linux, pour voir les threads de FXServer un par un (remplacez PID par l'identifiant du processus) :
top -H -p PID
Un seul thread bloqué à 100 % signale un goulot d'étranglement, même si les autres cœurs sont inactifs. Sous Windows, surveillez la ligne FXServer.exe dans le Gestionnaire des tâches ; les graphiques d'utilisation en direct de l'Espace client HanHosting affichent aussi l'utilisation du CPU, de la RAM, du disque et du réseau.
4. Réglez correctement OneSync et le nombre de joueurs
OneSync est le système de synchronisation qui conserve l'état des entités sur le serveur et laisse le serveur décider quelle entité est envoyée à quel joueur. Sur une installation vanilla, il s'active avec la ligne set onesync on dans server.cfg ; dans txAdmin, avec l'option OneSync des réglages (par défaut on). Les réglages qui influencent les performances :
| Réglage | Valeurs | Effet sur les performances |
|---|---|---|
onesync | on, legacy, off | on offre une connaissance complète de l'état et un routage des entités décidé par le serveur. legacy est un mode de compatibilité pour les anciens scripts qui s'attendent à ce que chaque joueur soit présent sur chaque client. |
sv_maxclients | 1–2048 | À partir de 32, OneSync est obligatoire (on ou legacy) ; au-delà de 64, seul on convient. OneSync est gratuit jusqu'à 48 slots ; au-delà, il faut un palier payant sur le portail Cfx.re (portal.cfx.re). |
onesync_population | true (par défaut) / false | Si vous le réglez sur false, aucun PNJ ni trafic n'est généré ; la charge baisse, mais la ville se vide. |
onesync_distanceCullVehicles | true / false (par défaut false) | Applique aussi aux véhicules le filtrage par distance et visibilité ; peut améliorer les performances en réduisant la fréquence de synchronisation des véhicules. |
sv_entityLockdown | inactive (par défaut), relaxed, strict | Restreint la création d'entités par le client et bloque les avalanches de véhicules et d'objets provoquées par la triche. relaxed bloque les entités créées par les scripts client, strict les bloque toutes ; les scripts qui créent des véhicules côté client cessent de fonctionner. |
Selon la documentation officielle de OneSync, la zone de focus correspond aux 424 unités autour du joueur ; les entités situées au-delà ne sont pas créées sur ce client. Les natives qui modifient ce rayon, comme SET_PLAYER_CULLING_RADIUS, sont obsolètes ; évitez les scripts qui en dépendent. Autres réglages : commandes serveur officielles.
5. Mesurez la base de données et la charge des requêtes
Dans les frameworks comme ESX et QBCore, les opérations d'inventaire, d'argent et de véhicules passent par la base de données ; les requêtes lentes se traduisent par des saccades pour le joueur. Si vous utilisez oxmysql, définissez la chaîne de connexion et le seuil des requêtes lentes avec set avant les ressources :
set mysql_connection_string "mysql://user:password@localhost:3306/fivem"
set mysql_slow_query_warning 150
ensure oxmysql
Chaque requête qui dépasse le seuil (en ms ; 200 par défaut) est affichée dans la console avec le nom de la ressource qui l'a appelée, sa durée et le texte de la requête. Pour voir toutes les requêtes avec le nom des ressources, ajoutez temporairement set mysql_debug true ; retirez-le une fois terminé, car le journal grossit vite.
Côté MariaDB, activez le journal des requêtes lentes. Le fichier de configuration est généralement /etc/my.cnf ou /etc/mysql/my.cnf sous Linux, et le fichier data\my.ini du dossier d'installation de MariaDB sous Windows. Ajoutez les lignes suivantes à la section [mariadb] et redémarrez le service :
[mariadb]
slow_query_log
slow_query_log_file=slow-queries.log
long_query_time=0.5
log_queries_not_using_indexes=ON
long_query_time s'exprime en secondes ; sa valeur par défaut est 10. SET GLOBAL slow_query_log=1; active le journal sans redémarrage, jusqu'au prochain redémarrage. Examinez avec EXPLAIN une requête qui revient souvent dans le journal : ALL dans la colonne type signifie un parcours complet de la table, et NULL dans la colonne key signifie qu'aucun index n'est utilisé. La solution consiste à ajouter un index sur la colonne de la clause WHERE :
EXPLAIN SELECT * FROM owned_vehicles WHERE owner = 'abc123';
CREATE INDEX owner_idx ON owned_vehicles (owner);
Consultez la charge actuelle avec SHOW FULL PROCESSLIST; ; la colonne Time indique depuis combien de secondes une requête attend. Pour HeidiSQL, consultez le guide de la base de données FiveM.
6. Matériel : pourquoi la vitesse monocœur est décisive
Le code Lua/JS côté serveur et les événements sont traités dans l'ordre sur le thread principal du serveur ; le réseau et la synchronisation OneSync ont leurs propres threads. Comme chaque thread s'exécute sur un seul cœur à la fois, c'est la vitesse par cœur, et non le nombre de cœurs, qui détermine les performances : beaucoup de cœurs lents ne compensent pas quelques cœurs rapides.
Vérifiez votre processeur. Linux :
lscpu
Windows PowerShell :
Get-CimInstance -ClassName Win32_Processor | Select-Object Name, MaxClockSpeed, NumberOfCores, NumberOfLogicalProcessors
MaxClockSpeed s'exprime en MHz. Chez HanHosting, la famille recommandée pour FiveM est le VDS AMD Ryzen 9 9950X : il offre de hautes performances monocœur et utilise de la mémoire DDR5 et des disques NVMe ; les options vont de 2 à 16 CPU et de 2 à 64 Go de RAM. Pour les offres, consultez la page Location de serveur FiveM.
FXServer, MariaDB et le système d'exploitation se partagent la même mémoire ; si la mémoire se remplit et que le système bascule sur le swap, les temps de tick s'envolent. Si la RAM est constamment à sa limite, passez à une offre supérieure ou déplacez la base de données sur un serveur séparé.
7. Contenu côté serveur qui influence les FPS client
- Taille des textures : au démarrage d'une ressource, le serveur affiche dans la console l'avertissement
Asset resource/file.ytd uses ... MiB of physical memory.pour chaque fichier stream de plus de 16 Mio ; au-delà de 48 Mio, un avertissement sur des problèmes de streaming s'y ajoute. Réduisez ces textures en 2K ou en 1K : le client ramène déjà les textures de véhicules qui contiennent des mipmaps à la résolution par défaut de 1024 pixels avecstr_maxVehicleTextureRes; une texture 4K n'est pas plus nette mais est quand même téléchargée. Consultez le guide d'ajout de véhicules moddés. - Dossier stream : supprimez les packs de véhicules, de vêtements et de MLO inutilisés. La colonne
Streamingde resmon affiche la mémoire de streaming par ressource, et la commandestrmem truedans F8 l'affiche par fichier. - MLO et YMAP : des intérieurs qui se chevauchent peuvent faire chuter les FPS dans certaines zones ; si vous le soupçonnez, arrêtez temporairement la ressource avec
stopet mesurez à nouveau la zone. - Mesure côté client : demandez aux joueurs de taper
cl_drawperf truedans F8 ; les FPS, le ping, la perte de paquets, l'utilisation du CPU et du GPU et la température du GPU s'affichent dans un coin de l'écran. Si le GPU est saturé, examinez la charge des textures et des modèles ; si c'est le CPU, examinez la charge des scripts.
Exemple de bloc de performances pour server.cfg
# Player count and sync
set onesync on
sv_maxclients 48
onesync_distanceCullVehicles true
# Stop other clients from taking over occupied vehicles
sv_filterRequestControl 1
# Enable if no script spawns vehicles on the client; test first
# sv_entityLockdown relaxed
# Database (BEFORE the resources)
set mysql_connection_string "mysql://user:password@localhost:3306/fivem"
set mysql_slow_query_warning 150
ensure oxmysql
sv_filterRequestControl est désactivé par défaut (0) ; 1 empêche les autres clients de prendre le contrôle des véhicules utilisés par des joueurs. Les valeurs 2 à 4 sont plus strictes mais peuvent casser certains scripts.
Checklist d'optimisation étape par étape
- Ouvrez resmon aux heures de pointe ; notez les trois ressources qui ont les valeurs
CPU msecles plus élevées. - Ajoutez des contrôles de distance ou d'état aux boucles
Wait(0)de ces ressources ; si nécessaire, trouvez la ligne en cause avec le profiler. - Retirez de
server.cfgles ressources inutilisées. - En cas d'avertissements de hitch, faites un enregistrement du profiler côté serveur.
- Activez les avertissements de requêtes lentes ; ajoutez des index aux requêtes qui parcourent des tables entières.
- Vérifiez que
onesync onest bien défini ; testez les réglages d'entités sur un serveur de test. - Réduisez les textures qui déclenchent des avertissements de taille et faites le ménage dans les dossiers stream.
- Augmentez progressivement le nombre de joueurs ; si un seul cœur sature, passez à un matériel plus puissant.
Erreurs fréquentes
- Le total de resmon est bas mais les FPS aussi : le problème ne vient pas des scripts mais de la charge des textures et du stream ; regardez la colonne
Streaminget l'utilisation du GPU. - « hitch warning » en continu dans la console du serveur : une boucle lourde ou une opération de fichier synchrone côté serveur bloque le thread principal ; faites un enregistrement du profiler côté serveur.
- Problèmes après avoir dépassé 48 slots : OneSync est gratuit jusqu'à 48 slots ; au-delà, il vous faut un palier payant sur le portail Cfx.re, et au-delà de 64, il faut aussi
onesync on. - La colonne Memory augmente sans cesse au fil des heures : le script accumule des tables qu'il ne libère jamais (fuite de mémoire). Mettez la ressource à jour ; en attendant, programmez des redémarrages réguliers.
Questions fréquentes
Les valeurs de resmon sont-elles celles du serveur ou du joueur ?
Celles du joueur. Resmon fonctionne côté client et mesure par rapport au processeur de cet ordinateur. Pour le côté serveur, utilisez les avertissements de hitch de la console, un enregistrement du profiler serveur et le graphique des threads de txAdmin.
Désactiver OneSync améliore-t-il les performances ?
Non. À partir de 32 slots, OneSync est de toute façon obligatoire. En mode on, le serveur n'envoie pas au client les entités situées hors de la zone de focus, ce qui limite le nombre d'entités que chaque joueur doit traiter.
Plus de cœurs rendent-ils le serveur plus rapide ?
Seulement dans une certaine mesure. Comme le code des scripts s'exécute sur un seul thread principal, c'est la vitesse par cœur qui compte ; les cœurs supplémentaires ne font qu'alléger les tâches annexes.
Quelle valeur totale de resmon viser ?
Il n'existe pas de limite officielle. En pratique, sur un serveur RP fréquenté, un total d'environ 2 ms est bon, et au-delà de 5 ms la perte de FPS devient sensible.
Guides associés
- Installer FXServer : un serveur FiveM de zéro (Windows et Linux)
- Utiliser txAdmin : guide de gestion d'un serveur FiveM
- Comment installer la base de données FiveM : MariaDB et HeidiSQL au lieu de XAMPP
- Comment ajouter des véhicules add-on à un serveur FiveM (fxmanifest et stream)
- Utilisation élevée du CPU et de la RAM sur les serveurs VDS HanHosting : causes et solutions
Pour d'autres guides FiveM, parcourez la catégorie des guides FiveM.
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.