Augmenter la RAM d’un serveur Project Zomboid (-Xmx)

Un serveur Project Zomboid qui crashe avec un OutOfMemoryError alors que la machine a de la RAM libre, c’est le symptôme classique : le serveur tourne sur Java, et Java ne prend que ce que -Xmx l’autorise à prendre. Ajouter de la RAM à la machine ne sert à rien tant que ce paramètre n’a pas bougé. Voici où le modifier, avec quelle valeur, et les deux pièges à éviter.

Sur un serveur Project Zomboid chez HebergTonServ, les 16 Go de l’offre sont déjà alloués à la JVM — aucun -Xmx à toucher.

Comprendre -Xmx en une minute

Le serveur remplit progressivement son tas mémoire (heap). Quand il atteint la limite -Xmx, il ne ralentit pas : il s’arrête, avec un java.lang.OutOfMemoryError dans les logs. C’est pourquoi un serveur avec 32 Go de RAM système peut crasher si -Xmx est resté à 4 Go.

Le piège n°1 : le bon fichier

C’est l’erreur la plus fréquente, et elle fait perdre des heures.

Modifier ProjectZomboid64.json en pensant régler le serveur dédié ne change rien au serveur. Pour un serveur dédié, c’est le script de démarrage qu’il faut éditer.

Étape 1 — Arrêter le serveur

Comme toujours sur PZ, via la console :

save
quit

N’éditez jamais les fichiers serveur allumé.

Étape 2 — Modifier la valeur

Windows — StartServer64.bat

Ouvrez le fichier et repérez la ligne qui appelle java.exe. Elle contient un paramètre -Xmx :

-Xmx4g

Remplacez par la valeur souhaitée, par exemple pour 12 Go :

-Xmx12g

Les suffixes acceptés sont g (gigaoctets) et m (mégaoctets). -Xmx12g et -Xmx12288m sont équivalents. Pas d’espace entre -Xmx et la valeur.

Linux — start-server.sh

Même logique : repérez le -Xmx dans la commande de lancement Java et ajustez-le.

Sur un hébergement géré

La RAM est celle de l’offre, allouée automatiquement au démarrage. Il n’y a généralement rien à éditer — si votre serveur manque de mémoire, c’est l’offre qu’il faut changer, pas un fichier.

Étape 3 — Choisir la bonne valeur

Deux règles se combinent.

Règle 1 — le besoin réel. En Build 42, comptez environ 6 Go de base + 500 Mo par joueur, plus 2 Go pour un pack de mods modéré et 4 Go et plus pour un gros pack. Détail : Combien de RAM pour un serveur Project Zomboid ?

Règle 2 — ne jamais tout donner. N’allouez pas plus d’environ 75 % de la RAM système, et laissez au minimum 4 Go au système d’exploitation.

Ne mettez pas -Xmx au maximum « au cas où ». Une JVM avec un tas surdimensionné met plus de temps à faire ses passes de garbage collection, ce qui se traduit par des micro-freezes visibles en jeu. Dimensionnez au besoin réel, avec une marge de 20 à 30 %.

Étape 4 — Redémarrer et vérifier

Relancez et attendez SERVER STARTED. Puis contrôlez sur une session de jeu réelle :

1. La consommation mémoire se stabilise-t-elle sous la limite, ou colle-t-elle au plafond ?
2. Le message OutOfMemoryError a-t-il disparu des logs ?
3. Le serveur tient-il plusieurs heures avec l’équipe complète connectée ?

Si la mémoire reste collée au plafond en permanence, le besoin réel est au-dessus de ce que vous avez alloué.

Quand augmenter -Xmx ne suffit pas

Monter -Xmx répare un crash mémoire. Ça ne répare pas :

Project Zomboid est CPU-bound : au-delà du dimensionnement mémoire correct, c’est la fréquence du processeur qui détermine la fluidité. Voir : Réduire le lag sur un serveur Project Zomboid

FAQ

Où augmenter la RAM d’un serveur Project Zomboid dédié ?

Dans le paramètre -Xmx du script de démarrage : StartServer64.bat sous Windows, start-server.sh sous Linux. Pas dans ProjectZomboid64.json, qui ne concerne que le client Steam.

Quelle valeur de -Xmx pour un serveur Build 42 ?

Au minimum -Xmx6g, Build 42 ayant besoin d’environ 6 Go rien que pour s’initialiser. Ajoutez 500 Mo par joueur et la marge pour vos mods, sans dépasser 75 % de la RAM de la machine.

Pourquoi mon serveur crashe-t-il alors qu’il reste de la RAM libre ?

Parce que la JVM est plafonnée par -Xmx, indépendamment de la RAM système disponible. Tant que ce paramètre n’est pas relevé, le serveur crashera au même seuil, même sur une machine à 64 Go.

Faut-il régler -Xms aussi ?

Ce n’est pas indispensable. Aligner -Xms sur -Xmx réserve toute la mémoire dès le démarrage et lisse un peu le comportement de la JVM, au prix d’une empreinte fixe. Sur un serveur dédié à PZ uniquement, c’est une option raisonnable.

Allouer trop de RAM peut-il poser problème ?

Oui, deux fois. Côté système, priver l’OS de mémoire provoque du swap et des ralentissements généralisés. Côté Java, un tas surdimensionné allonge les cycles de garbage collection, ce qui crée des micro-freezes. Restez sous 75 % de la RAM totale.

Sur un hébergement géré, faut-il modifier -Xmx ?

Non, la RAM de l’offre est allouée automatiquement au démarrage du serveur. Si vous manquez de mémoire, c’est un changement d’offre qu’il faut envisager, pas une édition de fichier.

Conclusion

Augmenter la RAM d’un serveur Project Zomboid revient à relever -Xmx dans le script de démarrage du serveur, jamais dans ProjectZomboid64.json. Visez le besoin réel — 6 Go de base en Build 42, plus 500 Mo par joueur, plus vos mods — sans dépasser 75 % de la RAM machine. Et rappelez-vous que la RAM règle les crashs, pas le lag : ça, c’est le CPU.

Pour un hébergeur Project Zomboid avec 16 Go de RAM déjà alloués, Ryzen 9 5950X pour la partie CPU-bound et sauvegardes automatiques, HebergTonServ démarre à 25,90 €/mois.

Pour aller plus loin

• Combien de RAM pour un serveur Project Zomboid ?
• Mon serveur Project Zomboid ne démarre pas / crash
• Réduire le lag sur un serveur Project Zomboid
• Redémarrages automatiques sur un serveur Project Zomboid
• Hébergeur Project Zomboid dès 25,90€/mois