Maintenance Mode Mod is a server-side utility designed to restrict server access during maintenance periods. Only selected players can connect while others are disconnected with a customizable message. Whether you need to update mods, adjust configs, or perform backups, this mod lets you lock down your server without fully shutting it down. It supports Forge, Fabric, NeoForge, and Quilt across Minecraft versions from 1.12.2 to 1.21.11.
Key Features of Maintenance Mode Mod
- Server Access Restriction — Restricts server access to selected players during maintenance. Only whitelisted operators can connect while the server is in maintenance mode.
- Scheduled Maintenance — Allows scheduling of maintenance start and end times, so you can plan downtime windows in advance without being online.
- Custom Server Icon & MOTD — Displays a customizable server icon and Message of the Day during maintenance mode, letting players know the server is temporarily unavailable.
- Configurable Kick Message — Set a custom disconnect message with MiniMessage and Minecraft formatting support so players see a clear explanation when they try to join.
- Full Server Backups — Provides full server backups covering configs, mods, and settings before maintenance begins.
- LuckPerms Integration — Supports LuckPerms for permission-based access management, allowing fine-grained control over who can join during maintenance.
Screenshots

How to Install Maintenance Mode Mod
- Download and install your preferred mod loader (Forge, Fabric, NeoForge, or Quilt) for your Minecraft version.
- Install CraterLib Mod, which is a required dependency for Maintenance Mode Mod.
- Download the Maintenance Mode Mod file matching your Minecraft version and mod loader from the links below.
- Place the downloaded
.jarfile into your server'smodsfolder. - Start the server and configure maintenance settings through the generated config file.
Requirements & Compatibility
| Requirement | Details |
|---|---|
| Mod Loader | Forge, Fabric, NeoForge, or Quilt |
| Dependencies | CraterLib Mod |
| Minecraft Versions | 1.12.2 – 1.21.11 |
| Side | Server-side |
| Author | hypherionsa |
Pros & Cons
Pros
- Supports all major mod loaders — Forge, Fabric, NeoForge, and Quilt
- Wide version range from 1.12.2 to 1.21.11
- Scheduled maintenance with automatic start/end times
- LuckPerms integration for granular permission control
- Custom MOTD, server icon, and kick messages with formatting support
- Built-in backup functionality before maintenance
Cons
- Requires CraterLib as an additional dependency
- Server-side only — no client-side features or UI
- Configuration requires editing config files (no in-game GUI)
Download Maintenance Mode Mod
Always download mods from official sources. These files are provided by the mod author.
Frequently Asked Questions
What mod loaders does Maintenance Mode Mod support?
Maintenance Mode Mod supports Forge, Fabric, NeoForge, and Quilt. For Minecraft 1.18.2 and newer, a multi-loader version is available that works with all four loaders. Older versions (1.12.2–1.17.1) have separate Forge and Fabric/Quilt downloads.
Do I need any other mods installed for Maintenance Mode to work?
Yes, you need CraterLib Mod as a required dependency. Make sure to install it alongside Maintenance Mode Mod in your server's mods folder.
Can I schedule maintenance windows in advance?
Yes, Maintenance Mode Mod allows you to schedule maintenance start and end times. You can set these through the config file so the server automatically enters and exits maintenance mode without manual intervention.