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
| Requirement | Minecraft 1.21.11 | Minecraft 26.2 |
|---|---|---|
| Java | Java 21 or newer (64-bit) | Java 25 or newer (64-bit) |
| Server memory | At least 4 GB for a small SMP or lobby, 8–12 GB for a busy survival server | Same |
| Storage | SSD or NVMe strongly recommended | Same |
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
- Create a new folder just for this server.
- Extract the download into it. You will see
NusaCore.jarandnusa-license.properties. - Leave
nusa-license.propertieswhere 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 --noguiWindows (start.bat):
@echo off
java -Xms6G -Xmx6G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -jar NusaCore.jar --nogui
pauseOn 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
- Run the start script or press Start in your panel.
- For a new purchase, NusaCore lists the Minecraft versions that are available (newest first).
- Type the number of the version you want, then type
YESto confirm. - NusaCore downloads the matching build and the server starts as usual.
- When asked, open
eula.txt, seteula=trueand 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 doctornusa statusshows TPS, MSPT (time per tick), memory use and the active NusaSpigot modules.20.00 TPSmeans the server keeps up comfortably.nusa doctorchecks your installed plugins and tells you if anything needs attention.
Before you open to players
- Make sure
online-mode=trueis set inserver.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
- Moving an existing Paper server? Read Migrating from Paper & updates.
- Learn the everyday tools in Commands & in-game panel.
- Want to know what causes lag? See Lag diagnostics & auto-tune.