MagmaCore/com.magmaguy.magmacore.nightbreak/NightbreakAccount

NightbreakAccount

Manages the Nightbreak account token and provides access to the Nightbreak DLC API.

API Base URL: https://nightbreak.io

Endpoints: - GET /server/dlc/:slug/version - Get DLC version info (no auth required) - GET /server/dlc/:slug/access - Check if user has access (auth required) - GET /server/dlc/:slug/download - Download DLC file (auth required)

Types

AccessInfo

public class AccessInfo

Contains access information for a DLC.

DownloadProgressCallback

public interface DownloadProgressCallback

Callback interface for download progress updates.

PluginChangelog

public final class PluginChangelog extends Record

PluginDownloadResult

public class PluginDownloadResult

TokenChangeListenerRegistration

public interface TokenChangeListenerRegistration implements AutoCloseable

VersionInfo

public class VersionInfo

Contains version information for a DLC.

Properties

instance

public static volatile NightbreakAccount instance

lastAuthFailureBody

public static volatile String lastAuthFailureBody

lastAuthFailureStatus

public static volatile int lastAuthFailureStatus

token

public String token

Functions

addTokenChangeListener

public static void addTokenChangeListener(Runnable listener)

Legacy non-removable listener registration.

checkAccess

public NightbreakAccount.AccessInfo checkAccess(String slug)

Checks if the user has access to a DLC.

checkPluginAccess

public NightbreakAccount.AccessInfo checkPluginAccess(String slug)

clearToken

public static boolean clearToken(JavaPlugin plugin)

Removes the shared Nightbreak token from disk and this shaded classloader.

download

public boolean download(String slug, File destinationFile)

Downloads a DLC file.

public boolean download(String slug, File destinationFile, String version)

Downloads a specific version of a DLC file.

public boolean download(String slug, File destinationFile, String version, NightbreakAccount.DownloadProgressCallback progressCallback)

Downloads a DLC file with progress updates.

downloadPlugin

public boolean downloadPlugin(String slug, File destinationFile, NightbreakAccount.DownloadProgressCallback progressCallback)

downloadPluginUpdate

public NightbreakAccount.PluginDownloadResult downloadPluginUpdate(String slug, File destinationFile, NightbreakAccount.DownloadProgressCallback progressCallback)

getAllVersions

public Map<String, NightbreakAccount.VersionInfo> getAllVersions()

Gets version info for all available DLC from the Nightbreak API.

getInstance

public static NightbreakAccount getInstance()

Returns the singleton, re-reading from disk if another plugin's shaded copy wrote a new token since the last access.

getLastAuthFailureBody

public static String getLastAuthFailureBody()

getLastAuthFailureStatus

public static int getLastAuthFailureStatus()

getPluginVersion

public NightbreakAccount.VersionInfo getPluginVersion(String slug)

getPublicDlcChangelogs

public static List<NightbreakAccount.PluginChangelog> getPublicDlcChangelogs(String slug, boolean logFailures)

Public DLC release history; this endpoint intentionally requires no account token.

getPublicDlcVersion

public static NightbreakAccount.VersionInfo getPublicDlcVersion(String slug, boolean logFailures)

getPublicPluginChangelogs

public static List<NightbreakAccount.PluginChangelog> getPublicPluginChangelogs(String slug, boolean logFailures)

Fetches the public release history uploaded by the Nightbreak release pipeline.

getPublicPluginVersion

public static NightbreakAccount.VersionInfo getPublicPluginVersion(String slug)

public static NightbreakAccount.VersionInfo getPublicPluginVersion(String slug, boolean logFailures)

getToken

public String getToken()

getVersion

public NightbreakAccount.VersionInfo getVersion(String slug)

Gets the latest version info for a DLC.

hasAuthFailure

public static boolean hasAuthFailure()

Returns true after Nightbreak rejects the current token with 401/403.

hasToken

public static boolean hasToken()

Checks if a token is currently registered.

initialize

public static NightbreakAccount initialize(JavaPlugin plugin)

Initializes the NightbreakAccount by loading the token from the shared config folder.

registerToken

public static NightbreakAccount registerToken(JavaPlugin plugin, String token)

Registers a new token by saving it to the shared config file.

registerTokenChangeListener

public static NightbreakAccount.TokenChangeListenerRegistration registerTokenChangeListener(Runnable listener)

Registers a removable listener for every actual credential change: login, token replacement, or logout.

resetAuthFailureSuppression

public static void resetAuthFailureSuppression()

Re-enables auth-failure logging.