Skip to main content
This page provides detailed syntax, descriptions, examples, and permission requirements for every command.

​
Toggle Commands

​
/maintenance on

Enables maintenance mode. Syntax: 
/maintenance on [server]
Arguments:
  • server (optional, proxy only) - Specific backend server name
Examples: 
# Enable global maintenance
/maintenance on

# Enable maintenance on specific server (proxy only)
/maintenance on lobby
/maintenance on survival
Permission: maintenance.toggle (global) or maintenance.singleserver.toggle (specific server) Aliases: None

​
/maintenance off

Disables maintenance mode. Syntax: 
/maintenance off [server]
Arguments:
  • server (optional, proxy only) - Specific backend server name
Examples: 
# Disable global maintenance
/maintenance off

# Disable maintenance on specific server (proxy only)
/maintenance off lobby
Permission: maintenance.toggle (global) or maintenance.singleserver.toggle (specific server) Aliases: None

​
/maintenance status

Lists all proxied servers currently under maintenance. Proxy only. Syntax: 
/maintenance status
Arguments: None Examples: 
/maintenance status
Permission: maintenance.singleserver.status Aliases: None

​
Timer Commands

​
/maintenance starttimer

Schedules maintenance mode to be enabled after a specified duration. Syntax: 
/maintenance starttimer <duration> [server]
Arguments:
  • duration (required) - Time until maintenance activates (numeric minutes or ISO 8601 format)
  • server (optional, proxy only) - Specific backend server name
Examples: 
# Enable maintenance in 30 minutes
/maintenance starttimer 30

# Enable maintenance in 1 hour 15 minutes
/maintenance starttimer 1h15m

# Enable maintenance on specific server in 2 hours (proxy only)
/maintenance starttimer 2h lobby
Permission: maintenance.timer Aliases: start

​
/maintenance endtimer

Schedules maintenance mode to be disabled after a specified duration. Maintenance must be currently enabled. Syntax: 
/maintenance endtimer <duration> [server]
Arguments:
  • duration (required) - Time until maintenance deactivates (numeric minutes or ISO 8601 format)
  • server (optional, proxy only) - Specific backend server name
Examples: 
# Disable maintenance in 45 minutes
/maintenance endtimer 45

# Disable maintenance in 2 hours 30 minutes
/maintenance endtimer 2h30m

# Disable maintenance on specific server in 1 hour (proxy only)
/maintenance endtimer 1h survival
Permission: maintenance.timer Aliases: end

​
/maintenance scheduletimer

Schedules a maintenance window by specifying when to enable maintenance and how long it should last. Syntax: 
/maintenance scheduletimer <enable-in> <duration> [server]
Arguments:
  • enable-in (required) - Time until maintenance activates (numeric minutes or ISO 8601 format)
  • duration (required) - How long maintenance should last (numeric minutes or ISO 8601 format)
  • server (optional, proxy only) - Specific backend server name
Examples: 
# Enable maintenance in 1 hour, last for 30 minutes
/maintenance scheduletimer 1h 30m

# Enable maintenance in 2 hours, last for 1 hour 15 minutes
/maintenance scheduletimer 2h 1h15m

# Schedule maintenance on specific server (proxy only)
/maintenance scheduletimer 30m 1h lobby
Permission: maintenance.timer Aliases: schedule

​
/maintenance aborttimer

Cancels the currently running timer. Syntax: 
/maintenance aborttimer [server]
Arguments:
  • server (optional, proxy only) - Specific backend server name
Examples: 
# Cancel global timer
/maintenance aborttimer

# Cancel timer for specific server (proxy only)
/maintenance aborttimer lobby
Permission: maintenance.timer Aliases: abort

​
Whitelist Commands

​
/maintenance add

Adds a player to the maintenance whitelist, allowing them to join even when maintenance is enabled. Syntax: 
/maintenance add <player>
/maintenance add <uuid> [name]
Arguments:
  • player (required) - Player name to add
  • uuid (required, alternative) - Player UUID (36 characters)
  • name (optional) - Player name when using UUID
Examples: 
# Add player by name
/maintenance add Notch

# Add player by UUID
/maintenance add 069a79f4-44e9-4726-a5be-fca90e38aaf5

# Add player by UUID with name
/maintenance add 069a79f4-44e9-4726-a5be-fca90e38aaf5 Notch
Permission: maintenance.whitelist.add Aliases: None

​
/maintenance remove

Removes a player from the maintenance whitelist. Syntax: 
/maintenance remove <player>
/maintenance remove <uuid>
Arguments:
  • player (required) - Player name or UUID to remove
  • uuid (required, alternative) - Player UUID (36 characters)
Examples: 
# Remove player by name
/maintenance remove Notch

# Remove player by UUID
/maintenance remove 069a79f4-44e9-4726-a5be-fca90e38aaf5
Permission: maintenance.whitelist.remove Aliases: None

​
/maintenance whitelist

Displays all players currently on the maintenance whitelist. Syntax: 
/maintenance whitelist
Arguments: None Examples: 
/maintenance whitelist
Permission: maintenance.whitelist.list Aliases: None

​
MOTD Commands

​
/maintenance motd

Lists all configured maintenance MOTDs. Syntax: 
/maintenance motd [timer]
Arguments:
  • timer (optional) - Show timer-specific MOTDs instead of regular MOTDs
Examples: 
# View regular maintenance MOTDs
/maintenance motd

# View timer-specific MOTDs
/maintenance motd timer
Permission: maintenance.motd Aliases: None Notes: Timer-specific MOTDs require enable-timerspecific-messages: true in config.yml

​
/maintenance setmotd

Sets or updates a maintenance MOTD line. Syntax: 
/maintenance setmotd [timer] <index> <line> <message>
Arguments:
  • timer (optional) - Modify timer-specific MOTD instead of regular MOTD
  • index (required) - MOTD number (1 to create new, or existing MOTD number)
  • line (required) - Line number (1 or 2)
  • message (required) - Text to set for the line
Examples: 
# Set line 1 of first MOTD
/maintenance setmotd 1 1 Server under maintenance!

# Set line 2 of first MOTD
/maintenance setmotd 1 2 We'll be back soon

# Create second MOTD
/maintenance setmotd 2 1 Scheduled maintenance

# Set timer-specific MOTD
/maintenance setmotd timer 1 1 Maintenance ends in %TIMER%
Permission: maintenance.setmotd Aliases: None Notes:
  • MOTDs support MiniMessage formatting
  • Timer MOTDs can use %TIMER% placeholder
  • Line 1 is the first line, line 2 is the second line of the MOTD

​
/maintenance removemotd

Removes a maintenance MOTD entry. Syntax: 
/maintenance removemotd [timer] <index>
Arguments:
  • timer (optional) - Remove timer-specific MOTD instead of regular MOTD
  • index (required) - MOTD number to remove
Examples: 
# Remove second MOTD
/maintenance removemotd 2

# Remove first timer-specific MOTD
/maintenance removemotd timer 1
Permission: maintenance.setmotd Aliases: None Notes: At least one MOTD must remain configured

​
Administrative Commands

​
/maintenance reload

Reloads all configuration files, maintenance whitelist, language file, and server icon. Syntax: 
/maintenance reload
Arguments: None Examples: 
/maintenance reload
Permission: maintenance.reload Aliases: None

​
/maintenance dump

Generates a dump of server information and configuration for debugging purposes. Output is uploaded to pastes.dev. Syntax: 
/maintenance dump
Arguments: None Examples: 
/maintenance dump
Permission: maintenance.dump Aliases: None Notes: Rate limited to once per 5 minutes

​
/maintenance update

Checks for available plugin updates. Syntax: 
/maintenance update
Arguments: None Examples: 
/maintenance update
Permission: maintenance.update Aliases: None

​
/maintenance forceupdate

Downloads and installs the latest plugin version. Requires server restart to complete. Syntax: 
/maintenance forceupdate
Arguments: None Examples: 
/maintenance forceupdate
Permission: maintenance.update Aliases: None Warning: Always back up your server before updating. A server restart is required to complete the update.

​
/maintenance debug

Toggles debug logging mode. Syntax: 
/maintenance debug
Arguments: None Examples: 
/maintenance debug
Permission: maintenance.debug Aliases: None Notes: This command is not visible in the help menu

​
/maintenance help

Displays the help menu with available commands. Syntax: 
/maintenance help [page]
Arguments:
  • page (optional) - Page number to display (default: 1)
Examples: 
# View first page
/maintenance help

# View second page
/maintenance help 2
Permission: maintenance.command (base permission) Aliases: None Notes: Only shows commands you have permission to use. 8 commands per page.

Build docs developers (and LLMs) love

Get started for freeTalk to us