Server.properties

De Minecraft Wiki
Aller à la navigation Aller à la recherche
Un fichier server.properties ouvert avec Notepad++

Server.properties est le fichier qui stocke tous les paramètres d'un serveur multijoueur (Minecraft ou Minecraft classique).

Si vous voulez éditer le fichier server.properties il est important que vous utilisiez la même structure que l'original, même si l'ordre des lignes est arbitraire. Le texte avant le signe égal est la clé qu'il ne faut pas changer. Le texte après le signe égal est la valeur de la clé, que vous pouvez modifier. Les lignes qui commencent avec # sont des commentaires - la modification ou la suppression de ces lignes n'a aucun effet sur le jeu.

Une fois que des modifications sont apportées au fichier server.properties, le serveur doit être redémarré pour qu'elles soient effectives.

Si le fichier server.properties ne liste pas toutes les clés (par exemple, si une nouvelle version du serveur ajoute de nouvelles clés, ou si le fichier n'existe pas), au prochain démarrage du serveur, il réécrira le fichier server.properties avec les nouvelles clés listées et mettra respectivement leur valeur par défaut.

Emplacement du fichier

[modifier | modifier le wikicode]

Ce fichier est généré automatiquement lors du premier démarrage du serveur (s'il n'existe pas déjà).

Système d'exploitation Emplacement du fichier Notes
Windows Même dossier que Minecraft_Server.exe
Linux

Unix *nix/Mac

Chemin d'accès du dossier courant (pwd)

Si vous le lancez depuis votre répertoire personnel (/home/"Nom joueur") les fichiers du serveur seront créés dans /home/"Nom joueur". Suivez ces directives pour veiller à ce que les fichiers du serveur soient générés où vous le voulez.

  • Prévoyez tout un dossier pour tous les fichiers du serveur (c'est important afin de ne pas avoir de fichiers dispersés). Par exemple /home/"Nom joueur"/minecraft.
    • Placez le fichier minecraft_server.jar dans ce dossier.
  • Utilisez le script Média:Minecraft server template.txt pour mettre en place les paramètres de démarrage de votre serveur Minecraft.
    • Soyez sûr d'ajouter la permission d'exécution pour le script de démarrage (chmod + x "Nom fichier", ou utilisez le gestionnaire de fichiers).
      • Changez l’extension du fichier en Minecraft_server.sh à l'aide de la commande mv ancien nom du fichier nouveau nom du fichier.
  • Vous pouvez mettre le chemin de l’exécutable dans la variable $PATH afin de rendre plus facile le démarrage du serveur.

Contenu du fichier

[modifier | modifier le wikicode]

Pour la version 1.21.11, voici les paramètres par défaut pour un serveur Minecraft nouvellement installé :

#Minecraft server properties
#(Date et heure de modification du fichier)
accepts-transfers=false
allow-flight=false
broadcast-console-to-ops=true
broadcast-rcon-to-ops=true
bug-report-link=
difficulty=easy
enable-code-of-conduct=false
enable-jmx-monitoring=false
enable-query=false
enable-rcon=false
enable-status=true
enforce-secure-profile=true
enforce-whitelist=false
entity-broadcast-range-percentage=100
force-gamemode=false
function-permission-level=2
gamemode=survival
generate-structures=true
generator-settings={}
hardcore=false
hide-online-players=false
initial-disabled-packs=
initial-enabled-packs=vanilla
level-name=world
level-seed=
level-type=minecraft\:normal
log-ips=true
management-server-allowed-origins=
management-server-enabled=false
management-server-host=localhost
management-server-port=0
management-server-secret=(une longue chaine de caractères générée aléatoirement)
management-server-tls-enabled=true
management-server-tls-keystore=
management-server-tls-keystore-password=
max-chained-neighbor-updates=1000000
max-players=20
max-tick-time=60000
max-world-size=29999984
motd=A Minecraft Server
network-compression-threshold=256
online-mode=true
op-permission-level=4
pause-when-empty-seconds=60
player-idle-timeout=0
prevent-proxy-connections=false
query.port=25565
rate-limit=0
rcon.password=
rcon.port=25575
region-file-compression=deflate
require-resource-pack=false
resource-pack=
resource-pack-id=
resource-pack-prompt=
resource-pack-sha1=
server-ip=
server-port=25565
simulation-distance=10
spawn-protection=16
status-heartbeat-interval=0
sync-chunk-writes=true
text-filtering-config=
text-filtering-version=0
use-native-transport=true
view-distance=10
white-list=false

Propriétés d'un serveur Minecraft

[modifier | modifier le wikicode]
Clé Type Valeur par défaut Description
allow-flight booléen[1] false Permet aux joueurs de voler sur votre serveur en mode Survie, s'ils ont un mod d'installé qui leur permet de voler. Cette propriété n'a aucun effet en mode Créatif, le vol étant toujours autorisé.

Régler cette propriété sur true augmente le risque de vandalisme, le travail des vandales étant facilité par la possibilité de voler.

difficulty chaîne[2] easy Détermine la difficulté du serveur :
  • peaceful - Paisible
  • easy - Facile
  • normal - Normal
  • hard - Difficile

Il est possible de modifier la difficulté pendant que le serveur fonctionne avec la commande /difficulty, mais elle sera réinitialisée à valeur définie dans le fichier server.properties au prochain redémarrage du serveur.

enable-query booléen[1] false Autorise le protocole de serveur d'écoute GameSpy4. Utilisé pour obtenir des informations du serveur.[3]
enable-rcon booléen[1] false Autorise l'accès à distance à la console du serveur.
enforce-whitelist booléen[1] false Détermine si le serveur doit faire appliquer la liste blanche dès qu'elle est activée. Si cette propriété est réglée sur true, les joueurs qui ne sont pas sur la liste blanche sont expulsés du serveur dès que le fichier whitelist.json est rechargé par le serveur.
force-gamemode booléen[1] false Détermine si les joueurs doivent être remis sur le mode de jeu par défaut du serveur (défini par la propriété gamemode) lorsqu'ils se reconnectent au serveur.
gamemode chaîne[2] survival Détermine le mode de jeu par défaut du serveur :

Tous les nouveaux joueurs sont mis dans ce mode de jeu à leur première connection sur le serveur. Il est possible de leur faire changer de mode de jeu pendant que le serveur fonctionne avec la commande /gamemode. Lorsqu'un joueur se reconnecte, il restera dans le même mode de jeu qu'avant sa déconnection si la propriété force-gamemode vaut false, et il sera remis dans le mode de jeu par défaut du serveur si elle vaut true.

generate-structures booléen[1] true Détermine si les structures (telles que les villages) seront générées.
false - Les structures ne seront pas générées dans les nouveaux tronçons.
true - Les structures seront générées dans les nouveaux tronçons.
hardcore booléen[1] false Si activé, le joueur sera banni définitivement à sa mort.
level-name chaîne[2] world Définit le nom du dossier dans lequel sont sauvegardées les données du monde.
  • Si aucun dossier avec ce nom n'existe dans le dossier du serveur, un nouveau monde est généré avec ce nom.
  • Si un monde avec ce nom existe déjà dans le dossier du serveur, le serveur est chargé avec ce monde. Il est donc possible de jouer dans un monde déjà existant (par exemple, un monde généré en solo ou sur un autre serveur) en copiant le dossier du monde dans le dossier du seveur et en lui donnant le même nom que la valeur de cette propriété.
  • Si un dossier avec ce nom existe déjà dans le dossier du serveur mais n'est pas reconnu comme contenant les données d'un mode, un nouveau monde sera généré dans ce dossier et les fichiers déjà existants seront conservés.

Si le nom du monde contient une apostrophe, celle-ci doit être précédée par un caractère d'échappement (par exemple, « l'adorable » devient l\'adorable).

level-seed chaîne[2] vide Définit la graine du monde utilisée pour générer le monde.
level-type chaîne[2] minecraft\:normal Détermine le type de monde généré :
DEFAULT - Monde standard avec collines, vallées, eau, etc.
FLAT - Un monde plat.
LARGEBIOMES - Un monde avec des biomes vastes.
AMPLIFIED - Un monde amplifié.
CUSTOMIZED - Un monde personnalisé. Il faut d'abord créer le monde en solo et ensuite le copier sur le serveur.
log-ips booléen[1] true Détermine si les adressses IP des joueurs qui se connectent au serveur sont affichées dans les logs.
max-players entier 20 Définit le nombre maximum de joueurs pouvant être connectés sur le serveur simultanément. Plus il y a de joueurs connectés simultanément, plus le serveur consommera de ressources.

Les opérateurs ne sont pas comptés dans le nombre de joueurs connectés simultanément, mais ne peuvent pas rejoindre un serveur déjà plein.

server-port entier (1024-65535) 25565 Détermine le port sur lequel le serveur écoute. Ce port doit être ouvert si le serveur est derrière un routeur.

Attention à ne pas choisir un port déjà occupé par un autre programme !

server-ip chaîne[2] vide Définissez-la si vous voulez que votre serveur réponde sur une IP précise. Il est vivement recommandé de laisser cette option vide!

Laissez vide, ou mettez l'IP sur laquelle votre serveur doit fonctionner.

online-mode booléen[1] true Le serveur vérifie les connexions des joueurs et la confronte avec la base de données des comptes Minecraft.net. Définissez la clé sur false uniquement si votre serveur n'est pas connecté à internet. Les Hackers avec un faux compte pourrons se connecter si celle-ci est définie sur false! Si Minecraft.net est en panne ou inaccessible, aucun joueur ne pourra se connecter si elle est définie sur true.
true - Activé. Le serveur va supposer qu'il dispose d'une connexion Internet et vérifiera chaque connexion des joueurs. Seuls les joueurs ayant un compte Minecraft Premium pourront rejoindre le serveur.
false - Désactivé. Le serveur ne vérifiera pas les connexions des joueurs. Les joueurs qui ne possèdent pas de compte Minecraft Premium pourront rejoindre le serveur.
player-idle-timeout entier 0 Définit le temps (exprimé en minutes) au bout duquel un joueur inactif est expulsé du seveur. Si sa valeur vaut 0, les joueurs ne sont jamais expulsés pour inactivité.

Note : Le temps est réinitialisé lorsque le serveur reçoit l'un des paquets suivants:

  • 102 (0x66) WindowClick
  • 108 (0x6c) ButtonClick
  • 130 (0x82) UpdateSign
  • 14 (0xe) BlockDig
  • 15 (0xf) Place
  • 16 (0x10) BlockItemSwitch
  • 18 (0x12) ArmAnimation
  • 19 (0x13) EntityAction
  • 205 (0xcd) ClientCommand
  • 3 (0x3) Chat
  • 7 (0x7) UseEntity
view-distance entier (3-15) 10 Définit la quantité de données du monde du serveur envoyée au client, mesurée en tronçon dans chaque direction du joueur.

Il détermine la distance de visualisation côté serveur. La distance "Loin" de visualisation est de 9 tronçons. 10 est la valeur par défaut recommandée.

Conseil : Si vous avez d'importantes latences, réduisez cette valeur.

Note : Une valeur inférieure à 9 aura un impact important sur l'apparition des créatures de votre serveur tel que mentionné dans le bogue 2536 (miroir).

motd chaîne[2] A Minecraft Server C'est le message qui est affiché dans la liste des serveurs du client, au-dessous du nom.
  • Remarque, motd supporte les codes de couleur comme §2. Le § doit être remplacé par \u00A7.
  • Le MOTD est également depuis les dernières versions composé de deux lignes. Le caractère \n permet de créer un retour à la ligne.
query.port entier (1-65535) 25565 Inscrivez le port pour le serveur query (voir enable-query).
Note : Cette ligne n'apparaît que si la clé enable-query est activée.
rcon.password chaîne[2] vide Mot de passe pour le rcon (voir enable-rcon).
Note : Cette ligne n'apparaît que si la clé enable-rcon est activée.
rcon.port entier (1-65535) 25575 Inscrivez le port pour le rcon (voir enable-rcon).
Note : Cette ligne n'apparaît que si la clé enable-rcon est activée.
snooper-enabled booléen[1] true Depuis la version 1.3.1, détermine si le serveur envoie régulièrement (ou non) des données à snoop.minecraft.net.
false - Désactive l'espionnage.
true - Active l'espionnage.
resource-pack chaîne[2] vide Le serveur invite le client à télécharger le pack de textures "par-défaut" lors de sa connexion. Mettre un lien web pour le pack de textures que vous souhaitez.

IMPORTANT: Ce lien doit être un lien direct redirigeant vers le fichier .zip du pack.

En outre, cela ne patch pas les clients pour les packs de textures en HD. Vous devriez chercher le pack adéquat, c'est-à-dire un 16x16 pour que la majorité des joueurs non-patchés puissent être en mesure d'utiliser le pack.

spawn-protection entier 16 Détermine le rayon de protection au point d'apparition du serveur, le chunk du "milieu" n'est pas compté dans les chunks protégés (même si il est protégé), il faut donc mettre en -1 pour désactiver totalement la protection du spawn. Mettre en 0 laissera le chunk de spawn protégé.
  • -1 - La protection au spawn sera désactivés.
  • 1 - Protégera une zone de 3x3 à partir du point de spawn.
  • 2 - Protégera une zone de 5x5 à partir du point de spawn.
  • 16 - Protégera une zone de 19x19 à partir du point de spawn.
  • etc...
op-permission-level entier (1 - 4) 4 Détermine le niveau d'autorisation des opérateurs sur le serveur.
  • 1 - Les opérateurs ne sont pas affectés par la protection du spawn.
  • 2 - Les opérateurs peuvent utiliser les commandes /clear, /difficulty, /effect, /gamemode, /gamerule, /give, /tp et modifier les blocs de commande.
  • 3 - Les opérateurs peuvent utiliser les commandes /ban, /deop, /kick, et /op.
  • 4 - Les opérateurs peuvent utiliser la commande /stop.
  • Note : Vous pouvez modifier le niveau d'autorisation d'un joueur en particulier dans le fichier Ops.json du serveur.
max-world-size entier (1 - 29999984) 29999984 Définit la taille maximum du monde et place la bordure du monde a cette limite.
max-tick-time entier (0 - (263 - 1)) 60000 Ce paramètre defini le temps maximum en miliseconde que peut prendre un tick avant que "l'horloge" du serveur coupe celui-ci avec le message d'alerte.

Un seul tick du serveur dure 60 secondes ( il peut être au maximum de 0.05 secondes ); Si on considère que le serveur crash, le serveur se forcera à s'éteindre.
Si ce critère est rencontré, il appellera le System.exit(1).

generator-settings chaîne[2] vide Utilisé pour personnaliser les mondes plats et les mondes personnalisés.
resource-pack-hash chaîne[2] vide Optionel : clé de type SHA-1 du fichier du pack de ressources en minuscules. Il est recommandé de la spécifier. Elle n'est pas encore utilisée pour vérifier l'intégrité du pack de ressources, mais améliore l'efficacité de la mise en cache.
network-compression-threshold entier 256 Seuil de compression des paquets.

Un paquet faisant 256 octets ou plus sera compressé avant d'être envoyé au client, une valeur plus faible signifie donc plus de compression.
Cela peut permettre de réduire le lag mais consommera plus de ressources processeur du serveur.

Définir à -1 pour ne rien compresser, à 0 pour tout compresser.

white-list booléen[1] false Détermine si une liste blanche est activée sur le serveur. Lorsque cette propriété est réglée sur true, les joueurs ne figurant pas sur la liste blanche définie par le fichier white-list.json ne pourront pas se connecter au serveur (à noter que les opérateurs du serveur sont automatiquement mis sur la liste blanche, il n'est donc pas nécessaire de les ajouter dessus manuellement).

Il est conseillé d'utiliser une liste blanche sur les serveurs privés et sur ceux utilisant un système de sélection.

Note: Depuis la refonte du système de commandes en 1.13, les valeurs des paramètres gamemode et difficulty doivent être écrites littéralement. Les entiers sont encore acceptés par le serveur, mais seront écrasés par leur équivalent littéral au lancement. (survival, adventure, creatif, spectator pour gamemode et peaceful, easy, normal, hard pour difficulty).

Propriétés d'un serveur Minecraft Classic

[modifier | modifier le wikicode]
Clé Type Valeur par défaut Description
verify-names booléen[1] true Si activé, le serveur fera en sorte que le client soit connecté avec la même adresse IP que sur Minecraft.net. Cela a causé des problèmes pour les gens qui essayaient de jouer sur le même ordinateur que celui qui hébergeait le serveur, le serveur verra l'adresse IP locale (127.0.0.1), tandis que Minecraft.net verra l'adresse IP externe. Il est recommandé d'activer cette option, sauf si vous voulez jouer sur votre serveur à partir du même ordinateur que celui sur lequel vous l'hébergez.
true - Activé. Le serveur vérifiera tous les noms avec Minecraft.net
false - Désactivé. Le serveur ne vérifiera pas.
admin-slot booléen[1] false Autorise les ops à joindre le serveur même s'il est plein.
public booléen[1] Sert à savoir si le serveur doit être affiché dans la liste des serveurs ou non.
true - Le serveur sera affiché dans la liste des serveurs - n'importe qui peut le voir.
false - Seules les personnes ayant l'URL qui peut être trouvée dans externalurl.txt et les gens qui connaissent l'adresse IP et le port peuvent joindre le serveur.
server-name chaîne[2] Le nom du serveur. Il est affiché dans la liste des serveurs et quand quelqu'un rejoint le serveur.
  • Une seule ligne de texte. Les caractères telles que les ' (apostrophe) doivent avoir un caractère d’échappement devant (par exemple, l'adorable devient l\'adorable).
max-players entier (0-256) Le nombre max de joueurs qui peuvent jouer sur le serveur simultanément. Notez que plus le nombre de joueurs présents sur le serveur est élevé, plus ils utiliseront de ressources. Notez également, les connexions d'op ne sont pas déduites du nombre de joueurs maximum.
max-connections entier (1-3) Le nombre maximum de connexions que le serveur va accepter de la même adresse IP.
Si vous essayez de le mettre supérieur à 3, il sera modifié pour revenir à 3.
motd chaîne[2] MOTD est l'abréviation de message de la journée (Message Of The Day), bien que vous n'ayez pas besoin de le changer tous les jours. Le MOTD s'affiche lorsque les joueurs rejoignent le serveur.
grow-trees booléen[1] Savoir si, oui ou non, le serveur permettra aux pousses d'arbre plantées de croître.
true - le serveur permettra aux pousses d'arbre plantées de croître.
false - le serveur ne permettra pas aux pousses d'arbre plantées de croître.

Notes et références

[modifier | modifier le wikicode]
  1. ↑ a b c d e f g h i j k l m n et o Vrai/Faux
  2. ↑ a b c d e f g h i j k l et m Séquence de caractères
  3. ↑ Minecraft Query sur le forum Open Classrooms (ancien Site du Zéro )