Skip to main content
This guide will help you get Maintenance up and running on your server quickly. If you haven’t installed the plugin yet, check out the installation guide first.

​
Enable maintenance mode

Once installed, enabling maintenance mode is as simple as running a single command:
All players without permission will be kicked from the server, and new connections will be blocked until you disable maintenance mode. To disable maintenance mode:
You can use /mt as a shortcut for /maintenance

​
Managing the whitelist

During maintenance, you’ll likely want to allow specific players (like staff members) to join. Add players to the maintenance whitelist:
To remove a player from the whitelist:
View all whitelisted players:
Whitelisted players can join even when maintenance mode is enabled. They need the maintenance.bypass permission to bypass the maintenance screen.

​
Schedule maintenance with timers

Instead of manually enabling and disabling maintenance, you can schedule it with timers:

​
End timer

Schedule maintenance to automatically disable after a certain time:
The %TIMER% placeholder in your MOTD will show the remaining time.

​
Start timer

Schedule maintenance to enable after a certain time:

​
Cancel a timer

If you need to cancel a running timer:

​
Customize maintenance messages

Edit the config.yml file in your plugin folder to customize the message shown during maintenance:
config.yml
Maintenance uses MiniMessage formatting, which supports:
  • Colors: <red>, <blue>, <#FF5555>
  • Gradients: <gradient:#fbffc2:#0fffff>text</gradient>
  • Decorations: <bold>, <italic>, <underlined>
  • And much more!
After editing the config, reload it with:
Make sure to test your MiniMessage formatting at https://webui.advntr.dev/ before applying it!

​
Proxy-specific features (BungeeCord/Velocity)

If you’re using BungeeCord or Velocity, you can enable maintenance on individual backend servers:
Players on a server when maintenance is enabled will be sent to your configured fallback server instead of being kicked.

​
Next steps

Configuration

Learn about all configuration options

Commands Reference

Explore all available commands

Platform Guides

Platform-specific setup guides

API Integration

Integrate with your own plugins

​
Common tasks

  1. Create a 64x64 PNG image named maintenance-icon.png
  2. Place it in your plugin’s folder (plugins/Maintenance/ or plugins/maintenance/)
  3. Enable it in config.yml:
  1. Reload the config: /maintenance reload
  1. Start an endtimer: /maintenance endtimer 30m
  2. Use the %TIMER% placeholder in your MOTD configuration:
Grant them the maintenance.bypass permission and add them to the whitelist:
They’ll be able to join even during maintenance mode.
Set up Redis synchronization in your config.yml:
All proxies connected to the same Redis instance will automatically sync maintenance status and whitelists. See the Redis configuration guide for details.