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 : Add a player to the maintenance whitelist. /maintain admins remove : 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 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.