Maintenance Mode - 维护模式

💡欢迎使用 MaintenanceMode 2

MaintenanceMode 是一款功能强大的服务器维护管理插件，允许服主自由设定维护时间，并提供高度可定制化的消息、倒计时与白名单功能。自 2014 年发布以来，它积累了丰富的经验，旨在满足服主在服务器维护期间的一切需求。

🎮核心特性

• 直观的 GUI 界面：轻松启用、禁用或取消维护模式。
• 游戏内配置管理：支持通过 GUI 和聊天指令进行配置。
• 高度可定制的消息：可配置维护时的踢出消息、MOTD 和广播消息。
• 倒计时系统：可自定义倒计时时长，并支持按秒播报。
• 音效支持：可为广播消息添加音效，并在维护模式启用时播放特殊音效。
• 协议支持：通过 ProtocolLib 支持自定义版本协议，以优化维护期间的服务器列表显示。
• 维护专属服务器图标：启用维护模式时可更换服务器图标。
• 权限与消息定制：可配置权限不足时的提示信息。
• ServerListPlus 覆盖：可覆盖 ServerListPlus 的 MOTD 设置。
• 自动调试令牌：便于快速诊断问题。

🔧安装与使用

Bukkit 版本

• 将插件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 在游戏内或控制台执行指令 /mm（需要 maintenancemode.use 权限）。
• 首次使用将打开引导 GUI，您可以在其中进行预配置。
• 如需使用协议支持功能，请确保已安装 ProtocolLib。

Bungee 版本

• 即将推出，敬请期待。

⭐指令列表

所有指令均需要 maintenancemode.use 权限。

• /mm - 主指令，显示介绍并提示使用 /mm help。
• /mm help - 显示所有可用指令列表。
• /mm enable - 启用维护模式（如果尚未启用）。
• /mm disable - 禁用维护模式（如果尚未禁用）。
• /mm cancel - 取消正在启用的维护模式。
• /mm gui - 打开 GUI 界面以便于管理。
• /mm reload - 重载 config.yml 配置文件。
• /mm list - 列出所有白名单玩家。
• /mm add - 将玩家添加至白名单（添加后会重新打开配置 GUI）。
• /mm remove - 从白名单中移除玩家（移除后会重新打开配置 GUI）。
• /mm debug - 生成调试信息。
• /mm merge - 合并旧的 whitelist.json 文件，将其中的所有玩家导入到 MaintenanceMode 的白名单中。

✨配置文件详解

以下是 config.yml 的核心配置项说明：

MaintenanceMode:
  options:
    enabled: false
    countdown: 20
    announce:
      - '19'
      - '10'
      - '5'
      - '4'
      - '3'
      - '2'
      - '1'
    whitelist:
      - 'ElieTGM'
      - 'JosephGP'
    broadcastMessage: '&cServer is entering MaintenanceMode in &a%seconds%&c seconds!'
    maintenancekickmessage: '&cThe server is currently in maintenancemode!%newline%&cCheck back soon!'
    motd: '&aWelcome to my ElieLandia!%newline%&cWe are currently in MaintenanceMode!'
    protocolMessage: 'ElieMaintenance'
  misc:
    protocolEnabled: true
    soundenabled: true
    sound: 'ORB_PICKUP'
    finalsoundenabled: true
    finalsound: 'AMBIENCE_THUNDER'
    nopermmessage: '&cYou do not have the sufficient permissions to execute this command!'
    server-icon: true
    overrideslp: true
  messages:
    prefix: '&6&lMaintenanceMode &e|'

配置项说明

• firststartup, enabled：请勿手动修改。
• countdown：设置维护模式启用前的倒计时秒数。
• announce：一个整数列表，当倒计时到达列表中的秒数时，会触发广播和音效。
• whitelist：白名单玩家列表。
• broadcastMessage：倒计时广播消息，支持颜色代码和 %seconds% 占位符。
• maintenancekickmessage：非白名单玩家在维护期间尝试加入服务器时收到的消息。支持颜色代码和 %newline% 换行。
• motd：维护模式启用时的服务器 MOTD。支持 %newline% 和颜色代码。
• protocolMessage：仅在安装 ProtocolLib 后使用。
• protocolEnabled：启用或禁用协议支持（true/false）。
• soundenabled：是否在广播时播放音效。
• sound：广播音效。1.8 版本请使用 此音效枚举，1.9+ 版本请使用 此音效枚举（区分大小写）。
• finalsoundenabled：是否在维护模式最终启用时播放音效。
• finalsound：最终启用时的音效。音效枚举选择同上。
• nopermmessage：玩家权限不足时的提示消息，支持颜色代码。
• server-icon：设为 true 后，可在维护模式启用时使用自定义的 server-icon.png 图标（需为 64x64 像素的 PNG 文件）。
• overrideslp：如果安装了 ServerListPlus，设为 true 可在维护时使用 MaintenanceMode 的 MOTD。
• prefix：设置插件的全局消息前缀。

建议：修改配置文件后，可使用 YAMLLINT 工具验证 config.yml 的格式是否正确。

❓获取帮助与支持

如果您在使用中遇到问题

• 请勿在评论区内报告问题。
• 请在插件讨论页面提问，或通过私信联系开发者。
• 请附上调试信息截图。您可以通过 GUI (/mm gui -> Help/Debug) 或指令 /mm debug 获取调试令牌。调试信息通常如下所示：

    （此处为调试信息示例）

🔧关注开发者

如果本插件对您有所帮助，请在 SpigotMC 上点击 HERE 关注开发者。您的支持是项目保持免费和持续更新的动力。

**欢迎加入 Discord 服务器**

• 邀请链接：https://discord.gg/WDHMD2v
• 或使用邀请码：WDHMD2v

---

如果喜欢这个插件，别忘了留下五星好评！感谢您的支持！