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
- Reads
nusacore.properties(created automatically on the first start). - Finds your license key (the order is in the next section).
- Asks which build your license is entitled to, and downloads it if it is not cached yet.
- Keeps the verified build in the
cache/nusacore/folder. - 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:
| Order | Place | When to use it |
|---|---|---|
| 1 | Environment variable NUSACORE_KEY | Hosting panels that support environment variables |
| 2 | Environment variable NUSA_LICENSE_KEY | Same as above |
| 3 | The nusa-license.properties file | The 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
- Open
nusacore.properties. - Change
renew-license-input=falsetorenew-license-input=true. - Start the server. NusaCore asks for the new key in the console.
- Once the key is saved, the option switches back to
falseby itself.
Choosing the Minecraft version
New buyers choose their Minecraft version once, on the first start:
- NusaCore lists the versions that have a release, newest first.
- Type the number of a version, then type
YESto confirm. - 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=trueWithout 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.
| Option | Environment variable | Default | What it does |
|---|---|---|---|
server-version | NUSACORE_VERSION | empty | The Minecraft version you want. Empty keeps the version the server already runs, or the newest version your license includes |
confirm-version-choice | NUSACORE_CONFIRM_VERSION_CHOICE | false | Together with server-version, chooses the version for a new license without a console prompt |
auto-update | NUSACORE_AUTO_UPDATE | true | false boots the cached build without checking for updates |
renew-license-input | – | false | Asks for a new license key on the next start |
fallback-jar | NUSACORE_FALLBACK_JAR | empty | A local server JAR used when nothing can be downloaded and the cache is empty |
debug | NUSACORE_DEBUG | false | More 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-jarif 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
- Not installed yet? Follow Quick start & installation.
- License trouble on start? See Troubleshooting & FAQ.