Maintenance - Server Maintenance Mode Plugin

The Maintenance plugin allows you to activate maintenance mode on your Paper, Velocity, Bungee, and Sponge servers, blocking connections from players without appropriate permissions.

Key Features

The plugin offers a comprehensive set of features for convenient server management:

• Customizable MOTD and server icon displayed during maintenance
• Start and end timers automatically enabling and disabling maintenance mode after specified time
• Timer scheduler for activating maintenance for specific periods
• %TIMER% variable in ping messages to show remaining time
• Maintenance whitelist for granting access to specific players
• Notifications about connection attempts during maintenance
• Complete message customization through language files

Velocity/Bungee Features

When used on proxy servers, additional functions are available:

• Enabling maintenance on individual servers via /maintenance <on/off> <server_name> command
• Synchronization of multiple proxy instances through MySQL
• Waiting servers during full proxy maintenance
• Fallback servers for individual servers under maintenance
• Integration with ServerListPlus

Management Commands

Essential commands for working with the plugin:

• /maintenance <on/off> [server] - toggle maintenance mode
• /maintenance reload - reload configuration
• /maintenance <add/remove> <player/uuid> - manage whitelist
• /maintenance starttimer/endtimer [server] <minutes> - timer management
• /maintenance schedule [server] <minutes> <minutes_to_end> - schedule maintenance

Permission System

The plugin uses a detailed permission system:

• maintenance.admin - full access to all functions
• maintenance.bypass - ability to connect during maintenance
• maintenance.command - use of main command
• Special permissions for individual operations

Configuration

Plugin settings cover all aspects of operation:

# Enable maintenance mode
maintenance-enabled: false

# MOTD messages
pingmessages:
  - "<red>Currently under maintenance<br><gradient:#fbffc2:#0fffff>We will be back soon!"

# Custom icon settings
custom-maintenance-icon: false

# Connection notifications
send-join-notification: false

# MySQL settings for multi-proxy
mysql:
  use-mysql: false
  host: host
  port: 3306

Language Support

The plugin supports multiple languages: English, German, French, Portuguese, Spanish, Russian, Chinese, Italian, and Polish. All messages are fully customizable through language files.

Integration and Compatibility

For full functionality on Paper servers, ProtocolLib is required. On Velocity/Bungee, no additional plugins are needed. The plugin integrates with ServerListPlus for automatic status management.

Video Tutorial

German plugin tutorial available on YouTube: https://youtu.be/xZpAVIeGhjM