Nukkit Installation

  • Views Views: 34,533
  • Last updated Last updated:
  • Nukkit is nuclear-powered server software for Minecraft: Pocket Edition. It has a few key advantages over other server software:
    • Written in Java, Nukkit is faster and more stable.
    • Having a friendly structure, it's easy to contribute to Nukkit's development and rewrite plugins from other platforms into Nukkit plugins.


    1. Java 8 or above [Windows, Ubuntu, CentOS, OS X]
    2. The server jar, which can be found on our Jenkins:
    3. The Nukkit server jar file copied to a new directory dedicated to your server



    1. Paste the following text into a text document. Save it as start.bat in the same directory as nukkit-1.0-SNAPSHOT.jar:
    2. Code:
      @echo off
      java -Xms1G -Xmx1G -jar nukkit-1.0-SNAPSHOT.jar
    3. Double click the batch file.


    1. Create a new startup script ( in the server directory to launch the JAR:

      java -Xms1G -Xmx1G -jar nukkit-1.0-SNAPSHOT.jar
    2. Open your terminal and execute the following in the directory:
      chmod +x
    3. Run your start up script:
    4. Bash:

    Mac OS X

    1. Create a new startup script (start.command) to launch the JAR in the server directory:

      cd "$( dirname "$0" )"
      java -Xms512M -Xmx1G -jar nukkit-1.0-SNAPSHOT.jar
    2. Open Terminal and type into it: (Don't hit enter!)
      chmod a+x
    3. Drag your startup script file into the Terminal window. (Be sure to put a space between chmod a+x and your startup script!)
    4. Double click your startup script.


    Depending on your Minecraft host's configuration, you will have two ways to enable the use of Nukkit through Multicraft.

    • If there's already an option for Nukkit in the JAR file selection menu, you can simply select it and restart your server upon save. However, this may not be recommended if your host does not keep up to date with the latest Nukkit builds.
    • If you have access to upload custom server JARs (FTP), download the Nukkit JAR and enter in the name of the file via the JAR file input box located on the index of the panel. Some hosts may require you to rename your JAR to a specific name (like custom.jar) and then select it from the dropdown menu.


    After the nukkit-1.0-SNAPSHOT.jar has been run the first time, folders and config files will be created. You will need to edit these config files to have the server work properly in your environment.
    For information on:

    If the server is working incorrectly, be sure you have port forwarded and you have followed the steps closely. If you are having issues, you can create a help thread in the Nukkit forum or come chat to us on Discord.


    Check out our Resources section or to find a wide variety of plugins. If you cannot find what you are looking for, Pokkit offers limited compatibility with Spigot plugins.

    You can add your plugins by dropping the JAR file into your plugins folder in your server directory and restarting the server. If it does not work or if you see errors seek help on the Nukkit Forums or Discord.
  • Loading…