Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Install
Jar: Drop the built JAR into your server plugins folder and start/reload the server. Config: Edit config.yml (created at first run) to customize messages and behavior.
Commands
/maintain on: Enable maintenance mode — kicks non-admins after kick-delay. /maintain off: Disable maintenance mode — server becomes joinable. /maintain admins add <player>: Add a player to the maintenance whitelist. /maintain admins remove <player>: Remove a player from the whitelist. /maintain admins list: Show current whitelisted admins.
Permissions: maintenance.admin required for commands, maintenance.bypass bypasses maintenance on join.
Config (keys and meaning)
maintenance-enabled: boolean — current maintenance state. kick-message: multiline string — message shown when kicking players (supports & color codes). maintenance-announcement: multiline string — broadcast when enabling maintenance. maintenance-admins: list — player names (lowercased) exempt from kicks. kick-delay: ticks — delay before kicking (20 ticks = 1s). use-decorative-text: boolean — enable decorative formatting helpers. broadcast-message: boolean — broadcast announcements to console/chat. join-deny-message: multiline string — message shown to players who try to join during maintenance (configurable; supports & color codes and newlines). Behavior Details
Kicking: When maintenance is enabled, all online players who are not whitelisted and lack maintenance.bypass are kicked with kick-message. Blocking joins: New logins are refused while maintenance is enabled; they receive join-deny-message. Whitelist & permissions: Players in maintenance-admins or with maintenance.bypass are allowed to remain/join. Use /maintain admins add <player> to edit whitelist at runtime (persisted to config.yml). Formatting: Use & codes (e.g., &c, &6, &l) in messages; decorative helpers produce boxed/centered output if enabled.


