🔧 MaintenancePlus BungeeCord

Per-server maintenance mode for BungeeCord & Waterfall networks. Take individual servers offline — without bringing down your entire proxy.

---

✨ Features

🖥️ Per-Server Maintenance

Put any backend server into maintenance mode independently. Players who try to connect are either kicked with a custom message or silently redirected to a fallback server (e.g. your lobby) — no disruption to the rest of your network.

🌐 Proxy-Level Maintenance

Need to lock down the entire proxy? Use /maintenance proxy on to enable network-wide maintenance with a custom MOTD and player slot count — perfect for full network restarts.

⏱️ Countdown & Auto-Dismiss

Warn your players before maintenance even begins with a configurable countdown timer (-c flag). Set an auto-dismiss timer (-t flag) to automatically turn off maintenance after a set number of minutes — no need to remember to run the command again.

📢 Auto-Broadcast

Periodically remind all online players that a server is under maintenance, with a configurable interval and message. Supports %server%, %reason%, %eta%, and %fallback% placeholders.

🔑 Bypass / Whitelist System

Grant specific players the ability to join servers in maintenance mode — ideal for staff members or testers. Manage the whitelist with simple add, remove, and list subcommands.

📋 Maintenance History

Track when maintenance was enabled and disabled for each server with a built-in history log, viewable directly in-game.

🔔 Staff Notifications

Staff members with the maintenanceplus.staff permission are notified in real time when a non-whitelisted player attempts to connect to a server in maintenance.

🛡️ IP-Based Rate Limiting

Prevent connection spam during maintenance with built-in rate limiting — configurable cooldown and message.

🔁 Hot Reload

Apply config changes instantly with /maintenance reload — no restart required.

---

📋 Commands

Command	Description
/mt on <server> [reason] [-t min] [-c min] [-eta text]	Enable maintenance on a server
/mt off <server>	Disable maintenance on a server
/mt status <server>	Check maintenance status of a server
/mt bypass <server> <add|remove|list> [player]	Manage the bypass whitelist
/mt list	List all servers currently in maintenance
/mt history <server>	View maintenance history for a server
/mt proxy <on|off>	Enable/disable proxy-wide maintenance
/mt reload	Reload the plugin config

Aliases: /maintenance, /mt, /maint

---

🔐 Permissions

Permission	Description
maintenanceplus.admin	Access to all maintenance commands
maintenanceplus.staff	Receive notifications when players are blocked
maintenanceplus.bypass	Bypass maintenance and join locked servers

---

⚙️ Configuration

Full control over every message and behavior:

fallback-server: "lobby"

kick-message: |
  &c&lServer Maintenance
  &7Server &f%server% &7is currently under maintenance.
  &7Reason: &f%reason%
  &7ETA: &f%eta%

redirect-message: "&eServer &f%server% &eis under maintenance. Redirecting to &f%fallback%&e."

staff-permission: "maintenanceplus.staff"
staff-notify: "&b[Maintenance] &e%player% &7tried to join &f%server%&7."

proxy-motd: "&c&lServer Maintenance\n&7We'll be back soon!"
proxy-motd-max-players: 0

rate-limit:
  cooldown-seconds: 30
  message: "&cYou are connecting too frequently. Please wait a moment."

broadcast:
  interval-seconds: 120
  message: "&e&lMaintenance &7— Server &f%server% &7is under maintenance!"
  countdown: "&e&lMaintenance &7starts in &c%time% &7for &f%server%&7!"

Supported placeholders: %server%, %reason%, %eta%, %fallback%, %player%, %time%

---

📦 Requirements

• BungeeCord or Waterfall (1.20+)
• Java 17+

---

👤 Author

Made by itsrealnoam — developer