NusaCore & license

How the NusaCore loader works, where your license key lives, choosing your Minecraft version and every option in nusacore.properties.

On this page

NusaCore is the only file you start: java -jar NusaCore.jar --nogui. Your license decides which Minecraft version and which NusaSpigot build are loaded, so there is no separate installer per version.

What NusaCore does on start

  1. Reads nusacore.properties (created automatically on the first start).
  2. Finds your license key (the order is in the next section).
  3. Asks which build your license is entitled to, and downloads it if it is not cached yet.
  4. Keeps the verified build in the cache/nusacore/ folder.
  5. Starts the NusaSpigot server. From here on everything runs like a normal Paper server.

That makes updating easy: just restart the server. When a new release exists for your version, NusaCore downloads it by itself.

Where the license key lives

NusaCore looks for your license key in this order and uses the first one it finds:

OrderPlaceWhen to use it
1Environment variable NUSACORE_KEYHosting panels that support environment variables
2Environment variable NUSA_LICENSE_KEYSame as above
3The nusa-license.properties fileThe standard way. It is already filled in in the BuiltByBit download

If there is no key at all, the console shows Put Your License Key Here :. Paste your license key, press Enter, and NusaCore saves it to nusa-license.properties.

Changing the license key

  1. Open nusacore.properties.
  2. Change renew-license-input=false to renew-license-input=true.
  3. Start the server. NusaCore asks for the new key in the console.
  4. Once the key is saved, the option switches back to false by itself.

Choosing the Minecraft version

New buyers choose their Minecraft version once, on the first start:

  1. NusaCore lists the versions that have a release, newest first.
  2. Type the number of a version, then type YES to confirm.
  3. The license is locked to that version and NusaCore downloads its build.

Hosting panels without console input can choose the version in a file. Put these two lines in nusacore.properties, then start the server:

server-version=1.21.11
confirm-version-choice=true

Without confirm-version-choice=true, server-version is only a preference and never locks the license.

nusacore.properties options

Every option can also be set with an environment variable. When both are set, the environment variable wins.

OptionEnvironment variableDefaultWhat it does
server-versionNUSACORE_VERSIONemptyThe Minecraft version you want. Empty keeps the version the server already runs, or the newest version your license includes
confirm-version-choiceNUSACORE_CONFIRM_VERSION_CHOICEfalseTogether with server-version, chooses the version for a new license without a console prompt
auto-updateNUSACORE_AUTO_UPDATEtruefalse boots the cached build without checking for updates
renew-license-input–falseAsks for a new license key on the next start
fallback-jarNUSACORE_FALLBACK_JARemptyA local server JAR used when nothing can be downloaded and the cache is empty
debugNUSACORE_DEBUGfalseMore detailed loader logging for troubleshooting. The license key is never printed

When the internet or the license service has trouble

  • If the release service cannot be reached, NusaCore uses the last verified build in its cache, then fallback-jar if the cache is empty.
  • If the license is refused (revoked, expired, wrong product, or the version is not included), NusaCore does not fall back to the cache. Read the console message and contact support.
  • With auto-update=false, NusaCore never contacts the release service, so it also cannot ask you to choose a version.

Next steps

Nusa product documentation · NusaSpigotPaper fork · Java 21 / 25

Loading the index…