feat: release 1.5.0

src/main/resources/config.yml

@@ -6,6 +6,9 @@ config-version: 2
 # 语言文件名称，对应插件数据目录下 lang/<语言名>.yml
 language: "zh_CN"
 
+# 是否输出更详细的调试日志。
+debug: false
+
 admin-mode:
   # 原版默认飞行速度为 0.1，这里 0.2 表示两倍飞行速度
   fly-speed: 0.2
@@ -18,6 +21,8 @@ jei-sync:
   enabled: true
   # 是否输出调试日志
   debug: false
+  # 玩家加入后延迟多少 tick 再检测客户端品牌，避免品牌信息尚未同步完成。
+  brand-check-delay-ticks: 20
   # 是否在玩家加入时发送同步提示
   send-player-message: true
 

src/main/resources/lang/en_US.yml

@@ -84,7 +84,7 @@ help:
     repair: "  &f/repair &7- Repair held or all items"
     admin: "  &f/essc admin &7- Toggle admin mode"
     tpsbar: "  &f/tpsbar [player] &7- Toggle TPS boss bar"
-    maintenance: "  &f/maintenance <on|off|status|reload> &7- Manage maintenance mode"
+    maintenance: "  &f/maintenance <on|off|status|reload|add|remove|list> &7- Manage maintenance mode"
 
 blocks-menu:
   title: "&6&lEssentialsC &8- &e&lShortcut Menu"
@@ -180,5 +180,14 @@ maintenance:
     enabled: "&aMaintenance mode enabled."
     disabled: "&cMaintenance mode disabled."
     reloaded: "&aMaintenance configuration reloaded."
-    status: "&7Maintenance mode status: {status}"
-    usage: "&cUsage: /maintenance <on|off|status|reload>"
+    status: "&7Maintenance mode status: {status} &8| &7Whitelist: &f{whitelist_count}"
+    usage: "&cUsage: /maintenance <on|off|status|reload|add|remove|list>"
+    add-usage: "&cUsage: /maintenance add <player|uuid>"
+    remove-usage: "&cUsage: /maintenance remove <player|uuid>"
+    whitelist-added: "&aAdded {player} to the maintenance whitelist."
+    whitelist-removed: "&aRemoved {player} from the maintenance whitelist."
+    whitelist-exists: "&e{player} is already on the maintenance whitelist."
+    whitelist-missing: "&c{player} is not on the maintenance whitelist."
+    whitelist-empty: "&7The maintenance whitelist is empty."
+    whitelist-list: "&7Maintenance whitelist ({count}): &f{entries}"
+    login-blocked: "&e{player} was blocked by maintenance mode. &7UUID: {uuid} &8| &7IP: {address}"

src/main/resources/lang/zh_CN.yml

@@ -84,7 +84,7 @@ help:
     repair: "  &f/repair &7- 修复手中或全部物品"
     admin: "  &f/essc admin &7- 切换管理模式"
     tpsbar: "  &f/tpsbar [玩家] &7- 切换 TPS 状态栏"
-    maintenance: "  &f/maintenance <on|off|status|reload> &7- 管理维护模式"
+    maintenance: "  &f/maintenance <on|off|status|reload|add|remove|list> &7- 管理维护模式"
 
 blocks-menu:
   title: "&6&lEssentialsC &8- &e&l便捷菜单"
@@ -180,5 +180,14 @@ maintenance:
     enabled: "&a维护模式已开启。"
     disabled: "&c维护模式已关闭。"
     reloaded: "&a维护模式配置已重载。"
-    status: "&7维护模式当前状态：{status}"
-    usage: "&c用法：/maintenance <on|off|status|reload>"
+    status: "&7维护模式当前状态：{status} &8| &7白名单：&f{whitelist_count}"
+    usage: "&c用法：/maintenance <on|off|status|reload|add|remove|list>"
+    add-usage: "&c用法：/maintenance add <玩家|UUID>"
+    remove-usage: "&c用法：/maintenance remove <玩家|UUID>"
+    whitelist-added: "&a已将 {player} 加入维护白名单。"
+    whitelist-removed: "&a已将 {player} 移出维护白名单。"
+    whitelist-exists: "&e{player} 已在维护白名单中。"
+    whitelist-missing: "&c{player} 不在维护白名单中。"
+    whitelist-empty: "&7维护白名单为空。"
+    whitelist-list: "&7维护白名单（{count}）：&f{entries}"
+    login-blocked: "&e{player} 被维护模式拦截。&7UUID：{uuid} &8| &7IP：{address}"

src/main/resources/maintenance.yml

@@ -8,6 +8,18 @@ enabled: false
 # 拥有该权限的玩家可以在维护模式下进入服务器。
 bypass-permission: "essentialsc.maintenance.bypass"
 
+notify:
+  # 玩家因维护模式被拒绝进入时，是否通知在线管理员。
+  enabled: true
+  # 拥有该权限的在线玩家会收到拦截通知。
+  permission: "essentialsc.maintenance.notify"
+
+whitelist:
+  # 这些 UUID 可以在维护模式下进入服务器。
+  uuids: []
+  # 这些玩家名可以在维护模式下进入服务器。大小写不敏感。
+  names: []
+
 motd:
   # 维护模式开启时是否替换服务器列表 MOTD。
   enabled: true

src/main/resources/modules.yml

@@ -3,7 +3,8 @@
 # modules.yml 用于控制功能模块是否在运行时加载。
 # config.yml 仍然用于控制已启用模块内部的具体行为。
 #
-# 将模块设置为 false 后，建议重启服务器，以完全注销对应命令和监听器。
+# 修改模块开关后可使用 /essc reload 刷新运行期服务和监听器。
+# 直连命令的完整热增删仍建议通过重启服务器完成。
 
 config-version: 1
 

src/main/resources/paper-plugin.yml

@@ -98,6 +98,9 @@ permissions:
   essentialsc.maintenance.bypass:
     description: 允许在维护模式下进入服务器
     default: op
+  essentialsc.maintenance.notify:
+    description: 允许接收维护模式拦截通知
+    default: op
   essentialsc.shulkerbox.open:
     description: 允许通过 Shift+右键快捷打开潜影盒
     default: op
@@ -137,5 +140,6 @@ permissions:
       essentialsc.command.tpsbar.others: true
       essentialsc.command.maintenance: true
       essentialsc.maintenance.bypass: true
+      essentialsc.maintenance.notify: true
       essentialsc.shulkerbox.open: true
       essentialsc.mobdrops.enderman: true