/auth
admin

Manage server authentication

Syntax

/auth

Subcommands

/auth cancel

Cancel active login flow

/auth login

Authenticate the server

/auth login.browser

Start OAuth2 browser flow (for local servers)

/auth login.device

Start OAuth2 device flow (for headless/remote servers)

/auth logout

Clear server credentials

/auth persistence

View or change credential storage method

Parameters:

type- Storage type (e.g. Memory, File)
variant- Change credential storage method
/auth select

Select a game profile when multiple are available

Parameters:

profile- Profile number or username to select
variant- Select a profile by number or username
/auth status

Show current authentication status

Server Messages

dump.failed

Failed to dump cert: {message}

refresh

Refreshed: {success}

reload

Reloaded

status.format

=== Server Authentication Status ===\n\

status.connectionMode.authenticated

Authenticated (mTLS + JWT)

status.connectionMode.offline

Offline

status.connectionMode.insecure

Insecure (dev)

status.mode.none

Not authenticated

status.mode.singleplayer

Singleplayer

status.mode.external

External Session

status.mode.oauthBrowser

OAuth Browser

status.mode.oauthDevice

OAuth Device

status.mode.oauthStore

OAuth Store

status.tokenPresent

Present

status.tokenMissing

Missing

status.help

Use '/auth login browser' or '/auth login device' to authenticate.

status.pending

Profile selection pending. Use '/auth select <number>' to choose:

login.singleplayer

Login not available in singleplayer mode. Tokens are provided by the client.

login.alreadyAuthenticated

Server is already authenticated. Use '/auth logout' first.

login.browser.starting

Starting OAuth2 browser flow. Check browser or console for URL.

login.browser.success

Authentication successful! Use '/auth status' to view details.

login.browser.failed

Browser authentication failed. Check server logs.

login.device.starting

Starting OAuth2 device flow. Check console for verification URL.

login.device.success

Authentication successful! Use '/auth status' to view details.

login.device.failed

Device authentication failed. Check server logs.

login.pending

Multiple profiles available. Use '/auth select <number>' to choose:

logout.singleplayer

Logout not available in singleplayer mode.

logout.notAuthenticated

Server is not currently authenticated.

logout.success

Server logged out. Previous mode: {previousMode}

select.noPending

No profile selection pending. Run '/auth login' first.

select.invalidSelection

Invalid selection. Use a valid profile number or username.

select.success

Profile selected! Use '/auth status' to view details.

select.failed

Failed to complete authentication with selected profile.

select.availableProfiles

Available profiles:

select.usage

Use '/auth select <number>' or '/auth select <username>'

select.profileItem

[{index, number}] {username} ({uuid})

cancel.singleplayer

Not applicable in singleplayer mode.

cancel.success

Active login flow cancelled.

cancel.nothing

No active login flow to cancel.

persistence.singleplayer

Not applicable in singleplayer mode.

persistence.current

Credential storage: {type}

persistence.changed

Credential storage changed to: {type}

persistence.unknownType

Unknown storage type: {type}

persistence.available

Available types: {types}

login.persistence.memory

WARNING: Credentials stored in memory only - they will be lost on restart!\n\

login.persistence.saved

Credentials saved using: {type}

Related Commands

/ban

Ban a player

/kick

Kick a player

/maxplayers

Set the max player count

/op

Commands for managing operator permissions

/plugin

Plugin management commands

Back to all commands