PowerNukkitX (PNX) est un logiciel serveur Bedrock open source (licence LGPL-3.0), écrit en Java. Contrairement au serveur officiel, il accepte des plugins. La version 3.0.6, publiée le 28 octobre 2026, vise Minecraft 1.26.60 (protocole 2225).

Quelle version de Java installer ?

Les sources se contredisent aujourd’hui, et ce point cause des échecs au lancement : la documentation de PNX indique Java 21 ou plus, tandis que le code du projet cible désormais Java 25. Installez donc Java 25 en 64 bits : vous couvrez ainsi les deux cas.

Prévoyez au minimum 2 cœurs et 2 Go de RAM d’après la documentation, et 4 Go ou plus dès que le serveur accueille régulièrement des joueurs.

Étape 1 : installer Java 25

Sous Ubuntu ou Debian, installez le paquet si votre distribution le propose. Sinon, utilisez une distribution OpenJDK comme Eclipse Temurin.

sudo apt update
sudo apt install -y openjdk-25-jre-headless
java -version

La dernière commande doit afficher une version 25.

Étape 2 : préparer le dossier

Comme pour tout serveur exposé sur Internet, utilisez un compte sans privilèges :

sudo useradd --system --user-group --home-dir /opt/pnx-server --create-home minecraft
sudo -u minecraft -s
cd /opt/pnx-server

Étape 3 : télécharger le jar

Le fichier se trouve dans les versions publiées sur GitHub :

wget https://github.com/PowerNukkitX/PowerNukkitX/releases/latest/download/powernukkitx.jar

Étape 4 : créer le script de lancement

Créez un fichier start.sh. Les options --add-opens sont demandées par le projet, et -Xmx fixe la mémoire maximale :

#!/bin/sh
exec java -Xms2G -Xmx2G \
  --add-opens java.base/java.lang=ALL-UNNAMED \
  --add-opens java.base/java.io=ALL-UNNAMED \
  -jar powernukkitx.jar

Rendez-le exécutable, puis lancez-le :

chmod +x start.sh
./start.sh

Le premier démarrage génère le monde et les fichiers de configuration. Sous Windows, créez un start.bat avec les mêmes options.

Étape 5 : régler pnx.yml

PNX ne se configure pas avec le server.properties de BDS : ses réglages sont regroupés dans pnx.yml, à la racine du dossier. Arrêtez impérativement le serveur avant de le modifier, car PNX réécrit ce fichier à la fermeture et écraserait vos changements. Voici les principales valeurs sous baseSettings :

Clé	Valeur par défaut	Rôle
`port`	19132	Port du serveur
`maxPlayers`	20	Nombre maximum de joueurs
`defaultLevelName`	world	Dossier du monde par défaut
`allowList`	false	Active la liste blanche (`white-list.txt`)
`motd`	PowerNukkitX Server	Nom affiché dans le jeu

Étape 6 : ajouter un plugin

Déposez le fichier .jar du plugin dans le dossier plugins, puis redémarrez. Vérifiez que le plugin vise bien PNX : un plugin conçu pour Paper ou Spigot ne fonctionnera pas.

Optimiser la mémoire

Sur un serveur récent disposant d’assez de RAM, le ramasse-miettes ZGC limite les micro-coupures. Ajoutez -XX:+UseZGC à la commande de lancement, puis observez le résultat, et n’allouez pas toute la RAM de la machine au serveur.

Problèmes fréquents

UnsupportedClassVersionError au lancement. Java est trop ancien : vérifiez java -version. Il se peut aussi que plusieurs versions de Java soient installées et que la mauvaise soit utilisée.

Mes changements dans pnx.yml disparaissent. Vous avez modifié le fichier pendant que le serveur tournait. Arrêtez-le d’abord.

Les joueurs voient une erreur de version. PNX doit prendre en charge la version de leur client : mettez à jour le jar après chaque nouvelle version de Minecraft, dès qu’une version compatible est publiée.

Personne ne peut se connecter de l’extérieur. Consultez le guide des ports. La documentation de PNX parle encore d’UDP, mais les clients récents utilisent NetherNet : ouvrez 19132 en TCP et en UDP, puis testez avec un client à jour.

Installer PowerNukkitX : Java, lancement et configuration