Comment installer un serveur Minecraft à partir de zéro : Paper sous Windows et Linux
Dans ce guide, vous installerez à partir de zéro un serveur Minecraft Java Edition basé sur Paper, sur un serveur Windows ou Linux vierge. Vous apprendrez étape par étape à choisir la bonne version de Java pour votre version de Minecraft, à télécharger Paper et à accepter le CLUF (EULA) dans eula.txt, à écrire un script de démarrage, à ouvrir le port 25565, à vous donner les droits d'opérateur, à configurer les réglages de base de server.properties, à faire des sauvegardes et à mettre à jour. Les commandes Linux sont destinées à Ubuntu/Debian.
Avant de commencer
- Un serveur : un VDS sous Windows Server ou Ubuntu/Debian. Vous vous connectez à Windows via le Bureau à distance (RDP, 3389) et à Linux en SSH (22). Sur les VDS HanHosting présentés sur la page Location de serveur Minecraft, l'adresse IP et le mot de passe administrateur initial figurent sur la page du service dans l'Espace client et dans l'e-mail d'activation ; si RDP ou SSH ne fonctionne pas, vous pouvez accéder à l'écran du serveur depuis la console VNC du panneau.
- Assez de mémoire : en plus de la RAM que vous attribuez à Java, vous devez laisser une marge au système d'exploitation ; sous Windows, cette marge est plus importante que sous Linux. Le détail du calcul se trouve dans le guide Comment allouer de la RAM à un serveur Minecraft : Xms, Xmx et flags d'Aikar.
- Version de Minecraft visée : les clients des joueurs doivent être dans la même version que le serveur. C'est d'après ce choix que vous choisirez la version de Java.
- Logiciel serveur : ce guide utilise Paper, qui prend en charge les plugins. Pour les différences entre Vanilla, Spigot, Paper et Purpur, consultez le guide Vanilla, Spigot, Paper, Purpur et Folia : lequel choisir ?
- Réseau : vous devez ouvrir le port dans le pare-feu du système d'exploitation.
1. Installez la bonne version de Java pour votre version de Minecraft
Un serveur Minecraft fonctionne avec Java, et chaque version exige une version précise de Java. La correspondance indiquée dans la documentation de PaperMC est la suivante :
| Version de Minecraft / Paper | Java requis |
|---|---|
| 1.17 – 1.19 | Java 17 |
| 1.20 – 1.21.11 | Java 21 |
| 26.1 et ultérieures | Java 25 |
Si vous installez un nouveau serveur, choisissez la version actuelle sur la page de téléchargement et installez Java 25 ; si vous installez une version plus ancienne (par ex. 1.21.x), utilisez la version de Java indiquée dans le tableau. Si Java est plus ancien que la version requise, le serveur ne démarre pas. PaperMC recommande la distribution Amazon Corretto et précise que les paquets dont le nom se termine par -headless n'incluent pas certains composants dont Paper a besoin.
Windows : avec le lien de la page d'installation de Java de PaperMC, téléchargez le programme d'installation Amazon Corretto 25 x64 (amazon-corretto-25-x64-windows-jdk.msi) et installez-le avec les options par défaut ; pour une version plus ancienne de Minecraft, récupérez sur la page de téléchargement Corretto d'Amazon le programme d'installation Windows x64 de la version de Java indiquée dans le tableau. Ouvrez ensuite une nouvelle invite de commandes et vérifiez :
java -version
Si la commande est introuvable, définissez, comme l'indique la documentation d'installation d'Amazon, la variable d'environnement JAVA_HOME sur le dossier d'installation (par défaut, le dossier de version sous C:\Program Files\Amazon Corretto\) et ajoutez le chemin %JAVA_HOME%\bin à la variable PATH.
Ubuntu/Debian : ajoutez le dépôt Corretto, puis installez Java 25 et l'outil screen qui vous servira à faire tourner le serveur en arrière-plan :
sudo apt-get update
sudo apt-get install ca-certificates apt-transport-https gnupg wget
wget -O - https://apt.corretto.aws/corretto.key | sudo gpg --dearmor -o /usr/share/keyrings/corretto-keyring.gpg && \
echo "deb [signed-by=/usr/share/keyrings/corretto-keyring.gpg] https://apt.corretto.aws stable main" | sudo tee /etc/apt/sources.list.d/corretto.list
sudo apt-get update
sudo apt-get install -y java-25-amazon-corretto-jdk libxi6 libxtst6 libxrender1 screen
Pour Minecraft 1.20 à 1.21.11, remplacez java-25-amazon-corretto-jdk sur la dernière ligne par java-21-amazon-corretto-jdk ; pour 1.17 à 1.19, utilisez java-17-amazon-corretto-jdk. Les commandes pour les distributions basées sur RPM comme AlmaLinux se trouvent sur la même page de PaperMC. Après l'installation, la sortie de java -version doit commencer par openjdk et le numéro de la version installée, et la dernière ligne doit contenir 64-Bit.
2. Préparez le dossier du serveur et téléchargez Paper
Téléchargez Paper uniquement depuis la page de téléchargement officielle de PaperMC. Le nom du fichier a le format paper-<version>-<build>.jar (par ex. paper-26.3-194.jar). Renommez le fichier en paper.jar : ainsi, lors d'une mise à jour, vous n'aurez qu'à remplacer le fichier, sans toucher au script de démarrage.
Windows : créez un dossier vide nommé C:\minecraft et placez-y le fichier téléchargé sous le nom paper.jar. Dans le menu View (Affichage) de l'explorateur de fichiers (View → Show dans les versions récentes), activez l'option File name extensions (extensions de noms de fichiers) ; sinon, des fichiers risquent de s'appeler paper.jar.jar ou start.bat.txt sans que vous le remarquiez.
Linux : ne faites pas tourner le serveur en root. Si vous créez un utilisateur distinct, une faille de sécurité dans un plugin n'affecte que les fichiers de cet utilisateur :
sudo adduser --disabled-password minecraft
sudo -i -u minecraft
mkdir server
cd server
Si adduser vous demande des champs comme le nom et le téléphone, vous pouvez les passer avec Entrée. Sur la page de téléchargement, copiez le lien de téléchargement de la version souhaitée et récupérez le fichier directement sur le serveur :
wget -O paper.jar "YOUR_COPIED_LINK"
3. Premier démarrage et acceptation de eula.txt
Depuis le dossier du serveur, lancez Paper une première fois à la main. Sous Windows, si vous ouvrez le dossier C:\minecraft, tapez cmd dans sa barre d'adresse et appuyez sur Entrée, l'invite de commandes s'ouvre directement dans ce dossier.
java -Xms1G -Xmx1G -jar paper.jar --nogui
Au premier démarrage, le serveur crée le fichier eula.txt dans le dossier, puis s'arrête, car le contrat de licence utilisateur final de Minecraft (CLUF, en anglais EULA) n'a pas été accepté. Ouvrez le fichier avec un éditeur de texte (« Notepad », le Bloc-notes, sous Windows, nano sous Linux), lisez le contrat via le lien qu'il contient et modifiez la ligne ainsi :
eula=true
Tant que cette valeur reste à false, le serveur s'arrête immédiatement à chaque démarrage. Après avoir enregistré, passez au script de démarrage ; le serveur génère le monde au démarrage suivant.
4. Script de démarrage pour Windows (.bat)
Dans C:\minecraft, créez un fichier nommé start.bat et écrivez-y ceci :
@ECHO OFF
java -Xms4G -Xmx4G -jar paper.jar --nogui
pause
-Xmset-Xmx: la mémoire initiale et la mémoire maximale de Java. PaperMC recommande de garder les deux valeurs égales ; indiquez votre propre valeur à la place de4G.--nogui: désactive la fenêtre d'interface graphique de Vanilla, pour qu'une deuxième interface ne s'ouvre pas à côté de la ligne de commande.pause: garde la fenêtre ouverte lorsque le serveur s'arrête, pour que vous puissiez lire le message en cas d'erreur.
Lancez le serveur en double-cliquant sur le fichier. Lorsque le message commençant par Done apparaît dans la console, le serveur est prêt. Les commandes se tapent dans la console sans / au début ; pour arrêter le serveur, tapez stop au lieu de fermer la fenêtre avec le bouton X. Lorsque vous quittez le Bureau à distance, fermez la fenêtre de connexion ; si vous vous déconnectez depuis le menu Démarrer, le serveur s'arrête avec les programmes de la session.
Les options JVM (Java Virtual Machine) supplémentaires ne sont pas nécessaires. Le générateur de scripts de démarrage de PaperMC recommande de démarrer sans options sur les versions actuelles comme Java 17, 21 et ultérieures ; envisagez les flags d'Aikar en cas de saccades dues au ramasse-miettes (garbage collection, GC) ou sur des versions plus anciennes.
5. Script de démarrage pour Linux (.sh) et screen
En tant qu'utilisateur minecraft, créez le fichier start.sh dans le dossier du serveur :
#!/bin/sh
cd "$(dirname "$0")"
exec java -Xms4G -Xmx4G -jar paper.jar --nogui
La deuxième ligne fait tourner le serveur dans son propre dossier, quel que soit le répertoire depuis lequel vous appelez le script. Rendez le script exécutable :
chmod a+x start.sh
Pour que le serveur ne s'arrête pas à la fermeture de la connexion SSH, lancez-le dans une session screen :
screen -S minecraft ./start.sh
Pour vous détacher de la console, appuyez sur Ctrl+A, puis sur D ; le serveur continue de tourner en arrière-plan. Utilisez screen -r minecraft pour revenir à la console et screen -ls pour voir les sessions ouvertes. Pour arrêter le serveur, tapez là encore stop dans la console.
Pour que le serveur démarre tout seul au redémarrage du VDS, en tant qu'utilisateur minecraft, exécutez la commande crontab -e et ajoutez cette ligne :
@reboot screen -dmS minecraft /home/minecraft/server/start.sh
L'option -dm lance la session sans l'attacher à l'écran (détachée) ; vous vous connectez ensuite à la console avec screen -r minecraft.
6. Ouvrez le port 25565/TCP dans le pare-feu
Par défaut, un serveur Minecraft Java écoute sur le port TCP 25565. Sous Windows, dans un PowerShell ouvert en tant qu'administrateur :
New-NetFirewallRule -DisplayName "Minecraft 25565" -Direction Inbound -Protocol TCP -LocalPort 25565 -Action Allow
Si vous utilisez ufw sous Ubuntu, n'activez pas le pare-feu sans avoir autorisé le port SSH ; sinon, votre connexion sera coupée :
sudo ufw allow 22/tcp
sudo ufw allow 25565/tcp
sudo ufw enable
sudo ufw status
Si vous perdez l'accès SSH, vous pouvez vous connecter depuis la console VNC de l'Espace client et corriger la règle. Pour les joueurs Bedrock, les ports de proxy et le test du port depuis l'extérieur, consultez le guide d'ouverture des ports Minecraft.
7. Première connexion, droits d'opérateur et whitelist
Ouvrez Minecraft dans la même version que le serveur, allez dans Multijoueur → Ajouter un serveur et saisissez l'adresse IP du VDS comme adresse du serveur. Si le port est 25565, inutile de l'indiquer ; si vous avez utilisé un autre port, saisissez-le au format IP:port.
Avant de vous connecter, donnez-vous les droits d'administrateur : comme la whitelist est activée par défaut à partir de Minecraft 26.3, vous ne pourriez sinon pas rejoindre le serveur. Tapez ceci dans la console du serveur :
op YourPlayerName
Les opérateurs sont enregistrés dans le fichier ops.json ; le niveau de droits est défini dans server.properties par op-permission-level (4 par défaut, le niveau le plus élevé). Ce niveau couvre toutes les commandes, y compris stop ; ne donnez les droits d'op qu'à des personnes de confiance et tapez deop PlayerName pour les retirer.
À partir de Minecraft 26.3, dans un fichier server.properties nouvellement créé, le réglage white-list est activé par défaut (il est désactivé dans les versions antérieures) ; les joueurs absents de la liste ne peuvent pas se connecter. Les opérateurs peuvent rejoindre le serveur même lorsque la whitelist est activée ; ajoutez vos amis ainsi :
whitelist add FriendName
whitelist list
Si vous voulez ouvrir le serveur à tout le monde, tapez whitelist off ; pour une petite communauté, il est toutefois plus sûr de garder la liste activée.
8. Réglages de base de server.properties
Les réglages se trouvent dans le fichier server.properties du dossier du serveur, et il faut redémarrer le serveur pour que les modifications prennent effet. Pour un petit serveur entre amis, voici les lignes que vous modifierez le plus souvent :
| Réglage | Valeur par défaut | Rôle |
|---|---|---|
motd | A Minecraft Server | La description affichée sous le nom dans la liste des serveurs. |
max-players | 20 | Le nombre maximal de joueurs connectés en même temps. |
online-mode | true | Seuls les joueurs dont le compte Minecraft est vérifié peuvent se connecter. Si vous le passez à false, n'importe qui peut se connecter avec le nom de son choix ; laissez-le activé. |
white-list | true (26.3 et ultérieures) | Active la whitelist ; les joueurs absents de la liste ne peuvent pas se connecter. |
difficulty | easy | Difficulté : peaceful, easy, normal ou hard. |
gamemode | survival | Le mode de jeu des nouveaux joueurs. |
view-distance | 10 | La distance du monde envoyée au joueur (en chunks, c'est-à-dire en morceaux du monde). La réduire allège la charge du serveur et du réseau. |
simulation-distance | 10 | La distance autour du joueur dans laquelle les entités sont mises à jour (en chunks). |
server-port | 25565 | Le port TCP d'écoute. Si vous le changez, mettez aussi à jour la règle du pare-feu. |
server-ip | (vide) | Laissez-le vide ; le serveur écoute alors sur toutes les adresses. |
spawn-protection | 16 | La taille de la zone protégée autour du point d'apparition ; 0 désactive la protection. |
level-seed | (vide) | La graine (seed) du monde. Si elle est vide, elle est choisie au hasard ; elle n'est utilisée qu'à la création d'un nouveau monde. |
Avec Minecraft 1.21.9, les lignes pvp et enable-command-block ont été retirées de ce fichier ; elles se règlent désormais comme règles du jeu (game rules). Ajouter ces lignes tirées d'anciens guides au fichier d'un serveur à jour n'a aucun effet.
9. Faites des sauvegardes
Les sauvegardes automatiques ne sont pas incluses avec les VDS HanHosting ; la sauvegarde de votre monde relève de votre responsabilité. PaperMC recommande qu'une sauvegarde comprenne les dossiers des mondes, les réglages du serveur et des plugins ainsi que les fichiers des plugins, et de conserver plusieurs copies réalisées à différents moments. Le plus simple est d'archiver tout le dossier du serveur.
La méthode la plus sûre consiste à arrêter le serveur avec stop, puis à l'archiver. Utilisez cette méthode sous Windows : le fichier session.lock, que le serveur en cours d'exécution garde verrouillé, peut interrompre l'archivage. Si vous sauvegardez sous Linux pendant que le serveur tourne, suivez cet ordre dans la console :
- Arrêtez l'écriture dans les fichiers du monde avec
save-off. - Écrivez sur le disque tout ce qui est en attente avec
save-all flush; le serveur peut se figer brièvement pendant cette opération. - Créez l'archive avec la commande
tarci-dessous. - Réactivez l'écriture avec
save-on.
Sous Linux, créez une archive datée en tant qu'utilisateur minecraft :
mkdir -p ~/backup
tar -czf ~/backup/minecraft-$(date +%F).tar.gz -C /home/minecraft server
Sous Windows, après avoir arrêté le serveur, avec PowerShell :
New-Item -ItemType Directory -Force C:\backup
Compress-Archive -Path C:\minecraft -DestinationPath "C:\backup\minecraft-$(Get-Date -Format yyyy-MM-dd).zip"
Laisser la sauvegarde sur le même disque ne vous protège ni d'une panne de disque ni d'une réinstallation qui efface le disque. Téléchargez l'archive sur votre propre ordinateur ou envoyez-la par SFTP ou WebDAV vers une destination distincte, comme l'espace de sauvegarde cloud. Pour associer la sauvegarde à une tâche planifiée, consultez le guide Sauvegardes automatiques d'un VDS : restic, cron et Planificateur de tâches.
10. Mettez à jour Paper et les plugins
PaperMC recommande de mettre à jour au moins une fois par semaine et insiste sur le fait qu'aucun fichier JAR (Paper ou plugin) ne doit être remplacé pendant que le serveur tourne. L'ordre indiqué dans le guide officiel de mise à jour est le suivant :
- Faites d'abord une sauvegarde.
- Pour mettre à jour les plugins, créez dans le dossier
pluginsun dossier nomméupdateet placez-y les nouveaux fichiers des plugins ; le serveur les applique au redémarrage suivant. - Téléchargez le nouveau build de Paper depuis la page de téléchargement.
- Arrêtez le serveur avec
stop. - Nommez le nouveau fichier
paper.jaret placez-le à la place de l'ancien. - Démarrez le serveur et vérifiez dans la console l'absence de conflits ou d'erreurs de plugins.
PaperMC ne recommande pas les mises à jour automatiques, en raison du risque de conflits entre plugins. Pour un passage à une version majeure (par ex. de 1.21.x à 26.x), mettez Java à niveau vers la version du tableau et vérifiez que vos plugins prennent en charge la nouvelle version. Si des problèmes apparaissent après l'ouverture du monde dans la nouvelle version, vous ne pourrez revenir à l'ancienne version qu'avec une sauvegarde réalisée avant la mise à niveau.
Erreurs fréquentes
- « You need to agree to the EULA in order to run the server » :
eula.txtne contient paseula=true, ou le script s'exécute depuis un autre dossier. Vérifiez que le script se trouve dans le même dossier quepaper.jar. UnsupportedClassVersionErrorou message indiquant que la version de Java est insuffisante : le Java installé est trop ancien pour cette version de Minecraft. Vérifiez avecjava -versionet installez la version du tableau.- Message sous Windows indiquant que la commande
javan'est pas reconnue : Java n'est pas installé ou n'est pas dans lePATH. Ouvrez une nouvelle invite de commandes après l'installation ; si le problème persiste, définissezJAVA_HOMEetPATH. - « FAILED TO BIND TO PORT » : un autre processus utilise le port 25565 (le plus souvent un deuxième serveur resté en arrière-plan ou une session
screenoubliée), ou une adresse qui n'existe pas sur le serveur a été écrite dans la ligneserver-ip. Vérifiez les sessions ouvertes avecscreen -lset laissez la valeurserver-ipvide. - La connexion expire (timeout) : si le message
Doneest apparu dans la console, le problème vient du réseau ; vérifiez la règle du pare-feu et l'adresse IP saisie. - Message indiquant que vous n'êtes pas sur la whitelist : ajoutez le joueur depuis la console avec
whitelist add, ou donnez-vous les droits d'op. - Avertissement de version incompatible dans la liste des serveurs : les versions du client et du serveur sont différentes. Dans le launcher, choisissez la même version que le serveur.
OutOfMemoryError: la valeur-Xmxest trop basse. Augmentez-la en laissant une marge au système d'exploitation.
Questions fréquentes
Combien de Go de RAM dois-je attribuer au serveur ?
PaperMC recommande au moins 6 à 10 Go, quel que soit le nombre de joueurs ; si vous ne pouvez pas en réserver autant, attribuez-en le plus possible tout en laissant une marge au système d'exploitation. PaperMC recommande de garder la valeur -Xmx environ 1000 à 1500 Mo en dessous de la RAM totale et donne l'exemple de 6500 Mo pour 8 Go ; sous Windows, augmentez la marge, car le système d'exploitation utilise plus de mémoire. Un tableau détaillé se trouve dans le guide Comment allouer de la RAM à un serveur Minecraft : Xms, Xmx et flags d'Aikar.
Plusieurs versions de Java sont installées sur le serveur : laquelle est utilisée ?
La commande java du script exécute le premier Java trouvé dans le PATH. Sous Linux, vous pouvez choisir la version par défaut avec sudo update-alternatives --config java. Sous Windows, le moyen le plus fiable est d'écrire dans start.bat le chemin complet entre guillemets à la place de java, par exemple "C:\Program Files\Amazon Corretto\jdk25.0.4_10\bin\java.exe" ; le nom du dossier dépend de la version installée.
Puis-je installer des mods Forge ou Fabric sur Paper ?
Non. Paper exécute les plugins Bukkit/Spigot/Paper placés dans le dossier plugins ; les mods Forge ou Fabric nécessitent le logiciel serveur propre à ces plateformes. Vous trouverez les options dans le guide Vanilla, Spigot, Paper, Purpur et Folia : lequel choisir ?
Les joueurs Bedrock sur téléphone ou console de jeu peuvent-ils se connecter ?
Ils ne peuvent pas se connecter directement à un serveur Java. En plaçant le plugin Geyser dans le dossier plugins, vous pouvez accepter les connexions Bedrock. Geyser utilise par défaut le port 19132 et, d'après sa propre documentation, ce port doit être ouvert à la fois en TCP et en UDP. Pour admettre des joueurs Bedrock qui n'ont pas de compte Java, on utilise en plus Floodgate.
Dois-je choisir Windows ou Linux ?
Le même fichier Paper et les mêmes réglages fonctionnent sur les deux systèmes. Linux utilise moins de mémoire et se gère en SSH ; Windows peut sembler plus familier avec son interface de bureau. Pour vous aider à choisir, consultez la comparaison Windows ou Linux.
Guides associés
- Vanilla, Spigot, Paper, Purpur et Folia : lequel choisir ?
- Comment allouer de la RAM à un serveur Minecraft : Xms, Xmx et flags d'Aikar
- Comment ouvrir les ports d'un serveur Minecraft (25565, 19132, proxy)
- Windows ou Linux pour un serveur Minecraft ? Une comparaison honnête
- Sauvegardes automatiques d'un VDS : restic, cron et Planificateur de tâches
Pour les autres sujets, parcourez tous les guides Minecraft.
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.