Manual Installation of PowerNukkitX for Windows

The following steps are for Windows.

Create a Folder for PowerNukkitX

Create a folder for PowerNukkitX, for example, server.

Navigate to the Folder

Open the folder you created (e.g. server).

Download the PowerNukkitX server

Download the PowerNukkitX and place it inside the server folder.

Create a Startup File

Create a file named start.bat inside the server folder with the following content:

java -Dfile.encoding=UTF-8 ^
    -Djansi.passthrough=true ^
    -Dterminal.ansi=true ^
    -XX:+UseZGC ^
    -XX:+ZGenerational ^
    -XX:+UseStringDeduplication ^
    --add-opens java.base/java.lang=ALL-UNNAMED ^
    --add-opens java.base/java.io=ALL-UNNAMED ^
    --add-opens java.base/java.net=ALL-UNNAMED ^
    -jar powernukkitx-shaded.jar

Initial Folder Structure

Your folder should now look like this:

powernukkitx-shaded.jar
start.bat

Start the Server

Double-click on start.bat to start the server.

Select your server language. After selected, it will start automatically.

After starting, the folder structure will automatically expand to something like this:

pnx.yml
powernukkitx-shaded.jar
start.bat

Your Server is Now Online

You can now connect to your server using your server's IP address and the default port 19132.

🚫

Warning: Some people may not be able to connect to their server using the local IP 127.0.0.1.
If this happens, try connecting with your LAN IP (for example 192.168.x.x).

Do NOT use localhost for IP address.

On Windows 10 and Windows 11, Minecraft for Windows (UWP) blocks loopback to 127.0.0.1 by default.
To allow it, open PowerShell as Administrator and run:

CheckNetIsolation LoopbackExempt -a -n=Microsoft.MinecraftUWP_8wekyb3d8bbwe

(You can undo it with CheckNetIsolation LoopbackExempt -d -n=Microsoft.MinecraftUWP_8wekyb3d8bbwe.)

Since Minecraft changed their game platform to UWP from GDK this method will not work for 1.21.120 and after versions.

Requirements Linux