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.

​
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:
See the Command Reference for detailed syntax and examples.

​
Duration Format

Commands that accept duration parameters support two formats: Numeric format (minutes):
ISO 8601 duration format:
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:
Only commands you have permission to use are displayed.