Under-Rated Maintainence

Minecraft 版本： 1.21.11

平台： paper

标签： game-mechanics management utility

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.