Maintenance - 服务器维护模式

Maintenance 是一款适用于 BungeeCord、Spigot（以及 Velocity 和 Sponge，请查看 GitHub 获取额外下载）服务器的维护模式插件。启用后，将阻止没有特定权限的玩家加入服务器。只需将插件放入 Spigot 或 BungeeCord 服务器的插件文件夹即可使用。

💡重要须知

• 本插件使用 MiniMessage 作为文本组件格式。不支持传统的文本格式（如 §a 或 &a）。
• 可使用 https://webui.adventure.kyori.net/ 预览解析后的组件效果。
• 完整的格式文档（包括普通颜色、RGB、点击/悬停事件等）请访问：https://docs.adventure.kyori.net/minimessage/format

🎮核心功能

• 在维护期间显示自定义的 MOTD 和 服务器图标。
• 开始与结束计时器：可在指定时间后自动启用或禁用维护模式（接受 1h5m30s、5m、90s 等时长格式）。
• 计划计时器：可在指定时间后启用维护模式，并在持续一段时间后自动关闭。
• 在 ping 消息中可使用 %TIMER% 变量，以显示结束计时器的剩余时间（更多变量和技巧在配置文件的注释中说明）。
• 维护白名单：允许特定玩家在服务器维护期间加入。
• 当玩家在维护期间尝试加入时，可发送通知。
• 几乎所有消息都可通过语言文件编辑，并支持多种语言。

BungeeCord 额外功能

• 支持对单个服务器启用维护模式：使用 /maintenance <on/off> <servername> 命令。
• 可通过 MySQL 数据库连接 同步多个代理实例的维护状态，无需手动逐一操作。
• 全局维护时可设置 等待服务器，单个服务器维护时可设置 回退服务器。
• 与 ServerListPlus 兼容：启用维护时将自动切换其状态。
• 如需在 Spigot 上使用 PlaceholderAPI 占位符，请查看 MaintenanceAddon 的相关信息。

🔧安装与要求

• 将插件 JAR 文件放入服务器的 plugins 文件夹。
• Spigot 版本：如需使用自定义服务器图标和玩家计数消息，必须安装 ProtocolLib（若运行 Paper 1.12.2 或更高版本则不需要）。
• BungeeCord 版本：无需其他插件。

✨命令列表

参数说明：< > 内为必需参数，[ ] 内为可选参数。

• /maintenance <on/off> [server] – 设置（单个）服务器的维护模式状态
• /maintenance reload – 重载配置和图标文件
• /maintenance <add/remove> <player/uuid> – 在维护白名单中添加/移除玩家
• /maintenance whitelist – 列出所有白名单玩家
• /maintenance starttimer [server] <enable in> – 在指定时间后启用维护模式
• /maintenance endtimer [server] <disable in> – 在指定时间后禁用维护模式
• /maintenance schedule [server] <enable in> <maintenance duration> – 在指定时间后启用维护，并持续指定时长
• /maintenance aborttimer – 取消正在运行的计时器
• /maintenance setmotd <index> <1/2> <message> – 设置维护模式的 MOTD
• /maintenance motd – 列出当前设置的维护 MOTD
• /maintenance update – 远程下载插件最新版本
• /maintenance dump – 转储服务器信息（用于错误报告）

⭐权限节点

• maintenance.admin – 所有权限
• maintenance.bypass – 在维护期间加入服务器
• maintenance.command – 使用 /maintenance 命令（使用子命令也需要）
• maintenance.toggle – 使用 /maintenance <on/off> 命令
• maintenance.reload – 使用 /maintenance reload 命令
• maintenance.update – 使用 /maintenance <update/forceupdate> 命令
• maintenance.timer – 使用计时器相关命令
• maintenance.whitelist.add – 使用 /maintenance add <player> 命令
• maintenance.whitelist.remove – 使用 /maintenance remove <player> 命令
• maintenance.whitelist.list – 使用 /maintenance whitelist 命令
• maintenance.setmotd – 使用 /maintenance setmotd 命令
• maintenance.motd – 使用 /maintenance motd 命令
• maintenance.dump – 使用 /maintenance dump 命令
• maintenance.joinnotification – 接收玩家尝试加入时的通知

BungeeCord 额外权限

• maintenance.singleserver.bypass.<server> – 在指定服务器维护期间加入
• maintenance.singleserver.toggle – 使用 /maintenance <on/off> <server> 命令
• maintenance.singleserver.timer – 使用针对单个服务器的计时器命令
• maintenance.singleserver.status – 使用 /maintenance status 命令

注意：在代理服务器上使用插件时，权限必须设置在 BungeeCord 上（可通过 Bungee 的 config.yml 或 LuckPerms 等跨代理权限插件实现）。

❓配置摘要

以下为配置文件 config.yml 的部分关键选项：

# 设置语言，可用语言包括 en、de、fr、pt、es、ru、zh 等
language: en

# 是否启用维护模式
maintenance-enabled: false

# 代理服务器上指定哪些子服务器启用维护
proxied-maintenance-servers:
  - PaperServer1

# 单个服务器维护时的回退服务器
fallback: lobby

# 全局维护时的等待服务器
waiting-server: ""

# 维护期间显示的 MOTD
ping-message:
  enabled: true
  messages:
    - "<red>Currently under maintenance<br><gradient:#fbffc2:#0fffff>We will be back soon!"

# 是否启用计时器专属 MOTD
enable-timer-specific-messages: true

# 玩家计数消息（不支持 RGB）
player-count-message:
  enabled: true
  message: "<dark_red>Maintenance"

# 玩家列表悬停提示
player-list-hover-message:
  enabled: true
  message: "<red>Currently under<br><red>maintenance"

# 启用/禁用维护时执行的命令
commands-on-maintenance-enable: []
commands-on-maintenance-disable: []

# 是否使用自定义服务器图标
custom-maintenance-icon: false

# 是否发送玩家尝试加入的通知
send-join-notification: false

# 启用维护时是否踢出在线玩家
kick-online-players: true

# 是否在重启后继续结束计时器
continue-endtimer-after-restart:
  enabled: false

# MySQL 数据库同步（用于多代理）
mysql:
  use-mysql: false
  host: host
  port: 3306
  database: database
  username: username
  password: password
  update-interval: 15
  use-ssl: true

# 是否检查更新
update-checks: true

🔧语言文件

语言文件（如 language-en.yml）允许你自定义所有提示消息。你可以使用 MiniMessage 格式来美化文本。前缀、踢出消息、通知等均可在此修改。

✨提示与技巧

• 若想在服务器图标左侧显示文本，可在 playercountmessage 中添加大量空格，例如："Maintenance                                                                    AAAA"。
• 如需贡献翻译，请加入 Discord 并在 https://crowdin.com/project/maintenance 上参与。
• 发现漏洞？请使用 GitHub 的 Issue 跟踪器。

⭐致谢

感谢所有翻译贡献者！你们的帮助让插件更加国际化。如果你喜欢这个插件，请在插件发布页留下评分或评论，这将是对开发者的极大鼓励。