Qu'est-ce que server.properties et où le trouver ?
server.properties est un fichier texte situé dans le dossier principal d'un serveur Minecraft Java, où chaque ligne a la forme option=valeur. Le serveur le crée lui-même au premier lancement et le relit à chaque démarrage.
À savoir avant de commencer :
- Les changements s'appliquent après un redémarrage. Le serveur ne lit le fichier qu'au démarrage, il faut donc le redémarrer après modification.
- Modifiez-le serveur arrêté ou via le panel. Un serveur en marche enregistre lui-même ce fichier (par exemple après certaines commandes), donc des modifications manuelles faites entre-temps peuvent être écrasées.
- Les valeurs s'écrivent sans guillemets ni espaces autour du
=, par exemplewhite-list=true. - C'est le fichier de l'édition Java. Les autres éditions du jeu ont leurs propres réglages, avec d'autres options.
Sur Spot.gg, les options les plus utilisées se trouvent dans « Configuration » → « Les plus populaires », sous forme de champs avec description (par exemple des curseurs pour la distance de vue). Toutes les autres sont dans l'onglet « server.properties » à côté, avec une recherche d'options et un bouton « Enregistrer les modifications » en bas. Après l'enregistrement d'un changement qui demande un redémarrage, un bouton « Redémarrer maintenant » apparaît sous le champ. Vous pouvez aussi ouvrir le fichier dans l'éditeur intégré de l'onglet « Fichiers ».
Les options essentielles de server.properties
Les options les plus souvent modifiées sont online-mode, max-players, white-list, difficulty, gamemode, pvp, view-distance et motd. Le tableau donne les valeurs par défaut d'un serveur Vanilla.
| Option | Par défaut | Ce qu'elle fait |
|---|---|---|
online-mode |
true |
true – seulement les joueurs avec un compte Microsoft possédant le jeu ; false – n'importe quel pseudo (mode hors ligne) |
max-players |
20 |
Nombre de joueurs connectés en même temps |
white-list |
false |
Active la liste blanche – seuls les joueurs listés et les opérateurs peuvent entrer |
enforce-whitelist |
false |
Expulse les joueurs non listés quand la liste blanche est activée ou rechargée |
motd |
A Minecraft Server |
Description du serveur dans la liste des serveurs du jeu |
gamemode |
survival |
Mode de jeu des nouveaux joueurs : survival, creative, adventure, spectator |
force-gamemode |
false |
Remet les joueurs dans le mode de gamemode à chaque connexion |
difficulty |
easy |
Difficulté : peaceful, easy, normal, hard |
hardcore |
false |
Mode hardcore : difficulté « hard », le joueur devient spectateur après sa mort |
pvp |
true |
Si les joueurs peuvent s'infliger des dégâts – jusqu'à 1.21.8 seulement ; depuis 1.21.9, règle du jeu pvp |
spawn-protection |
16 |
Rayon de protection du spawn en blocs (0 la désactive) ; ne s'applique pas aux opérateurs |
allow-nether |
true |
Si l'on peut aller dans le Nether |
allow-flight |
false |
Si le serveur autorise le vol (mods, plugins) – avec false, il peut expulser un joueur pour « vol » |
enable-command-block |
false |
Si les blocs de commande fonctionnent – jusqu'à 1.21.8 seulement ; depuis 1.21.9, règle du jeu command_blocks_work |
view-distance |
10 |
Distance de vue en chunks |
simulation-distance |
10 |
Distance en chunks où le monde « vit » : mobs, cultures, redstone |
level-name |
world |
Nom du dossier du monde |
level-seed |
vide | Seed d'un nouveau monde ; vide = aléatoire |
op-permission-level |
4 |
Niveau de permissions des opérateurs (1–4) |
player-idle-timeout |
0 |
Après combien de minutes d'inactivité un joueur est expulsé (0 – jamais) |
Dans les versions récentes, Mojang ajoute, supprime ou déplace certaines options vers les règles du jeu (/gamerule). Depuis Java 1.21.9, pvp, spawn-monsters et enable-command-block ne sont plus dans server.properties : en 1.21.9 et plus, utilisez les règles du jeu pvp, spawn_monsters et command_blocks_work (en 1.21.9–1.21.10 sous les anciens noms camelCase, par exemple spawnMonsters) ; en 1.21.8 et avant, les options du fichier fonctionnent toujours. Depuis 1.21.11, presque toutes les règles du jeu ont de nouveaux noms (par exemple keep_inventory au lieu de keepInventory). Si une autre option manque dans votre fichier, vérifiez si elle n'est pas devenue une règle du jeu dans votre version.
Comment choisir qui peut entrer sur le serveur ?
L'accès dépend de online-mode (mode en ligne ou hors ligne), de white-list (joueurs choisis uniquement) et de max-players (nombre de places). Ce sont les premières options à régler sur un nouveau serveur.
online-mode=true– le serveur vérifie le compte Microsoft de chaque joueur, les pseudos ne peuvent donc pas être usurpés. C'est le réglage par défaut et le plus sûr.online-mode=false– les joueurs sans jeu acheté peuvent aussi entrer, mais n'importe qui peut taper n'importe quel pseudo : un plugin de connexion est indispensable. Changer de mode modifie aussi les identifiants (UUID) des joueurs. Sur Spot.gg, quand vous changez « Qui peut entrer », le panel propose de convertir les comptes des joueurs pour que personne ne perde son inventaire. Détails dans le guide serveur Minecraft en mode hors ligne.white-list=true– un serveur réservé aux amis. La liste blanche se gère plus facilement avec des commandes ou dans la « Console », où l'on ajoute un joueur en un clic.
Comment régler le monde : nom, seed et type de carte ?
level-name indique le dossier du monde, tandis que level-seed et level-type ne s'appliquent qu'à la création d'un nouveau monde. Changer le seed ne reconstruit pas un monde existant.
level-name– si un dossier porte ce nom, le serveur le charge ; sinon, il crée un nouveau monde. Vous pouvez ainsi garder plusieurs mondes sur un serveur et passer de l'un à l'autre en changeant le nom.level-seed– le seed, par exemple copié depuis un site de seeds. La commandeseedaffiche le seed actuel.level-type– type de carte, par exempleminecraft:normal(par défaut),minecraft:flat(monde plat),minecraft:large_biomes(grands biomes),minecraft:amplified(montagnes très hautes, lourd pour le serveur).generate-structures– si les villages, temples et autres structures sont générés dans les nouvelles zones du monde.
Sur Spot.gg, dans « Configuration » → « Les plus populaires » → « Monde », après la saisie d'un nouveau seed, le panel signale qu'il ne changera pas le monde actuel et propose « Créer un nouveau monde » : le serveur crée un monde sous un nouveau nom et l'ancien reste sur le disque. C'est plus doux que de supprimer le monde.
Quelles options influencent les performances et le lag ?
Surtout view-distance et simulation-distance : plus elles sont élevées, plus le serveur doit charger et simuler de chunks pour chaque joueur. Les baisser est le moyen le plus simple d'alléger le processeur.
| Option | Ce qu'elle influence | Conseil |
|---|---|---|
view-distance |
Quelle zone autour du joueur le serveur envoie au jeu | En général 8 pour les modpacks, environ 10 pour les serveurs légers |
simulation-distance |
Où les mobs, cultures et redstone sont actifs | Une valeur supérieure à view-distance ne sert à rien |
max-tick-time |
Après combien de ms d'un tick bloqué le serveur s'arrête de lui-même (-1 – jamais) |
Ne la baissez pas sans savoir pourquoi |
pause-when-empty-seconds |
Après combien de secondes sans joueurs le serveur met le monde en pause (0 – désactivé) |
Disponible dans les versions récentes |
network-compression-threshold |
Taille à partir de laquelle les paquets sont compressés | Gardez la valeur par défaut |
Sur Spot.gg, la section « Performances » de « Les plus populaires » propose les curseurs « Distance de vue » et « Distance de simulation », avec la conversion en blocs et une évaluation de la charge (« Charge légère », « Charge moyenne », « Charge élevée »). À grande distance, le panel prévient que la génération de nouveau terrain sollicite fortement le processeur et recommande de pré-générer le monde à l'avance, hors des heures de jeu, par exemple avec l'add-on Chunky.
Quelles options ne peut-on pas modifier chez un hébergeur ?
Chez un hébergeur, server-port et server-ip sont définis par le système, car ils déterminent si les joueurs peuvent se connecter. Sur Spot.gg, ces champs portent la mention « Verrouillé » avec l'indication « Défini automatiquement par Spot.gg ».
Sont verrouillés : server-port, server-ip, query.port et enable-query. Sur les serveurs avec un modpack prêt à l'emploi, max-tick-time et allow-flight le sont aussi, car les packs exigent des valeurs précises (par exemple le vol pour les mods de jetpack). L'adresse et le port du serveur se trouvent dans l'onglet « Réseau », et les joueurs n'entrent que l'adresse, sans port.
Un mot sur RCON (enable-rcon, rcon.password, rcon.port) : c'est un accès à distance à la console, mais le protocole ne chiffre rien, pas même le mot de passe. Sur Spot.gg, la console est dans le panel, donc RCON n'est généralement pas nécessaire.
Comment ajouter un pack de ressources au serveur ?
Indiquez dans resource-pack un lien direct vers le fichier .zip du pack, et choisissez avec require-resource-pack si les joueurs doivent l'accepter. Le jeu télécharge le pack à la connexion.
resource-pack– lien direct vers le fichier .zip (pas une page avec un bouton de téléchargement),resource-pack-prompt– le texte affiché aux joueurs dans la demande de téléchargement,require-resource-pack=true– un joueur qui refuse le pack est déconnecté.
Un pack de ressources ne change que l'apparence et les sons côté joueurs. Pour de nouveaux blocs et mécaniques, il faut des mods, par exemple sur un serveur NeoForge, Forge ou Fabric.
FAQ
Où se trouve le fichier server.properties ?
Dans le dossier principal du serveur, à côté du .jar du serveur et du dossier du monde. Sur Spot.gg, ouvrez-le dans « Configuration » → « server.properties » ou dans l'onglet « Fichiers ».
Pourquoi mes modifications de server.properties ne fonctionnent-elles pas ?
Le plus souvent, le serveur n'a pas été redémarré, ou le fichier a été modifié pendant que le serveur tournait et le serveur a ensuite écrasé les changements. Enregistrez, redémarrez le serveur et vérifiez que la valeur est restée.
Comment désactiver le PvP sur un serveur Minecraft ?
En Minecraft 1.21.9 et plus, tapez gamerule pvp false dans la console du serveur – sans redémarrage ; la ligne pvp de server.properties n'a plus d'effet. En 1.21.8 et avant, mettez pvp=false et redémarrez le serveur. Dans les deux cas, les joueurs ne pourront plus s'infliger de dégâts. Pour un PvP limité à certaines zones, il faut un plugin, par exemple de protection de terrains.
Comment changer le nombre de places sur le serveur ?
Modifiez max-players. Sur Spot.gg, utilisez le champ « Places de joueurs » dans « Configuration » → « Les plus populaires ». Plus de places ne donne pas plus de puissance au serveur : avec beaucoup de joueurs, il peut falloir plus de RAM.
Changer level-seed modifie-t-il mon monde ?
Non. Le seed ne s'applique qu'à la création d'un nouveau monde. Pour jouer sur un nouveau seed, changez aussi level-name pour un nouveau nom : le serveur crée un nouveau monde et l'ancien reste dans son dossier.