MaintenanceMod

Put your server into maintenance mode with a single command. Players who are not permitted will be blocked from joining and see a custom MOTD — operators and whitelisted players can always get through.

✨ Features

• /maintenance on — Activate maintenance immediately. All non-permitted players online are kicked instantly.
• /maintenance on <time> — Start a countdown, then activate automatically (e.g. 30s, 5m, 1h, 2h30m).
• /maintenance off — Deactivate maintenance. The original server-list MOTD is restored automatically.
• Custom server-list MOTD — The MOTD shown in the Minecraft multiplayer browser is replaced during maintenance (two lines supported). Player count is hidden and connection bars turn red — just like vanilla maintenance behaviour.
• Maintenance whitelist — Add individual players who are always allowed to join, regardless of operator status.
• Operator bypass — Operators (permission level ≥ 2) can optionally be allowed to join freely during maintenance (configurable).
• Countdown broadcasts — When using a timed countdown, the server broadcasts warnings at key milestones (2h, 1h, 30m, 5m, 4m, 3m, 2m, 1m, 30s, 20s) and then second-by-second from 10s down.
• Persistent state — Maintenance state is saved to the config file and survives server restarts.
• MOTD colour preview — /maintenance motd shows a live colour-rendered preview of the new MOTD directly in chat.
• Tab-complete — Time formats have tab-completion suggestions built in.
• Server-side only — No client mod required.

🔧 Commands

All commands require operator permission level 2.

⏱️ Time Formats

📋 Config (config/maintenancemod-server.toml)

[maintenance]
    # Whether maintenance is currently active (auto-updated by /maintenance on|off)
    enabled = false

    # MOTD shown in the server browser during maintenance (supports §/& colour codes, \n for line 2)
    server_list_motd = "§4§l⚠ Maintenance ⚠\n§cThe server is currently unavailable."

    # Message sent to players who are kicked or blocked during maintenance
    kick_message = "§6[Maintenance]\n§cThe server is currently under maintenance.\n§7Please try again later."

    # If true, operators (level >= 2) can always join and are not kicked on maintenance start
    allow_operators = true

    # Player names always allowed during maintenance (case-insensitive)
    whitelist = []

🎨 MOTD Colours

Both § and & colour codes are supported everywhere — in the config and in the /maintenance motd command.

§4 / &4 → Dark Red       §c / &c → Red
§6 / &6 → Gold            §e / &e → Yellow
§a / &a → Green           §b / &b → Aqua
§9 / &9 → Blue            §5 / &5 → Purple
§l      → Bold            §o      → Italic
§r      → Reset

Two-line MOTD example:

/maintenance motd &4§l⚠ Maintenance | &cWe will be back soon!

🖥️ Requirements

📦 Source & Support

Discord: 2area CurseForge: curseforge.com/members/2area/projects

© 2area — All rights reserved.