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.

Command	Description
`/maintenance on`	Enable maintenance immediately
`/maintenance on <time>`	Enable maintenance after a countdown (`30s`, `5m`, `1h30m`, …)
`/maintenance off`	Disable maintenance (also cancels any running countdown)
`/maintenance status`	Show current state, countdown, whitelist and MOTD preview
`/maintenance whitelist add <player>`	Add a player to the maintenance whitelist
`/maintenance whitelist remove <player>`	Remove a player from the maintenance whitelist
`/maintenance whitelist list`	List all whitelisted players
`/maintenance motd <text>`	Set the maintenance server-list MOTD (use `\\|` or `\n` for line 2)
`/maintenance reload`	Reload the config file from disk

⏱️ Time Formats

Input	Duration
`30s`	30 seconds
`5m`	5 minutes
`2m30s`	2 minutes 30 seconds
`1h`	1 hour
`1h30m`	1 hour 30 minutes
`2h30m15s`	2 hours 30 minutes 15 seconds
`90`	90 seconds (bare number = seconds)

📋 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


Minecraft	1.21.1
Loader	NeoForge 21.1.x
Side	Server-side only
Dependencies	None

📦 Source & Support

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

Maintenance with Commands byArea