Le fichier server.properties de Minecraft expliqué

server.properties est le fichier de réglages principal d'un serveur Java Edition. Il se trouve dans le dossier du serveur, est créé au premier démarrage, et contrôle le port, le monde, la difficulté, la sécurité et les performances. Ce guide explique les clés qui comptent, avec des valeurs raisonnables et ce qui se passe mal quand tu les modifies.

Comment fonctionne le fichier

• Chaque ligne est de la forme clé=valeur, sans espace autour du signe égal.
• Arrête le serveur avant de modifier le fichier. La plupart des changements ne s'appliquent qu'après un redémarrage, et le serveur peut écraser le fichier en s'arrêtant.
• Les lignes qui commencent par # sont des commentaires.
• Si tu supprimes le fichier, le serveur en crée un nouveau avec les valeurs par défaut au prochain démarrage.
• Paper, Spigot et Purpur lisent aussi ce fichier, et ajoutent leurs propres réglages dans d'autres fichiers comme spigot.yml et le dossier de config de Paper.

Les valeurs ci-dessous concernent Java 1.20 et 1.21. Depuis la 1.21.9, pvp, allow-nether, spawn-monsters et enable-command-block ne sont plus des propriétés du serveur : ce sont devenues des règles de jeu, que tu modifies en jeu avec /gamerule. Sur les versions plus anciennes, elles sont toujours dans ce fichier.

Réglages de connexion

server-port : si tu le changes, les joueurs doivent ajouter le port à l'adresse (play.example.com:25570), sauf si tu configures un enregistrement SRV. Il faut aussi rediriger le nouveau port. Vois IP et port d'un serveur Minecraft.

max-players : le mettre très haut ne rend le serveur ni plus rapide ni plus populaire. Mets un nombre que ton matériel peut vraiment gérer, pour que le serveur refuse des joueurs au lieu de laguer pour tout le monde.

motd : accepte les codes couleur écrits sous la forme \u00A7 suivi d'un code, par exemple \u00A7a pour le vert, et \n pour la deuxième ligne. L'écrire à la main est fastidieux ; notre générateur de MOTD construit la ligne pour toi.

enable-status : si tu le mets à false, le serveur apparaît hors ligne dans la liste Multijoueur et sur les listes de serveurs, même si les joueurs peuvent toujours le rejoindre. Laisse-le activé pour un serveur public.

network-compression-threshold : laisse-le à 256 pour la plupart des serveurs. -1 désactive la compression, ce qui n'a de sens que si le serveur et les joueurs (ou un proxy) sont sur le même réseau local rapide. Des valeurs très basses consomment plus de CPU sans vrai bénéfice.

Réglages du monde

• level-name (par défaut world) : le nom du dossier du monde. Change-le pour charger un autre dossier de monde.
• level-seed : la seed d'un nouveau monde. Elle n'a aucun effet sur un monde qui existe déjà.
• level-type (par défaut minecraft:normal) : les autres valeurs sont minecraft:flat, minecraft:large_biomes, minecraft:amplified et minecraft:single_biome_surface. Comme la seed, elle ne s'applique qu'à la création du monde. Les mondes amplifiés sont beaucoup plus lourds pour le CPU.
• generator-settings : du JSON pour les mondes plats personnalisés. Laisse vide sauf si tu sais que tu en as besoin.
• generate-structures (par défaut true) : villages, temples et autres structures.
• max-world-size : le rayon de la bordure du monde, en blocs. Pour un serveur public, une bordure plus petite avec un monde prégénéré garde l'espace disque et le lag sous contrôle.
• allow-nether (1.21.8 et avant) : désactive le Nether quand il vaut false. Sur les serveurs basés sur Bukkit, l'End est contrôlé par allow-end dans bukkit.yml.

Pour démarrer un nouveau monde avec une nouvelle seed ou un nouveau type, arrête le serveur, change la valeur, et renomme ou supprime les anciens dossiers du monde. Fais une sauvegarde avant.

Réglages de gameplay

difficulty : la plupart des serveurs survie utilisent normal ou hard. Peaceful supprime les monstres et les dégâts de faim, ce qui casse les fermes à mobs et beaucoup d'objectifs de survie.

allow-flight : mets-le à true si tu utilises des plugins de vol, un gameplay très axé sur les élytres avec du lag, ou certaines montures. Sinon, des joueurs peuvent être expulsés pour « vol » alors que le serveur est juste en train de laguer. Les plugins anti-cheat attrapent les vrais fly hacks bien mieux que ce réglage.

spawn-protection : la zone protégée est un carré autour du spawn du monde, et les opérateurs l'ignorent. Elle ne fonctionne que si au moins un joueur est opérateur. Beaucoup de serveurs la mettent à 0 et protègent le spawn avec WorldGuard à la place, ce qui permet de contrôler plus finement ce que les joueurs peuvent y faire.

Réglages de performance

view-distance ou simulation-distance : la distance de vue, c'est le nombre de chunks autour de chaque joueur envoyés à son client, pour qu'il puisse les voir. La distance de simulation, c'est le nombre de chunks autour de chaque joueur qui tournent vraiment : les mobs bougent, les cultures poussent, la redstone et les fourneaux fonctionnent. La simulation est la partie coûteuse, donc une configuration courante associe une distance de vue modérée à une distance de simulation plus basse. Les joueurs voient toujours loin, mais le serveur ne travaille que près d'eux. Une distance de simulation très basse casse les fermes qui ont besoin du joueur à proximité, alors ne descends pas sous 4 sur un serveur survie.

entity-broadcast-range-percentage : la distance à laquelle les joueurs voient les entités, en pourcentage de la portée par défaut (10 à 1000). La baisser réduit le trafic réseau sur les serveurs chargés, mais les mobs et les autres joueurs apparaissent plus tard, ce qui compte en PvP.

sync-chunk-writes : quand il vaut true, les chunks sont sauvegardés de façon synchrone, ce qui est plus sûr si le serveur crashe. Le mettre à false peut accélérer la sauvegarde, mais tu risques de perdre les changements récents en cas de crash. Laisse-le activé sauf si tu sais pourquoi tu le changes.

max-tick-time : si un tick dure plus que ce nombre de millisecondes, le watchdog arrête le serveur, parce qu'il est probablement figé. -1 désactive le watchdog. Ne le désactive pas pour cacher des crashs ; trouve plutôt la cause avec un profileur. Comment réduire le lag sur un serveur Minecraft explique comment faire.

À partir de la 1.21.2, pause-when-empty-seconds met le serveur en pause quand il est vide depuis ce nombre de secondes. Ça économise des ressources sur un serveur privé, mais sur un serveur public, certains plugins et minuteries s'attendent à ce que le monde continue de tourner.

Réglages de sécurité

online-mode

online-mode=true (la valeur par défaut) fait vérifier le compte de chaque joueur auprès de Mojang. Laisse-le activé.

Avec online-mode=false (mode hors ligne), le serveur croit n'importe quel pseudo envoyé par le client. N'importe qui peut se connecter en se faisant passer pour n'importe quel joueur, toi ou ton staff compris, et récupérer son inventaire, ses claims et ses permissions. Les plugins qui utilisent les UUID voient aussi des UUID différents de ceux du mode en ligne, donc changer plus tard mélange les données des joueurs.

La seule exception normale est un serveur derrière un proxy comme Velocity : dans ce cas, le proxy tourne en mode en ligne et les serveurs backend en mode hors ligne avec le transfert des infos joueurs, et les backends ne doivent accepter que les connexions venant du proxy. Vois comment configurer un réseau Velocity.

enforce-secure-profile

Par défaut true. Les joueurs doivent avoir une clé de profil signée par Mojang pour rejoindre, utilisée pour le chat signé. Si certains joueurs ne peuvent pas rejoindre à cause d'un message de clé publique manquante, ou si tu utilises certaines configurations de chat ou de proxy, des propriétaires la mettent parfois à false. Laisse-la à true sauf si tu as une raison précise.

Whitelist

• white-list (par défaut false) : seuls les joueurs de la whitelist peuvent rejoindre.
• enforce-whitelist (par défaut false) : quand il vaut true, les joueurs connectés mais absents de la liste sont expulsés dès que la whitelist est rechargée.

Tu peux aussi l'activer en jeu avec /whitelist on. Toutes les étapes sont dans comment mettre une whitelist sur un serveur Minecraft.

Query et RCON

enable-query (par défaut false) active le protocole de requête GameSpy4 sur query.port (UDP, 25565 par défaut). Certains outils et certaines listes l'utilisent pour lire les plugins et les pseudos des joueurs. Il est facultatif ; les pings de statut fonctionnent sans lui.

enable-rcon (par défaut false) permet un accès à distance à la console sur rcon.port (TCP, 25575 par défaut) avec rcon.password. RCON envoie des commandes avec tous les pouvoirs de la console, et le mot de passe n'est pas chiffré. Si tu l'utilises :

• Utilise un mot de passe long et aléatoire.
• Ne redirige et n'expose jamais le port RCON sur Internet. Ne l'autorise que depuis la même machine ou un réseau privé.
• Si tu n'en as pas besoin, laisse-le désactivé.

Autres clés de sécurité

• op-permission-level (par défaut 4) : ce que les opérateurs peuvent faire. 4 permet tout, y compris arrêter le serveur.
• prevent-proxy-connections (par défaut false) : expulse les joueurs dont la connexion semble passer par un VPN ou un proxy, en comparant les adresses avec Mojang. Ça peut bloquer des joueurs légitimes.
• rate-limit (par défaut 0) : expulse les clients qui envoient trop de paquets par seconde. 0 le désactive.
• log-ips (par défaut true, 1.20.2+) : si les adresses IP des joueurs sont écrites dans le log.
• accepts-transfers (par défaut false, 1.20.5+) : si le serveur accepte les joueurs envoyés depuis un autre serveur avec le paquet de transfert.

Réglages du pack de ressources

• resource-pack : une URL de téléchargement direct vers un fichier zip. Les liens vers des pages de téléchargement ne fonctionnent pas ; l'URL doit renvoyer le fichier lui-même.
• resource-pack-sha1 : le hash SHA-1 du zip. Il permet aux clients de garder le pack en cache et de voir quand il a changé. Mets-le à jour chaque fois que tu modifies le fichier.
• require-resource-pack : si true, les joueurs qui refusent le pack sont déconnectés.
• resource-pack-prompt : un message personnalisé affiché dans la demande de téléchargement.

N'impose un pack que si ton serveur en a vraiment besoin, et garde-le léger. Un gros pack obligatoire, c'est une raison de plus pour un nouveau joueur d'abandonner. Les joueurs Bedrock qui passent par Geyser ont besoin d'un pack converti.

Un point de départ raisonnable

Pour un petit serveur survie public sous Paper :

server-port=25565
online-mode=true
enforce-secure-profile=true
max-players=50
difficulty=normal
view-distance=8
simulation-distance=6
spawn-protection=0
white-list=false
enable-status=true
enable-query=false
enable-rcon=false
network-compression-threshold=256
max-tick-time=60000
sync-chunk-writes=true

Ajuste max-players, view-distance et simulation-distance selon ton matériel, et observe le comportement du serveur avec des joueurs connectés. Après avoir changé des réglages, redémarre et vérifie que le serveur apparaît toujours correctement avec le vérificateur de statut de serveur.