Skip to main content
The Maintenance plugin provides a comprehensive command system for managing maintenance mode on your server or proxy network.

​
Base Command

The main command is /maintenance with the alias /mt. 
/maintenance [subcommand] [arguments]
/mt [subcommand] [arguments]

​
Command Structure

All commands follow a consistent structure:
  • Base command: /maintenance or /mt
  • Subcommand: Specific action to perform (e.g., on, reload, add)
  • Arguments: Additional parameters required by the subcommand
Running /maintenance without arguments displays the help menu.

​
Command Categories

Commands are organized into several categories:

​
Maintenance Toggle

  • /maintenance on - Enable maintenance mode
  • /maintenance off - Disable maintenance mode
  • /maintenance status - View maintenance status (proxy only)

​
Timer Management

  • /maintenance starttimer - Schedule maintenance activation
  • /maintenance endtimer - Schedule maintenance deactivation
  • /maintenance scheduletimer - Schedule maintenance window
  • /maintenance aborttimer - Cancel running timer

​
Whitelist Management

  • /maintenance add - Add player to maintenance whitelist
  • /maintenance remove - Remove player from whitelist
  • /maintenance whitelist - List all whitelisted players

​
MOTD Configuration

  • /maintenance motd - View configured MOTDs
  • /maintenance setmotd - Set MOTD lines
  • /maintenance removemotd - Remove MOTD entries

​
Administrative

  • /maintenance reload - Reload configuration files
  • /maintenance dump - Generate debug information
  • /maintenance update - Check for and install updates
  • /maintenance debug - Toggle debug logging
  • /maintenance help - Display help pages

​
Proxy vs. Single Server

When running on a proxy (BungeeCord/Velocity), most commands support an optional [server] parameter to manage maintenance for specific backend servers: 
# Global maintenance
/maintenance on

# Single server maintenance (proxy only)
/maintenance on lobby
See the Command Reference for detailed syntax and examples.

​
Duration Format

Commands that accept duration parameters support two formats: Numeric format (minutes): 
/maintenance starttimer 30  # 30 minutes
ISO 8601 duration format: 
/maintenance starttimer 1h30m    # 1 hour 30 minutes
/maintenance starttimer 2h       # 2 hours
/maintenance starttimer 45s      # 45 seconds
/maintenance starttimer 1h5m30s  # 1 hour 5 minutes 30 seconds
Supported units: h (hours), m (minutes), s (seconds) Maximum duration: 28 days

​
Permission Overview

All commands require the base permission maintenance.command plus specific subcommand permissions. See the Permissions page for complete details.

​
Getting Help

Use /maintenance help to view available commands. The help system supports pagination: 
/maintenance help     # First page
/maintenance help 2   # Second page
Only commands you have permission to use are displayed.

Build docs developers (and LLMs) love

Get started for freeTalk to us