Skip to main content

Nightbreak Account Linking and Tokens

Nightbreak-managed content downloads now use a shared token flow through MagmaCore.

How It Works​

  1. Open your Nightbreak account page.
  2. Generate or copy your server token.
  3. Run:
/nightbreaklogin <token>

Once that succeeds, compatible MagmaGuy plugins on the same server can use the shared token for Nightbreak access checks and downloads.

The shared permission registered by MagmaCore for this command is nightbreak.login, which defaults to server operators unless a server admin changes it.

Where The Token Lives​

The token is stored in:

plugins/MagmaCore/nightbreak.yml

under the token key, not inside each plugin's private folder.

That means:

  • you do not need to register the token separately for every plugin
  • reinstalling one plugin does not necessarily lose the token
  • deleting the shared MagmaCore config may require you to register the token again

What The Token Unlocks​

A linked token is used for:

  • checking whether the server account can access a content package
  • checking remote version metadata for managed packages
  • downloading content directly into plugin import folders
  • detecting whether installed packages are out of date
  • enabling Nightbreak-aware setup-menu states

It does not bypass plugin-specific requirements such as:

  • installing a resource pack
  • enabling a content package in the setup menu
  • keeping dependencies installed

Security Notes​

  • Treat the token like a server credential.
  • Do not post it in public chat, screenshots, or support logs.
  • If you think it has leaked, revoke it from the Nightbreak account page and generate a new one.
  • MagmaCore warns if the token does not look like a Nightbreak token prefix, but it still attempts to save it.

Troubleshooting​

"No token registered"​

The plugin is not seeing a valid shared Nightbreak token yet. Run /nightbreaklogin <token> again and confirm that plugins/MagmaCore/nightbreak.yml now contains a real token instead of a missing or placeholder value.

"You don't have access to this content"​

The token is valid, but the linked Nightbreak account does not currently unlock that package.

One plugin works, another does not​

Check the plugin-specific setup page. Some plugins still need:

  • a first-time setup menu completed
  • a reload after imports
  • a resource pack installation step
  • an optional dependency such as FreeMinecraftModels or ResourcePackManager