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

  1. Install. Put NusaCore.jar and 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
  2. Choose your version. On the first start, NusaCore asks which Minecraft version you want and downloads the right build. NusaCore & license
  3. Check health. Run nusa status and nusa doctor in 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 lagchunks points 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 doWhere to go
Install and start for the first timeQuick start & installation
Understand the license and version choiceNusaCore & license
Learn every /nusa commandCommands & in-game panel
Find out what causes lagLag diagnostics & auto-tune
Generate the map before openingWorld pre-generation
Back up and restore worldsWorld backups
Pick a ready-made profileConfiguration guide
Look up any setting in nusa-global.ymlConfiguration reference
Fix a problemTroubleshooting & 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.

Nusa product documentation · NusaSpigotPaper fork · Java 21 / 25

Loading the index…