Installer un serveur Minecraft sur Debian ou Ubuntu (Paper)

Vous souhaitez héberger votre propre serveur Minecraft sur votre serveur root Linux sous Debian ou Ubuntu ? Vous êtes au bon endroit. Dans ce tutoriel, nous installons pas à pas un serveur Paper (compatible avec les plugins Spigot et Bukkit) depuis la console SSH.

Toutes les commandes sont prévues pour Debian 13, Debian 12 et Ubuntu 24.04 LTS. Les systèmes plus anciens comme Debian 10 ou Ubuntu 20.04 ont déjà atteint leur fin de support et ne reçoivent plus de mises à jour de sécurité. Sur un serveur accessible depuis Internet, il ne faut plus utiliser ces versions.

Prérequis pour votre propre serveur Minecraft

• Un serveur root ou un VPS sous Debian 13, Debian 12 ou Ubuntu 24.04 LTS
• Un accès root via SSH
• Au moins 2 GB de RAM rien que pour le serveur Minecraft, davantage avec des plugins ou beaucoup de joueurs
• Le port TCP 25565 ouvert, le port par défaut de Minecraft Java Edition

Mettre à jour la liste des paquets et installer les mises à jour

Avant de commencer, actualisez la liste des paquets de votre système d'exploitation et installez toutes les mises à jour disponibles. Une seule commande suffit :

apt update && apt upgrade -y

Quelle version de Java faut-il pour votre serveur Minecraft ?

Minecraft exige une version de Java différente selon la version du serveur. Si le serveur démarre avec une version de Java trop ancienne, il s'arrête aussitôt sur un message d'erreur, le plus souvent en signalant une version de classe non prise en charge. Pour la Java Edition, la correspondance est la suivante :

• Minecraft 1.20.5 et plus récent : Java 21
• Minecraft 1.18 à 1.20.4 : Java 17
• Minecraft 1.17 : Java 16
• Minecraft 1.16.5 et plus ancien : Java 8

Les versions actuelles du serveur exigent donc Java 21. En cas de doute, installez Java 21 : une version de Java plus récente sait en général démarrer aussi les builds Minecraft plus anciens.

Installer Java 21 sur Debian 13 et Ubuntu 24.04 LTS

Les deux systèmes fournissent Java 21 directement dans leurs propres dépôts :

apt install openjdk-21-jre-headless -y

Sous Debian 12, le dépôt standard ne contient que Java 17. Notre tutoriel dédié Installer Java 21 sur Debian explique comment y obtenir malgré tout Java 21.

Java 17 pour les anciennes versions de Minecraft

Si vous exploitez volontairement une version de serveur plus ancienne, entre 1.18 et 1.20.4, installez plutôt Java 17 :

apt install openjdk-17-jre-headless -y

D'autres méthodes d'installation sont décrites dans notre tutoriel Installer Java 17 sur Debian.

Vérifier l'installation de Java

Vérifiez ensuite quelle version de Java est réellement active :

java -version

La sortie doit indiquer la version majeure souhaitée, par exemple « openjdk version 21 ». Si une autre version apparaît, c'est qu'une seconde installation de Java est encore définie par défaut.

Installer screen pour que le serveur tourne en permanence

Sans outil complémentaire, le serveur Minecraft s'arrêterait dès que vous fermez votre session SSH. Le paquet « screen » maintient le processus en vie dans une session distincte :

apt install screen -y

Créer un utilisateur dédié au serveur Minecraft

N'exécutez jamais le serveur en tant que root. Créez plutôt un utilisateur dédié. C'est surtout important si d'autres applications tournent sur la même machine, car un plugin compromis n'atteint alors pas l'ensemble du système.

adduser --disabled-login spigot

L'option --disabled-login désactive la connexion directe via SSH pour cet utilisateur. Les questions sur le nom, l'adresse ou le numéro de téléphone se sautent avec la touche Entrée.

Passez maintenant sur le nouvel utilisateur et dans son répertoire personnel :

su spigot && cd

Créez-y un répertoire pour le serveur (« server » dans l'exemple) et entrez dedans :

mkdir server && cd server/

Choisir et télécharger une version de Paper

La version de Paper souhaitée se trouve sur la page de téléchargement officielle : https://papermc.io/downloads. Le sélecteur de version y donne également accès aux builds plus anciens.

Copiez le lien de téléchargement (clic droit sur le bouton du build, puis « Copier l'adresse du lien »), revenez dans la console SSH et téléchargez le fichier avec wget. Cela ressemble alors à ceci :

#CECI N'EST QU'UN LIEN D'EXEMPLE, UTILISEZ LE LIEN ACTUEL DE PAPERMC.IO !

wget https://api.papermc.io/v2/projects/paper/versions/1.20.1/builds/45/downloads/paper-1.20.1-45.jar

Renommez ensuite le fichier téléchargé en « spigot.jar », afin que le script de démarrage puisse toujours utiliser le même nom de fichier. Lors d'un changement de version ultérieur, il suffira de remplacer ce fichier :

mv paper*.jar spigot.jar

Créer le script de démarrage et accepter l'EULA

Créez un fichier « start.sh » :

nano start.sh

Saisissez le contenu suivant. Dans l'exemple, le serveur reçoit 4 GB de RAM ; ajustez cette valeur à votre machine via -Xmx :

screen -AmdS spigot java -Xmx4G -jar spigot.jar

Enregistrez le fichier avec « CTRL + X », puis « Y » et « Entrée ».

Rendez ensuite le script exécutable et acceptez le contrat de licence utilisateur final de Minecraft. Sans acceptation de l'EULA, aucun serveur Minecraft ne démarre :

chmod +x start.sh && echo "eula = true" > eula.txt

Démarrer le serveur Minecraft et utiliser la console

Démarrez maintenant le serveur :

./start.sh

Le premier démarrage prend un peu plus de temps, car le monde est généré et les fichiers de configuration sont créés.

« CTRL + A + D » vous fait quitter la console du serveur sans arrêter celui-ci. Vous pouvez y revenir à tout moment avec :

screen -r spigot

Important : la session screen appartient à l'utilisateur « spigot ». Connectez-vous donc d'abord avec su spigot avant d'appeler screen -r.

Les étapes suivantes après l'installation

Le serveur tourne, l'installation de base est donc terminée. Deux points méritent d'être traités dans la foulée :

• Démarrage automatique : pour que le serveur redémarre de lui-même après un redémarrage du système d'exploitation, mettez en place une unité de service systemd. Notre tutoriel Démarrer un serveur Minecraft automatiquement décrit la procédure complète.
• Configuration : le fichier « server.properties » définit entre autres le mode de jeu, la difficulté, le nombre maximal de joueurs et le port. Après chaque modification, un redémarrage du serveur est nécessaire.