Installation

Get your PowerNukkitX server up and running on your preferred operating system.

Requirements

Before we begin, make sure you have the following:

Java 21 or later (Required)
PowerNukkitX JAR file (The server core)

Windows

Follow these steps to set up your server on Windows:

Download the Server

Create a new folder on your computer. You can name this folder anything you like, but for example, name it pnx-server.Then, move the downloaded PowerNukkitX.jar file into this folder.

Create Startup Script

You can create the script manually or download it.

Option 1: Download Script Download start.bat (click on Start.bat and download it.")

Option 2: Create Manually In the same folder, create a new file named start.bat. Right-click it and select Edit, then paste the following code:

Run the Server

Double-click start.bat to launch your server. You will see the console output as the server starts.

Linux

For Linux users (Ubuntu, Debian, CentOS, etc.), here is the detailed manual installation process:

Install Java

Ensure Java 21 is installed. You can check by running java -version in the terminal. If not installed, use your package manager (e.g., sudo apt install openjdk-21-jre).

Create a Folder for PowerNukkitX

Create a folder for PowerNukkitX, for example, server:

Navigate to the Folder

Navigate to the folder you created:

Download the ZIP Archive

Download the powernukkitx-run.zip archive with the following command:

Extract the Archive

Extract the contents of the ZIP archive into the folder you created:

Now run this command to remove unnecessary files:

Download the start.sh File

Download the start.sh startup file with this command:

Grant Execution Permissions

Grant execution permissions to the startup file:

Start the Server

Execute the startup file:

After starting, your folder structure will expand to look like this:

command_data
libs
logs
players
plugins
worlds
start.sh
powernukkitx.jar

Your Server is Now Online. You can now connect to your server using your server's IP address and the default port 19132.

Join Locally

You can connect to your own server using the generic local IP address.

Open Minecraft

Open Minecraft Bedrock Edition.

Go to Servers

Navigate to Play > Servers.

Add Server

Click on the Add Server button.

Enter Details

Fill in the server information:

Server Name: Localhost
Server Address: 127.0.0.1
Port: 19132 (Default)

Save and Join

Click Save, find the server in the list, and join it.

🚫 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.
How to find LAN IP (Windows): Open Command Prompt and type ipconfig. Look for "IPv4 Address".