Maintenance

Simple maintenance mode plugin for Paper/Spigot

Автор: TakkunMC4140обновлён 15 авг. 2026 г.

УправлениеОптимизацияУтилиты

Описание

Maintenance

A modern, lightweight maintenance mode plugin for Paper servers. Toggle maintenance instantly, or schedule it in advance — with full bilingual support, hex-color messages, and a polished server list integration.

Features

Instant or scheduled maintenance — /maintenance on for an indefinite maintenance window, or /maintenance on 30m <reason> to auto-disable after a set duration, complete with countdown broadcasts.
Survives restarts — a scheduled maintenance window resumes correctly even if the server restarts while it's active.
Separate permissions — maintenance.admin for managing the plugin, maintenance.bypass for letting staff join during maintenance without granting full command access.
Full localization — messages automatically match each player's client language (English and Japanese included out of the box), with graceful fallback.
Hex color support — every message supports both legacy & color codes and modern &#RRGGBB hex colors.
Server list integration — a customizable MOTD for normal and maintenance states, with the player count hidden and a maintenance banner shown in its place while maintenance is active.
Live reload — /maintenance reload reloads the configuration and language files without a restart.
Self-updating config — new configuration options are automatically added when you update the plugin, without overwriting your existing settings.
Optional Modrinth update checker — notifies operators on join when a new version is available.
Tab completion for every subcommand and common durations.

Commands

Command	Description
`/maintenance on [duration] [reason]`	Enable maintenance mode. `duration` accepts a number followed by `s`, `m`, `h`, or `d` (e.g. `30m`, `2h`). Both `duration` and `reason` are optional.
`/maintenance off`	Disable maintenance mode.
`/maintenance status`	Show whether maintenance mode is active, its reason, and any remaining time.
`/maintenance reload`	Reload `config.yml` and the language files.
`/maintenance help`	Show the command list.

Permissions

Permission	Default	Description
`maintenance.admin`	`op`	Allows use of the `/maintenance` command. Implies `maintenance.bypass`.
`maintenance.bypass`	`op`	Allows joining the server while maintenance mode is enabled.

Configuration

config.yml:

maintenance:
  enabled: false
  reason: ""
  scheduled-end: 0

default-language: "en_us"

motd:
  normal:
    line1: "&aExample Server"
    line2: "&7Survival &8| &f%online%&7/&f%max% &7online"
  maintenance:
    line1: "&aExample Server"
    line2: "&cUnder maintenance - back soon!"
  hide-player-count: true
  version-text: "&c⚠ &4Maintenance"

broadcast:
  on-enable: true
  on-disable: true
  countdown-warnings: true

update-checker:
  enabled: true
  modrinth-id: "your-project-slug"
  notify-ops-on-join: true

update-checker.modrinth-id should be set to your plugin's actual Modrinth project slug (the part of the URL after /plugin/) before enabling the checker.

Language files live in plugins/Maintenance/lang/ (en_us.yml, ja_jp.yml) and can be freely edited or extended with additional locales — just add a new <locale>.yml file using the same keys.

Installation

Download Maintenance-<version>.jar and place it in your server's plugins folder.
Restart the server.
Edit plugins/Maintenance/config.yml to taste, then run /maintenance reload.

Requirements

Paper (or a Paper fork) for Minecraft 1.21.x
Java 21+

Галерея

Последние версии

Все версии →

release

Maintenance 2.0.0

2.0.0

15 авг. 2026 г.247Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, spigot

Скачать

Что нового

## Maintenance v2.0.0 Release Notes This is a major update featuring numerous new features, including scheduled maintenance periods and full multilingual support, along with extensive bug fixes and security improvements. ### Important Notes When Updating * Permission nodes have been changed. In addition to `maintenance.admin`, a new `maintenance.bypass` permission has been added. Administrators with `maintenance.admin` automatically receive `maintenance.bypass`. If you manage permissions individually through a permissions plugin, please review your existing permission assignments. * The structure of `config.yml` has been changed. Existing configuration files will automatically have the new settings added when the plugin starts, so no manual migration is required. ### New Features * **Scheduled Maintenance:** Use `/maintenance on <duration> [reason]` to specify when maintenance should end. Example: `/maintenance on 30m Server update` * **Automatic Maintenance End:** Maintenance mode automatically ends when the specified duration has elapsed. * **Automatic Countdown Announcements:** Countdown messages are automatically broadcast before maintenance ends, including 1 hour, 30 minutes, 10 minutes, 5 minutes, 1 minute, 30 seconds, and more. * **Schedule Persistence:** Scheduled maintenance retains its remaining time across server restarts and resumes automatically. * **Maintenance Reason:** A reason can be specified when starting maintenance and is displayed on the kick screen and server status. * **`/maintenance reload`:** Reload `config.yml` and language files without restarting the server. * **`/maintenance status`:** Display the current maintenance status, reason, and remaining time. * **`/maintenance help`:** Display the available commands. * **Tab Completion:** Automatically suggest subcommands and duration formats using the Tab key. * **`maintenance.bypass` Permission:** Staff members who do not have permission to manage maintenance can be individually granted access to join the server during maintenance. * **Hex Color Support:** All messages now support `&#RRGGBB` hex color codes. * **Enhanced Server List Display:** While maintenance mode is active, the player count is hidden and a warning banner is displayed in the version section. * **Full Multilingual Support:** All kick, command, and broadcast messages are available in English and Japanese and automatically follow the player's client language. * **Modrinth Update Notifications:** OPs are notified when a new version is released. Notifications can be disabled in `config.yml`, and the Modrinth project ID can be customized. ### Bug Fixes & Improvements * Fixed an issue where the maintenance kick reason could overwrite a login rejection already made by another plugin. * Fixed an issue where new settings were not added to `config.yml` after updating the plugin. Configuration files now support automatic merging. * Fixed an issue where command messages were hardcoded in English. All messages are now fully managed through language files. * Replaced deprecated APIs such as `kickPlayer(String)` with the latest Adventure Component API. * Fixed resource processing that could cause Japanese language files to become corrupted during the build process by explicitly enforcing UTF-8 encoding. * Eliminated the possibility of `NullPointerException` caused by null configuration values by providing default values for all settings. ### Technical Changes * Updated the Paper API to `1.21.11-R0.1-SNAPSHOT` with Java 21 builds. * Centralized plugin version management in Maven, eliminating duplicate version definitions between `pom.xml` and `plugin.yml`. * Refactored the codebase by separating responsibilities into dedicated components: * `MaintenanceManager` * `MaintenanceTabCompleter` * `UpdateChecker` * `DurationUtil` ### Commands | Command | Description | | ------------------------------------- | --------------------------------------- | | `/maintenance on [duration] [reason]` | Enable maintenance mode | | `/maintenance off` | Disable maintenance mode | | `/maintenance status` | Display the current status | | `/maintenance reload` | Reload configuration and language files | | `/maintenance help` | Display the list of commands | ### Permissions | Permission | Description | Default | | -------------------- | ------------------------------------------------ | ------- | | `maintenance.admin` | Manage maintenance mode (includes bypass access) | OP | | `maintenance.bypass` | Allows joining the server during maintenance | OP |

release

Initial release of the Maintenance plugin

1.0

6 мар. 2026 г.167Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper, spigot

Скачать

Что нового

## Maintenance Plugin v1.0 Initial release of the **Maintenance** plugin for Minecraft servers. ### Features - Enable / disable maintenance mode with `/maintenance on` and `/maintenance off` - Automatically kick non-admin players when maintenance mode is enabled - Server MOTD shows a maintenance notice - Language automatically matches the player's client language - Multi-language messages (English / Japanese supported) ### Configuration - Fully configurable messages in `config.yml` - Custom maintenance MOTD text - Permission-based bypass (`maintenance.admin`) ### Compatibility - Minecraft 1.21.1 - Paper / Spigot based servers - Java 21 ![Example](https://cdn.modrinth.com/data/cached_images/b0d664beb95402fbbbc7054c45d982dc2c5a5c17_0.webp)