What is Maintenance?
Maintenance allows you to control access to your Minecraft server during updates, configuration changes, or scheduled downtime. When maintenance mode is enabled, only whitelisted players can join while others see a custom message explaining the server status. The plugin runs on multiple platforms including Paper (also Spigot, with limited functionality), BungeeCord, Sponge, and Velocity, making it versatile for any server setup.Key features
Custom server list appearance
Set custom MOTDs and server icons that display during maintenance mode
Maintenance whitelist
Grant specific players the ability to join while you work on your server
Start and end timers
Schedule automatic enabling and disabling of maintenance mode with countdown displays
Multi-language support
Fully customizable messages available in 17+ languages via Crowdin
Advanced features
- Dynamic MOTD variables: Use
%TIMER%to show time remaining until maintenance ends - Per-server maintenance (BungeeCord/Velocity): Enable maintenance on specific backend servers instead of the entire network
- Redis support: Link multiple proxy instances to synchronize maintenance status and whitelists
- PlaceholderAPI integration: Use placeholders with the MaintenanceAddon
- Custom commands: Execute commands automatically when maintenance is enabled or disabled
- MiniMessage formatting: Rich text formatting support for all messages and MOTDs
Supported platforms
Maintenance works on the following Minecraft server platforms:- Paper
- BungeeCord
- Velocity
- Sponge
Paper 1.20.1+ (also works on Spigot with limited functionality)Supports custom server icons, full MOTD customization, and all core features. Folia is also supported.
Getting started
Ready to install Maintenance on your server? Head over to the installation guide to get started. For a quick introduction to basic commands and setup, check out the quickstart guide.Support and community
- Downloads: Hangar
- Wiki: GitHub Wiki (configuration, permissions, API usage)
- Discord: Join the community
- Issue tracker: Report bugs
- Translations: Crowdin project