Meet NusaSpigot
What NusaSpigot is, who it is for, and the three steps to get your server running.
On this page
NusaSpigot is a Minecraft server engine built on Paper. It keeps your server smooth, protected and easy to watch, without forcing you to learn complicated configs or give up your favourite plugins.
If you have run Paper or Spigot before, everything will feel familiar: your worlds, folder layout, gameplay rules and plugins carry over.
Who it is for
- Survival and SMP servers that slow down at peak hours because of farms, hoppers and exploration.
- Lobbies and hubs with many players in one place.
- Cross-play servers where Bedrock players join through Geyser and Floodgate.
- Owners who want answers, not guesswork, when someone says "the server is lagging".
Get running in three steps
- Install. Put
NusaCore.jarand your license file in a server folder and start it with Java 21 (Minecraft 1.21.11) or Java 25 (Minecraft 26.2). Quick start & installation - Choose your version. On the first start, NusaCore asks which Minecraft version you want and downloads the right build. NusaCore & license
- Check health. Run
nusa statusandnusa doctorin the console. Commands & in-game panel
Moving an existing Paper server? Start with Migrating from Paper & updates.
What NusaSpigot gives your server
- Your plugins keep working. World, entity and block changes always happen on one real main thread, just as Bukkit, Spigot and Paper plugins expect. Heavy background work such as chunk disk I/O, region compression and player saves runs on separate worker threads.
- Smoother at peak hours. Hopper and furnace idling, distant mob scaling, lighter redstone and crowded-lobby packet sharing are on by default with safe values.
- Comfort for Bedrock players. Geyser and Floodgate players are recognised automatically, with fewer stair and slab setbacks and paced chunks and particles for phones.
- Protection before trouble hits. Oversized NBT items, packet floods and runaway redstone clocks are caught before they stall the server.
- Clear answers about lag.
/nusa lagchunkspoints at the exact chunk or plugin, and staff get alerts in chat when a spike starts and ends. - Safe worlds. Scheduled world backups to a local folder and your own S3 storage, with a restore that never touches a running world.
Find your way around
| What you want to do | Where to go |
|---|---|
| Install and start for the first time | Quick start & installation |
| Understand the license and version choice | NusaCore & license |
Learn every /nusa command | Commands & in-game panel |
| Find out what causes lag | Lag diagnostics & auto-tune |
| Generate the map before opening | World pre-generation |
| Back up and restore worlds | World backups |
| Pick a ready-made profile | Configuration guide |
Look up any setting in nusa-global.yml | Configuration reference |
| Fix a problem | Troubleshooting & FAQ |
A calm approach to tuning
You do not need to change dozens of numbers on day one. Start with the defaults and watch how your community plays. When you do customise nusa-global.yml, change one thing at a time and do a full restart, so your worlds stay safe and predictable.