Quick start & installation

Set up Java, run NusaCore, choose your Minecraft version and confirm the server is healthy. About ten minutes.

On this page

This page takes you from the download to a running NusaSpigot server that players can join. The folder layout is the same as Paper, so if you have set up Paper before, the steps will feel familiar.

What you need

RequirementMinecraft 1.21.11Minecraft 26.2
JavaJava 21 or newer (64-bit)Java 25 or newer (64-bit)
Server memoryAt least 4 GB for a small SMP or lobby, 8–12 GB for a busy survival serverSame
StorageSSD or NVMe strongly recommendedSame

Check your Java version with java -version. On Pterodactyl, pick the Java 21 Docker image (or Java 25 for 26.2).

1. Prepare the server folder

  1. Create a new folder just for this server.
  2. Extract the download into it. You will see NusaCore.jar and nusa-license.properties.
  3. Leave nusa-license.properties where it is. It already holds your license, so there is nothing to copy and paste.

2. Create a start script

Use the same value for -Xms and -Xmx so memory does not resize while people play. Replace 6G with the memory you have available.

Linux / macOS (start.sh):

#!/usr/bin/env bash
java -Xms6G -Xmx6G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -jar NusaCore.jar --nogui

Windows (start.bat):

@echo off
java -Xms6G -Xmx6G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -jar NusaCore.jar --nogui
pause

On Pterodactyl or another hosting panel, upload the download's contents, set the Startup JAR variable to NusaCore.jar and select the matching Java version.

3. First start: choose your Minecraft version

  1. Run the start script or press Start in your panel.
  2. For a new purchase, NusaCore lists the Minecraft versions that are available (newest first).
  3. Type the number of the version you want, then type YES to confirm.
  4. NusaCore downloads the matching build and the server starts as usual.
  5. When asked, open eula.txt, set eula=true and start again.

No console input on your panel? NusaCore & license shows how to choose the version in a file instead.

4. Check that the server is healthy

When the console prints Done, NusaSpigot prints one startup summary: license, profile, cloud, panel, engine, plugins and security. Then run these two commands in the console:

nusa status
nusa doctor
  • nusa status shows TPS, MSPT (time per tick), memory use and the active NusaSpigot modules. 20.00 TPS means the server keeps up comfortably.
  • nusa doctor checks your installed plugins and tells you if anything needs attention.

Before you open to players

  • Make sure online-mode=true is set in server.properties, or configure proxy forwarding properly if the server sits behind Velocity.
  • Generate the area around spawn in advance with world pre-generation, for example nusa pregen 64 world, so the first players do not keep the server busy generating terrain.
  • Set up regular backups. NusaSpigot includes built-in world backups you can schedule.

Next steps

Nusa product documentation · NusaSpigotPaper fork · Java 21 / 25

Loading the index…