feat: 完善插件稳定性与兼容性

src/main/resources/config.yml

@@ -1,5 +1,5 @@
 # EssentialsC 主配置
-# 其他配置：modules.yml、maintenance.yml、skin-bridge.yml、blocks-menu.yml
+# 其他配置：modules.yml、maintenance.yml、blocks-menu.yml
 # 消息与颜色：lang/<语言>.yml
 # 修改后使用 /essc reload 重载；命令注册状态发生变化时建议重启服务器。
 
@@ -17,13 +17,8 @@ admin-mode:
   actionbar:
     interval-ticks: 40
 
-# TPS 状态栏：off（关闭）/ auto（自动检测）/ on（请求启用）
-tpsbar:
-  mode: auto
-
-# JEI 配方同步修复；同时受 modules.yml 中的模块开关控制。
+# JEI 配方同步修复；是否加载由 modules.yml 控制。
 jei-sync:
-  enabled: true
   # 玩家加入后延迟多少 tick 检测客户端品牌。
   brand-check-delay-ticks: 20
   send-player-message: true
@@ -32,12 +27,14 @@ jei-sync:
 mob-drops:
   enderman:
     # 允许末影人掉落搬运的方块。
-    enabled: true
+    allow-drops: true
 
 # TPA 传送请求，行为参考 HuskHomes。
 tpa:
   # 请求有效时间，单位为秒。
   timeout-seconds: 60
+  # 每名接收者最多保留的待处理请求数；参考 EssentialsX，超出时移除最早请求。
+  max-pending-requests: 5
 
   # 位置规则
   # /tpa：使用目标接受请求时的位置快照。
@@ -70,3 +67,56 @@ tpa:
     warmup: "block.note_block.banjo"
     cancelled: "entity.item.break"
     complete: "entity.enderman.teleport"
+
+# SkinBridge 外置皮肤站检测与同步；同时受 modules.yml 中的模块开关控制。
+skin-bridge:
+  # 是否加载由 modules.yml 控制；加载前必须填写 MineSkin API Key。
+  # 是否向玩家发送检测与同步结果。
+  send-player-message: true
+  # 是否在控制台记录每次来源检测结果。
+  log-detection-results: true
+  # 玩家加入后延迟多少 tick 开始检测。
+  join-delay-ticks: 20
+  # 检测结果与生成皮肤的内存缓存时间，单位为分钟。
+  cache-minutes: 120
+  # 强制刷新同一玩家皮肤的冷却时间，单位为秒。
+  force-refresh-cooldown-seconds: 30
+  # 仅当 Provider 纹理与玩家登录时携带的纹理一致时，才确认其来自该皮肤站。
+  require-current-texture-match: true
+  # 查询皮肤站 Profile 的超时时间，单位为秒。
+  profile-request-timeout-seconds: 5
+
+  # 排除名单中的玩家不会查询皮肤站，也不会修改当前皮肤。
+  exclusions:
+    uuids: []
+    names: []
+
+  mineskin:
+    endpoint: "https://api.mineskin.org"
+    # 只应填写在服务器运行目录中，禁止提交真实密钥。
+    api-key: ""
+    # 可选值：public / unlisted / private
+    visibility: "unlisted"
+    # 等待 MineSkin 队列完成的最长时间，单位为秒。
+    request-timeout-seconds: 30
+    # 两次 MineSkin 生成任务之间的最小间隔，单位为毫秒。
+    minimum-submit-interval-millis: 1000
+
+  # 数值越小，Provider 查询优先级越高；name 会显示在日志和状态命令中。
+  providers:
+    infstar-mc:
+      enabled: true
+      name: "InfstarMC"
+      priority: 10
+      profile-url: "https://skin.infstar.cn/api/yggdrasil/sessionserver/session/minecraft/profile/{uuid}?unsigned=false"
+    littleskin:
+      enabled: true
+      name: "LittleSkin"
+      priority: 20
+      profile-url: "https://littleskin.cn/api/yggdrasil/sessionserver/session/minecraft/profile/{uuid}?unsigned=false"
+    custom-blessing-skin:
+      # 自建 Blessing Skin 示例。启用前请修改 name 和 profile-url。
+      enabled: false
+      name: "Blessing Skin"
+      priority: 30
+      profile-url: "https://skin.example.com/api/yggdrasil/sessionserver/session/minecraft/profile/{uuid}?unsigned=false"