安装
JAR:将构建好的 JAR 文件放入服务器的 plugins 文件夹,然后启动或重载服务器。
配置:编辑 config.yml(首次运行时生成)以自定义消息和行为。
命令
/maintain on:启用维护模式 — 在 kick-delay 延迟后踢出非管理员玩家。
/maintain off:禁用维护模式 — 服务器变为可加入状态。
/maintain admins add <player>:将一名玩家添加到维护白名单。
/maintain admins remove <player>:从白名单中移除一名玩家。
/maintain admins list:显示当前已列入白名单的管理员。
权限:执行命令需要 maintenance.admin 权限;拥有 maintenance.bypass 权限的玩家可在加入时绕过维护模式。
配置(键名及含义)
maintenance-enabled:布尔值 — 当前维护状态。
kick-message:多行字符串 — 踢出玩家时显示的消息(支持 & 颜色代码)。
maintenance-announcement:多行字符串 — 启用维护模式时的广播消息。
maintenance-admins:列表 — 免于被踢出的玩家名称(小写)。
kick-delay:刻数 — 踢人前的延迟时间(20 刻 = 1 秒)。
use-decorative-text:布尔值 — 启用装饰性格式辅助功能。
broadcast-message:布尔值 — 向控制台/聊天广播公告。
join-deny-message:多行字符串 — 尝试在维护期间加入的玩家收到的消息(可配置;支持 & 颜色代码和换行符)。
行为详情
踢人:当启用维护模式时,所有未列入白名单且不具备 maintenance.bypass 权限的在线玩家将被使用 kick-message 踢出。
阻止加入:在维护模式启用期间,新登录请求将被拒绝;玩家将收到 join-deny-message。
白名单与权限:位于 maintenance-admins 列表中或拥有 maintenance.bypass 权限的玩家允许停留或加入。可使用 /maintain admins add <player> 在运行时编辑白名单(更改会持久化到 config.yml)。
格式化:在消息中使用 & 代码(例如 &c、&6、&l);若启用装饰辅助功能,将生成带边框/居中的输出。
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧