feat: 完善 TPA 并整理插件配置

README.md

@@ -10,9 +10,9 @@
 ## 项目定位
 
 - 最低支持版本为 `Paper 1.21.11`
-- 已适配 `Paper 26.1.2`
+- 已适配 `Paper 26.2`
 - 构建环境固定为 `Java 21`
-- 配置、模块开关与文本分离：行为配置放在 `config.yml`，模块开关放在 `modules.yml`，提示文本放在 `lang/`
+- 配置按职责拆分：主行为配置、模块开关、SkinBridge、菜单布局、维护模式和语言文本分别管理
 - 支持运行期模块开关，避免为不同功能组合构建多个插件版本
 
 ## 主要功能
@@ -50,7 +50,7 @@
 - Shift + 右键快捷打开潜影盒
 - 潜影盒交互保护，尽量避免刷物品、吞物品和嵌套放入问题
 - 管理模式独立背包、装备栏与状态切换
-- 维护模式：替换 MOTD，并阻止无绕过权限的玩家进入
+- 维护模式：替换 MOTD、登录拦截、白名单放行和管理员拦截通知
 - Enderman 掉落方块控制
 - JEI 配方同步修复
 
@@ -66,21 +66,24 @@
 | `tpsbar` | 开启 | 插件版 TPSBar，仍受 `config.yml` 中 `tpsbar.mode` 控制 |
 | `jei-sync` | 开启 | Fabric / NeoForge JEI 配方同步修复 |
 | `mob-drops` | 关闭 | 末影人掉落控制，默认关闭以保留过去标准版行为 |
-| `maintenance` | 开启 | 维护模式命令、MOTD 替换和登录拦截 |
+| `maintenance` | 开启 | 维护模式命令、MOTD 替换、登录拦截、白名单和拦截通知 |
+| `skin-bridge` | 关闭 | 查询外置 Yggdrasil profile，并通过 MineSkin 与 Paper Profile API 同步皮肤 |
 
-修改模块开关后建议重启服务器，使命令注册表和监听器状态完全刷新。`/essc reload` 可以刷新配置和已注册命令的执行检查，但无法从 Bukkit 命令表中真正热移除或新增直连命令。
+修改模块开关后可先使用 `/essc reload` 刷新运行期服务与监听器状态。由于 Bukkit 命令表不适合在运行期完整热增删，若模块是在启动时关闭的，对应直连命令可能仍需重启后才会注册；通过 `/essc <子命令>` 入口通常可立即按新的模块状态执行。
 
 ## 安装说明
 
 1. 从 [Releases](https://github.com/Coldsmiles/EssentialsC/releases) 下载所需版本。
 2. 将插件放入服务端的 `plugins/` 目录。
 3. 启动一次服务端以生成配置文件。
-4. 按需修改 `plugins/EssentialsC/config.yml` 与 `plugins/EssentialsC/lang/` 下的语言文件。
+4. 按需修改 `plugins/EssentialsC/` 下的配置文件与 `lang/` 语言文件。
 5. 如有需要，使用权限插件为玩家授权。
 
 ## 配置说明
 
-当前配置结构以“行为配置”和“文本配置”分离为原则：
+当前配置按功能职责拆分，避免所有设置堆积在一个文件中：
+
+SkinBridge 默认关闭。使用前需同时启用 `modules.yml` 中的 `modules.skin-bridge.enabled` 和 `skin-bridge.yml` 中的 `enabled`，填写 `mineskin.api-key`，并至少启用一个 Provider。真实密钥只应填写在服务器运行目录的 `skin-bridge.yml` 中，不要写入源码或提交到公开仓库。该模块不要求安装 SkinsRestorer。`send-player-message` 控制是否向玩家发送检测、匹配和同步结果提示；`providers` 下的键名可自由命名，并会显示在日志和 `/essc skin status <玩家>` 中。
 
 - `config.yml`
   - 语言选择
@@ -88,15 +91,22 @@
   - JEI 同步开关
   - 掉落控制
   - TPSBar 模式
-  - 便捷菜单布局
+  - TPA 请求、预热、冷却和音效
 - `modules.yml`
   - 功能模块开关
+- `skin-bridge.yml`
+  - MineSkin API 与队列设置
+  - Provider、缓存和检测设置
+- `blocks-menu.yml`
+  - 便捷菜单分区、槽位、材质和权限
 - `maintenance.yml`
   - 维护模式状态
   - 维护 MOTD
   - 维护踢出提示
   - 维护 BossBar
   - 绕过权限
+  - 维护白名单
+  - 拦截通知权限
 - `lang/zh_CN.yml`、`lang/en_US.yml`
   - 命令反馈
   - 帮助信息
@@ -104,7 +114,7 @@
   - 管理模式文本
   - TPSBar 文本
 
-配置文件包含 `config-version`，后续如有结构升级，可基于版本号进行迁移与重建。
+配置文件包含 `config-version`。从旧结构升级时，插件会备份主配置，并自动把 SkinBridge 与便捷菜单节点迁移到独立文件。
 
 ## 权限示例
 
@@ -122,8 +132,22 @@ essentialsc.command.feed
 essentialsc.command.repair
 essentialsc.command.vanish
 essentialsc.command.seen
+essentialsc.command.tpa
+essentialsc.command.tpahere
+essentialsc.command.tpaall
+essentialsc.command.tpaccept
+essentialsc.command.tpdeny
+essentialsc.command.tpignore
+essentialsc.tpa.bypass-warmup
+essentialsc.tpa.bypass-cooldown
+# 使用数字覆盖玩家预热时间，例如 3 秒
+essentialsc.tpa.warmup.3
 essentialsc.command.admin
 essentialsc.command.tpsbar
+essentialsc.command.maintenance
+essentialsc.command.skin
+essentialsc.maintenance.bypass
+essentialsc.maintenance.notify
 essentialsc.shulkerbox.open
 essentialsc.mobdrops.enderman
 essentialsc.*
@@ -170,6 +194,8 @@ IDEA 运行配置会在启动测试服前自动执行对应部署任务。部署
 ## 开发说明
 
 - 使用 `paperweight-userdev` 进行 Paper 开发
+- 使用 Paper Lifecycle Command API 注册命令，避免直接反射 Bukkit CommandMap
+- 涉及 NMS 的功能通过 `compat-api` + `versions/v<版本>` 适配模块隔离，主插件只依赖稳定接口；当前包含 `1.21.11`、`26.1.2`、`26.2`
 - 运行时通过 `modules.yml` 控制模块加载，命令与监听器按模块状态注册
 - 发布流程基于 GitHub Actions 和 Gradle Wrapper
 

build.gradle

@@ -20,12 +20,16 @@ repositories {
 
 dependencies {
     paperweight.paperDevBundle('1.21.11-R0.1-SNAPSHOT')
+    implementation project(':compat-api')
+    implementation 'com.google.code.gson:gson:2.11.0'
 }
 
 java {
     toolchain.languageVersion.set(JavaLanguageVersion.of(21))
 }
 
+paperweight.reobfArtifactConfiguration = io.papermc.paperweight.userdev.ReobfArtifactConfiguration.getMOJANG_PRODUCTION()
+
 tasks.withType(JavaCompile).configureEach {
     options.encoding = 'UTF-8'
 }
@@ -50,6 +54,16 @@ tasks.named('shadowJar', ShadowJar).configure {
     description = '构建包含全部运行期可开关模块的 EssentialsC 插件。'
     archiveFileName.set("EssentialsC-${project.version}.jar")
     configurations = [project.configurations.runtimeClasspath]
+
+    [
+        project(':versions:v1_21_11'),
+        project(':versions:v26_1_2'),
+        project(':versions:v26_2')
+    ].each { adapterProject ->
+        def adapterJar = adapterProject.tasks.named('jar')
+        dependsOn(adapterJar)
+        from(adapterJar.flatMap { it.archiveFile }.map { archiveFile -> zipTree(archiveFile) })
+    }
 }
 
 tasks.named('assemble').configure {
@@ -77,3 +91,4 @@ def registerTestServerDeployTask = { String taskName, String serverPath, String
 
 registerTestServerDeployTask('deployToPaper12111', 'test-server/paper-1.21.11', 'Paper 1.21.11')
 registerTestServerDeployTask('deployToPaper2612', 'test-server/paper-26.1.2', 'Paper 26.1.2')
+registerTestServerDeployTask('deployToPaper262', 'test-server/paper-26.2', 'Paper 26.2')

compat-api/build.gradle

@@ -0,0 +1,23 @@
+plugins {
+    id 'java-library'
+}
+
+repositories {
+    mavenCentral()
+    maven {
+        name = 'papermc'
+        url = uri('https://repo.papermc.io/repository/maven-public/')
+    }
+}
+
+dependencies {
+    compileOnly 'io.papermc.paper:paper-api:1.21.11-R0.1-SNAPSHOT'
+}
+
+java {
+    toolchain.languageVersion.set(JavaLanguageVersion.of(21))
+}
+
+tasks.withType(JavaCompile).configureEach {
+    options.encoding = 'UTF-8'
+}

compat-api/src/main/java/cn/infstar/essentialsC/compat/jei/JeiRecipeSyncAdapter.java

@@ -0,0 +1,12 @@
+package cn.infstar.essentialsC.compat.jei;
+
+import org.bukkit.entity.Player;
+
+import java.util.logging.Logger;
+
+public interface JeiRecipeSyncAdapter {
+
+    void sendFabricRecipeSync(Player player, Logger logger, boolean debug) throws Exception;
+
+    void sendNeoForgeRecipeSync(Player player, Logger logger, boolean debug) throws Exception;
+}

settings.gradle

@@ -15,4 +15,13 @@ pluginManagement {
     }
 }
 
+plugins {
+    id 'org.gradle.toolchains.foojay-resolver-convention' version '1.0.0'
+}
+
 rootProject.name = 'EssentialsC'
+
+include 'compat-api'
+include 'versions:v1_21_11'
+include 'versions:v26_1_2'
+include 'versions:v26_2'

src/main/java/cn/infstar/essentialsC/EssentialsC.java

@@ -4,51 +4,63 @@ import cn.infstar.essentialsC.admin.AdminModeManager;
 import cn.infstar.essentialsC.commands.BaseCommand;
 import cn.infstar.essentialsC.commands.CommandRegistry;
 import cn.infstar.essentialsC.commands.HelpCommand;
+import cn.infstar.essentialsC.commands.PaperCommand;
+import cn.infstar.essentialsC.commands.VanishCommand;
+import cn.infstar.essentialsC.listeners.JeiRecipeSyncListener;
+import cn.infstar.essentialsC.listeners.MobDropListener;
+import cn.infstar.essentialsC.listeners.MobDropMenuListener;
+import cn.infstar.essentialsC.listeners.ShulkerBoxListener;
+import cn.infstar.essentialsC.listeners.VanishListener;
 import cn.infstar.essentialsC.maintenance.MaintenanceListener;
 import cn.infstar.essentialsC.maintenance.MaintenanceManager;
+import cn.infstar.essentialsC.skinbridge.SkinBridgeManager;
+import cn.infstar.essentialsC.teleport.TeleportRequestManager;
+import cn.infstar.essentialsC.tpsbar.TpsBarManager;
 import cn.infstar.essentialsC.tpsbar.TpsBarService;
-import org.bukkit.Bukkit;
-import org.bukkit.command.Command;
 import org.bukkit.command.CommandSender;
+import org.bukkit.command.TabCompleter;
+import org.bukkit.event.HandlerList;
 import org.bukkit.event.Listener;
+import org.bukkit.plugin.messaging.Messenger;
 import org.bukkit.plugin.java.JavaPlugin;
+import io.papermc.paper.command.brigadier.BasicCommand;
+import io.papermc.paper.command.brigadier.CommandSourceStack;
+import io.papermc.paper.plugin.lifecycle.event.types.LifecycleEvents;
 
-import java.lang.reflect.Field;
+import java.util.Collection;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
 
 public final class EssentialsC extends JavaPlugin {
 
     private static LangManager langManager;
     private ModuleManager moduleManager;
+    private FeatureConfigManager featureConfigManager;
     private AdminModeManager adminModeManager;
     private MaintenanceManager maintenanceManager;
+    private TeleportRequestManager teleportRequestManager;
+    private MaintenanceListener maintenanceListener;
     private TpsBarService tpsBarManager;
+    private ShulkerBoxListener shulkerBoxListener;
+    private JeiRecipeSyncListener jeiRecipeSyncListener;
+    private MobDropListener mobDropListener;
+    private MobDropMenuListener mobDropMenuListener;
+    private VanishListener vanishListener;
+    private SkinBridgeManager skinBridgeManager;
+    private boolean commandsRegistered;
+    private final Map<String, String> moduleStatus = new LinkedHashMap<>();
 
     @Override
     public void onEnable() {
         langManager = new LangManager(this);
         moduleManager = new ModuleManager(this);
+        featureConfigManager = new FeatureConfigManager(this);
 
-        if (moduleManager.isEnabled(ModuleManager.ADMIN_MODE)) {
-            adminModeManager = new AdminModeManager(this);
-            getServer().getPluginManager().registerEvents(adminModeManager, this);
-        }
-
-        if (moduleManager.isEnabled(ModuleManager.MAINTENANCE)) {
-            maintenanceManager = new MaintenanceManager(this);
-            getServer().getPluginManager().registerEvents(new MaintenanceListener(this), this);
-        }
-
-        if (moduleManager.isEnabled(ModuleManager.TPSBAR)) {
-            tpsBarManager = createOptionalService("cn.infstar.essentialsC.tpsbar.TpsBarManager", TpsBarService.class);
-        }
-        if (tpsBarManager instanceof Listener listener) {
-            getServer().getPluginManager().registerEvents(listener, this);
-        }
-        registerPluginChannels();
-        registerListeners();
+        reloadRuntimeModules();
         registerCommands();
 
-        getLogger().info("EssentialsC 已启用，版本: " + getDescription().getVersion());
+        logStartupSummary();
     }
 
     @Override
@@ -62,6 +74,15 @@ public final class EssentialsC extends JavaPlugin {
         if (maintenanceManager != null) {
             maintenanceManager.shutdown();
         }
+        if (teleportRequestManager != null) {
+            teleportRequestManager.shutdown();
+        }
+        if (skinBridgeManager != null) {
+            skinBridgeManager.shutdown();
+        }
+        VanishCommand.clearAll(this);
+        unregisterRuntimeListeners();
+        unregisterPluginChannels();
         getLogger().info("EssentialsC 已禁用。");
     }
 
@@ -77,76 +98,284 @@ public final class EssentialsC extends JavaPlugin {
         return moduleManager;
     }
 
+    public FeatureConfigManager getFeatureConfigManager() {
+        return featureConfigManager;
+    }
+
     public MaintenanceManager getMaintenanceManager() {
         return maintenanceManager;
     }
 
+    public TeleportRequestManager getTeleportRequestManager() {
+        return teleportRequestManager;
+    }
+
     public TpsBarService getTpsBarManager() {
         return tpsBarManager;
     }
 
-    private void registerPluginChannels() {
-        if (!moduleManager.isEnabled(ModuleManager.JEI_SYNC)) {
+    public SkinBridgeManager getSkinBridgeManager() {
+        return skinBridgeManager;
+    }
+
+    public void reloadRuntimeModules() {
+        moduleStatus.clear();
+        refreshPlayer();
+        refreshAdminMode();
+        refreshMaintenance();
+        refreshTpsBar();
+        refreshBlocks();
+        refreshJeiSync();
+        refreshMobDrops();
+        refreshSkinBridge();
+    }
+
+    private void refreshPlayer() {
+        if (!moduleManager.isEnabled(ModuleManager.PLAYER)) {
+            if (teleportRequestManager != null) {
+                teleportRequestManager.shutdown();
+                HandlerList.unregisterAll(teleportRequestManager);
+                teleportRequestManager = null;
+            }
+            VanishCommand.clearAll(this);
+            if (vanishListener != null) {
+                HandlerList.unregisterAll(vanishListener);
+                vanishListener = null;
+            }
+            setModuleStatus("玩家功能", false, "已禁用");
             return;
         }
-        org.bukkit.plugin.messaging.Messenger messenger = getServer().getMessenger();
+
+        if (vanishListener == null) {
+            vanishListener = new VanishListener(this);
+            getServer().getPluginManager().registerEvents(vanishListener, this);
+        }
+        if (teleportRequestManager == null) {
+            teleportRequestManager = new TeleportRequestManager(this);
+            getServer().getPluginManager().registerEvents(teleportRequestManager, this);
+        } else {
+            teleportRequestManager.reload();
+        }
+        setModuleStatus("玩家功能", true, "命令可用");
+    }
+
+    private void refreshAdminMode() {
+        if (!moduleManager.isEnabled(ModuleManager.ADMIN_MODE)) {
+            if (adminModeManager != null) {
+                adminModeManager.shutdown();
+                HandlerList.unregisterAll(adminModeManager);
+                adminModeManager = null;
+            }
+            setModuleStatus("管理模式", false, "已禁用");
+            return;
+        }
+
+        if (adminModeManager == null) {
+            adminModeManager = new AdminModeManager(this);
+            getServer().getPluginManager().registerEvents(adminModeManager, this);
+        }
+        setModuleStatus("管理模式", true, "监听器已注册");
+    }
+
+    private void refreshMaintenance() {
+        if (!moduleManager.isEnabled(ModuleManager.MAINTENANCE)) {
+            if (maintenanceManager != null) {
+                maintenanceManager.shutdown();
+                maintenanceManager = null;
+            }
+            if (maintenanceListener != null) {
+                HandlerList.unregisterAll(maintenanceListener);
+                maintenanceListener = null;
+            }
+            setModuleStatus("维护模式", false, "已禁用");
+            return;
+        }
+
+        if (maintenanceManager == null) {
+            maintenanceManager = new MaintenanceManager(this);
+        } else {
+            maintenanceManager.reload();
+        }
+        if (maintenanceListener == null) {
+            maintenanceListener = new MaintenanceListener(this);
+            getServer().getPluginManager().registerEvents(maintenanceListener, this);
+        }
+        setModuleStatus("维护模式", true, maintenanceManager.isEnabled() ? "当前开启" : "当前关闭");
+    }
+
+    private void refreshTpsBar() {
+        if (!moduleManager.isEnabled(ModuleManager.TPSBAR)) {
+            if (tpsBarManager != null) {
+                tpsBarManager.shutdown();
+                if (tpsBarManager instanceof Listener listener) {
+                    HandlerList.unregisterAll(listener);
+                }
+                tpsBarManager = null;
+            }
+            setModuleStatus("TPSBar", false, "模块已禁用");
+            return;
+        }
+
+        if (tpsBarManager == null) {
+            tpsBarManager = new TpsBarManager(this);
+            if (tpsBarManager instanceof Listener listener) {
+                getServer().getPluginManager().registerEvents(listener, this);
+            }
+        } else {
+            tpsBarManager.reloadSettings();
+        }
+        if (tpsBarManager == null) {
+            setModuleStatus("TPSBar", false, "初始化失败");
+        } else if (!tpsBarManager.isPluginCommandEnabled()) {
+            setModuleStatus("TPSBar", false, tpsBarManager.isNativeCommandAvailable() ? "使用服务端原生命令" : "插件命令关闭");
+        } else {
+            setModuleStatus("TPSBar", true, "插件命令已启用");
+        }
+    }
+
+    private void refreshBlocks() {
+        if (!moduleManager.isEnabled(ModuleManager.BLOCKS)) {
+            if (shulkerBoxListener != null) {
+                HandlerList.unregisterAll(shulkerBoxListener);
+                shulkerBoxListener = null;
+            }
+            setModuleStatus("便捷方块", false, "已禁用");
+            return;
+        }
+
+        if (shulkerBoxListener == null) {
+            shulkerBoxListener = new ShulkerBoxListener(this);
+            getServer().getPluginManager().registerEvents(shulkerBoxListener, this);
+        }
+        setModuleStatus("便捷方块", true, "命令和潜影盒监听器已启用");
+    }
+
+    private void refreshJeiSync() {
+        if (jeiRecipeSyncListener != null) {
+            HandlerList.unregisterAll(jeiRecipeSyncListener);
+            jeiRecipeSyncListener = null;
+        }
+        unregisterPluginChannels();
+
+        if (!moduleManager.isEnabled(ModuleManager.JEI_SYNC)) {
+            setModuleStatus("JEI 同步", false, "已禁用");
+            return;
+        }
+
+        registerPluginChannels();
+        jeiRecipeSyncListener = new JeiRecipeSyncListener(this);
+        getServer().getPluginManager().registerEvents(jeiRecipeSyncListener, this);
+        setModuleStatus("JEI 同步", true, "插件消息通道已注册");
+    }
+
+    private void refreshMobDrops() {
+        if (!moduleManager.isEnabled(ModuleManager.MOB_DROPS)) {
+            if (mobDropListener != null) {
+                HandlerList.unregisterAll(mobDropListener);
+                mobDropListener = null;
+            }
+            if (mobDropMenuListener != null) {
+                HandlerList.unregisterAll(mobDropMenuListener);
+                mobDropMenuListener = null;
+            }
+            setModuleStatus("生物掉落", false, "已禁用");
+            return;
+        }
+
+        if (mobDropListener == null) {
+            mobDropListener = new MobDropListener(this);
+            getServer().getPluginManager().registerEvents(mobDropListener, this);
+        } else {
+            mobDropListener.reload();
+        }
+        if (mobDropMenuListener == null) {
+            mobDropMenuListener = new MobDropMenuListener(this);
+        }
+        setModuleStatus("生物掉落", true, "末影人掉落控制已启用");
+    }
+
+    private void refreshSkinBridge() {
+        if (!moduleManager.isEnabled(ModuleManager.SKIN_BRIDGE)) {
+            if (skinBridgeManager != null) {
+                skinBridgeManager.shutdown();
+                HandlerList.unregisterAll(skinBridgeManager);
+                skinBridgeManager = null;
+            }
+            setModuleStatus("皮肤桥接", false, "已禁用");
+            return;
+        }
+
+        if (skinBridgeManager == null) {
+            skinBridgeManager = new SkinBridgeManager(this);
+            getServer().getPluginManager().registerEvents(skinBridgeManager, this);
+        } else {
+            skinBridgeManager.reload();
+        }
+        setModuleStatus("皮肤桥接", true, skinBridgeManager.getModuleDetail());
+    }
+
+    private void registerPluginChannels() {
+        Messenger messenger = getServer().getMessenger();
         messenger.registerOutgoingPluginChannel(this, "fabric:recipe_sync");
         messenger.registerOutgoingPluginChannel(this, "neoforge:recipe_content");
     }
 
-    private void registerListeners() {
-        if (moduleManager.isEnabled(ModuleManager.BLOCKS)
-            && registerListener("cn.infstar.essentialsC.listeners.ShulkerBoxListener")) {
-            getLogger().info("- 潜影盒模块");
-        }
+    private void unregisterPluginChannels() {
+        Messenger messenger = getServer().getMessenger();
+        messenger.unregisterOutgoingPluginChannel(this, "fabric:recipe_sync");
+        messenger.unregisterOutgoingPluginChannel(this, "neoforge:recipe_content");
+    }
 
-        if (moduleManager.isEnabled(ModuleManager.JEI_SYNC)
-            && registerListener("cn.infstar.essentialsC.listeners.JeiRecipeSyncListener")) {
-            getLogger().info("- JEI 配方同步");
-        }
-
-        if (moduleManager.isEnabled(ModuleManager.MOB_DROPS)
-            && registerListener("cn.infstar.essentialsC.listeners.MobDropListener")) {
-            createOptionalInstance("cn.infstar.essentialsC.listeners.MobDropMenuListener");
-            getLogger().info("- 生物掉落控制");
+    private void unregisterRuntimeListeners() {
+        unregisterListener(adminModeManager);
+        unregisterListener(maintenanceListener);
+        unregisterListener(shulkerBoxListener);
+        unregisterListener(jeiRecipeSyncListener);
+        unregisterListener(mobDropListener);
+        unregisterListener(mobDropMenuListener);
+        unregisterListener(vanishListener);
+        unregisterListener(teleportRequestManager);
+        unregisterListener(skinBridgeManager);
+        if (tpsBarManager instanceof Listener listener) {
+            unregisterListener(listener);
         }
     }
 
-    private boolean registerListener(String className) {
-        try {
-            Class<?> listenerClass = Class.forName(className);
-            Object listenerInstance = listenerClass.getConstructor(EssentialsC.class).newInstance(this);
-            getServer().getPluginManager().registerEvents((org.bukkit.event.Listener) listenerInstance, this);
-            return true;
-        } catch (Exception ignored) {
-            return false;
+    private void unregisterListener(Listener listener) {
+        if (listener != null) {
+            HandlerList.unregisterAll(listener);
         }
     }
 
-    private void createOptionalInstance(String className) {
-        try {
-            Class<?> targetClass = Class.forName(className);
-            targetClass.getConstructor(EssentialsC.class).newInstance(this);
-        } catch (Exception ignored) {
-        }
+    private void setModuleStatus(String moduleName, boolean enabled, String detail) {
+        moduleStatus.put(moduleName, (enabled ? "启用" : "关闭") + " - " + detail);
     }
 
-    private <T> T createOptionalService(String className, Class<T> serviceType) {
-        try {
-            Class<?> targetClass = Class.forName(className);
-            Object instance = targetClass.getConstructor(EssentialsC.class).newInstance(this);
-            return serviceType.cast(instance);
-        } catch (Exception ignored) {
-            return null;
+    private void logStartupSummary() {
+        long enabledCount = moduleStatus.values().stream()
+            .filter(status -> status.startsWith("启用"))
+            .count();
+        long disabledCount = moduleStatus.size() - enabledCount;
+
+        getLogger().info("EssentialsC v" + getDescription().getVersion()
+            + " 已启用 | 模块: " + enabledCount + " 启用, " + disabledCount + " 关闭");
+
+        if (!getConfig().getBoolean("debug", false)) {
+            return;
+        }
+
+        getLogger().info("模块明细:");
+        for (Map.Entry<String, String> entry : moduleStatus.entrySet()) {
+            getLogger().info("  " + entry.getKey() + ": " + entry.getValue());
         }
     }
 
     private void registerCommands() {
-        try {
-            Field bukkitCommandMap = Bukkit.getServer().getClass().getDeclaredField("commandMap");
-            bukkitCommandMap.setAccessible(true);
-            org.bukkit.command.CommandMap commandMap = (org.bukkit.command.CommandMap) bukkitCommandMap.get(Bukkit.getServer());
-
+        if (commandsRegistered) {
+            return;
+        }
+        commandsRegistered = true;
+        getLifecycleManager().registerEventHandler(LifecycleEvents.COMMANDS, event -> {
             for (CommandRegistry.CommandSpec spec : CommandRegistry.getCommandSpecs()) {
                 if (!spec.standalone()) {
                     continue;
@@ -155,61 +384,51 @@ public final class EssentialsC extends JavaPlugin {
                 if (executor == null) {
                     continue;
                 }
-                registerCommandWithAliases(commandMap, spec.name(), executor, spec.aliases().toArray(String[]::new));
+                event.registrar().register(
+                    spec.name(),
+                    spec.name(),
+                    spec.aliases(),
+                    new EssentialsBasicCommand(spec.name(), executor)
+                );
             }
 
-            registerCommandWithAliases(commandMap, "essentialsc", new HelpCommand(), "essc");
-        } catch (Exception e) {
-            getLogger().severe("注册命令失败: " + e.getMessage());
-            e.printStackTrace();
-        }
+            event.registrar().register(
+                "essentialsc",
+                "essentialsc",
+                List.of("essc"),
+                new EssentialsBasicCommand("essentialsc", new HelpCommand())
+            );
+        });
     }
 
-    private void registerCommandWithAliases(org.bukkit.command.CommandMap commandMap, String name, BaseCommand executor, String... aliases) {
-        String fallbackPrefix = getName().toLowerCase(java.util.Locale.ROOT);
-        Command command = new Command(name) {
-            @Override
-            public boolean execute(CommandSender sender, String commandLabel, String[] args) {
-                if (CommandRegistry.resolveCommandName(name) != null && !CommandRegistry.isAvailable(name)) {
-                    sender.sendMessage(EssentialsC.getLangManager().getPrefixedString("messages.module-disabled"));
-                    return true;
-                }
-                return executor.onCommand(sender, this, commandLabel, args);
+    private static final class EssentialsBasicCommand implements BasicCommand {
+
+        private final String name;
+        private final BaseCommand executor;
+        private final PaperCommand commandAdapter;
+
+        private EssentialsBasicCommand(String name, BaseCommand executor) {
+            this.name = name;
+            this.executor = executor;
+            this.commandAdapter = new PaperCommand(name, executor);
+        }
+
+        @Override
+        public void execute(CommandSourceStack commandSourceStack, String[] args) {
+            CommandSender sender = commandSourceStack.getSender();
+            if (CommandRegistry.resolveCommandName(name) != null && !CommandRegistry.isAvailable(name)) {
+                sender.sendMessage(EssentialsC.getLangManager().getPrefixedString("messages.module-disabled"));
+                return;
             }
+            executor.onCommand(sender, commandAdapter, name, args);
+        }
 
-            @Override
-            public java.util.List<String> tabComplete(CommandSender sender, String alias, String[] args) throws IllegalArgumentException {
-                if (executor instanceof org.bukkit.command.TabCompleter completer) {
-                    return completer.onTabComplete(sender, this, alias, args);
-                }
-                return super.tabComplete(sender, alias, args);
+        @Override
+        public Collection<String> suggest(CommandSourceStack commandSourceStack, String[] args) {
+            if (executor instanceof TabCompleter completer) {
+                return completer.onTabComplete(commandSourceStack.getSender(), commandAdapter, name, args);
             }
-        };
-
-        command.setPermission(executor.getPermission());
-        commandMap.register(fallbackPrefix, command);
-
-        for (String alias : aliases) {
-            Command aliasCmd = new Command(alias) {
-                @Override
-                public boolean execute(CommandSender sender, String commandLabel, String[] args) {
-                    if (CommandRegistry.resolveCommandName(name) != null && !CommandRegistry.isAvailable(name)) {
-                        sender.sendMessage(EssentialsC.getLangManager().getPrefixedString("messages.module-disabled"));
-                        return true;
-                    }
-                    return executor.onCommand(sender, this, commandLabel, args);
-                }
-
-                @Override
-                public java.util.List<String> tabComplete(CommandSender sender, String label, String[] args) throws IllegalArgumentException {
-                    if (executor instanceof org.bukkit.command.TabCompleter completer) {
-                        return completer.onTabComplete(sender, this, label, args);
-                    }
-                    return super.tabComplete(sender, label, args);
-                }
-            };
-            aliasCmd.setPermission(executor.getPermission());
-            commandMap.register(fallbackPrefix, aliasCmd);
+            return List.of();
         }
     }
 }

src/main/java/cn/infstar/essentialsC/FeatureConfigManager.java

@@ -0,0 +1,149 @@
+package cn.infstar.essentialsC;
+
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.configuration.file.YamlConfiguration;
+
+import java.io.File;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.InputStreamReader;
+import java.nio.charset.StandardCharsets;
+
+/**
+ * 管理体积较大的独立功能配置，并负责从旧版 config.yml 迁移数据。
+ */
+public final class FeatureConfigManager {
+
+    private static final int MAIN_CONFIG_VERSION = 2;
+
+    private final EssentialsC plugin;
+    private final File skinBridgeFile;
+    private final File blocksMenuFile;
+    private FileConfiguration skinBridgeConfig;
+    private FileConfiguration blocksMenuConfig;
+
+    public FeatureConfigManager(EssentialsC plugin) {
+        this.plugin = plugin;
+        this.skinBridgeFile = new File(plugin.getDataFolder(), "skin-bridge.yml");
+        this.blocksMenuFile = new File(plugin.getDataFolder(), "blocks-menu.yml");
+        reload();
+    }
+
+    public void reload() {
+        ensureResource(skinBridgeFile, "skin-bridge.yml");
+        ensureResource(blocksMenuFile, "blocks-menu.yml");
+
+        skinBridgeConfig = loadWithDefaults(skinBridgeFile, "skin-bridge.yml");
+        blocksMenuConfig = loadWithDefaults(blocksMenuFile, "blocks-menu.yml");
+        migrateLegacyMainConfig();
+        migrateLegacyDebugSettings();
+        updateMainConfigVersion();
+        saveSkinBridgeConfig();
+        saveBlocksMenuConfig();
+    }
+
+    public FileConfiguration getSkinBridgeConfig() {
+        return skinBridgeConfig;
+    }
+
+    public FileConfiguration getBlocksMenuConfig() {
+        return blocksMenuConfig;
+    }
+
+    public void saveSkinBridgeConfig() {
+        save(skinBridgeConfig, skinBridgeFile);
+    }
+
+    public void saveBlocksMenuConfig() {
+        save(blocksMenuConfig, blocksMenuFile);
+    }
+
+    private void migrateLegacyMainConfig() {
+        FileConfiguration mainConfig = plugin.getConfig();
+        boolean migrated = false;
+
+        if (mainConfig.contains("skin-bridge", true)) {
+            copySection(mainConfig.getConfigurationSection("skin-bridge"), skinBridgeConfig);
+            mainConfig.set("skin-bridge", null);
+            migrated = true;
+        }
+        if (mainConfig.contains("blocks-menu", true)) {
+            copySection(mainConfig.getConfigurationSection("blocks-menu"), blocksMenuConfig);
+            mainConfig.set("blocks-menu", null);
+            migrated = true;
+        }
+
+        if (!migrated) {
+            return;
+        }
+
+        mainConfig.set("config-version", MAIN_CONFIG_VERSION);
+        plugin.saveConfig();
+        plugin.getLogger().info("已将 SkinBridge 与便捷菜单配置迁移到独立配置文件。");
+    }
+
+    private void migrateLegacyDebugSettings() {
+        FileConfiguration mainConfig = plugin.getConfig();
+        boolean hasJeiDebug = mainConfig.contains("jei-sync.debug", true);
+        boolean hasSkinBridgeDebug = skinBridgeConfig.contains("debug", true);
+        if (!hasJeiDebug && !hasSkinBridgeDebug) {
+            return;
+        }
+
+        boolean debugEnabled = mainConfig.getBoolean("debug", false)
+            || mainConfig.getBoolean("jei-sync.debug", false)
+            || skinBridgeConfig.getBoolean("debug", false);
+        mainConfig.set("debug", debugEnabled);
+        mainConfig.set("jei-sync.debug", null);
+        skinBridgeConfig.set("debug", null);
+        plugin.saveConfig();
+        plugin.getLogger().info("已将独立功能调试开关合并到 config.yml 的全局 debug。");
+    }
+
+    private void updateMainConfigVersion() {
+        if (plugin.getConfig().getInt("config-version", 0) >= MAIN_CONFIG_VERSION) {
+            return;
+        }
+        plugin.getConfig().set("config-version", MAIN_CONFIG_VERSION);
+        plugin.saveConfig();
+    }
+
+    private void copySection(ConfigurationSection source, FileConfiguration target) {
+        if (source == null) {
+            return;
+        }
+        for (String path : source.getKeys(true)) {
+            if (!source.isConfigurationSection(path)) {
+                target.set(path, source.get(path));
+            }
+        }
+    }
+
+    private FileConfiguration loadWithDefaults(File file, String resourcePath) {
+        YamlConfiguration config = YamlConfiguration.loadConfiguration(file);
+        InputStream defaultsStream = plugin.getResource(resourcePath);
+        if (defaultsStream != null) {
+            YamlConfiguration defaults = YamlConfiguration.loadConfiguration(
+                new InputStreamReader(defaultsStream, StandardCharsets.UTF_8)
+            );
+            config.setDefaults(defaults);
+            config.options().copyDefaults(true);
+        }
+        return config;
+    }
+
+    private void ensureResource(File file, String resourcePath) {
+        if (!file.exists()) {
+            plugin.saveResource(resourcePath, false);
+        }
+    }
+
+    private void save(FileConfiguration config, File file) {
+        try {
+            config.save(file);
+        } catch (IOException exception) {
+            plugin.getLogger().warning("保存 " + file.getName() + " 失败: " + exception.getMessage());
+        }
+    }
+}

src/main/java/cn/infstar/essentialsC/LangManager.java

@@ -1,5 +1,8 @@
 package cn.infstar.essentialsC;
 
+import net.kyori.adventure.text.Component;
+import net.kyori.adventure.text.minimessage.MiniMessage;
+import net.kyori.adventure.text.serializer.legacy.LegacyComponentSerializer;
 import org.bukkit.ChatColor;
 import org.bukkit.configuration.file.FileConfiguration;
 import org.bukkit.configuration.file.YamlConfiguration;
@@ -15,10 +18,22 @@ import java.nio.file.StandardCopyOption;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
+import java.util.regex.Matcher;
+import java.util.regex.Pattern;
 
 public class LangManager {
 
-    private static final int CURRENT_CONFIG_VERSION = 2;
+    private static final int CURRENT_CONFIG_VERSION = 3;
+    private static final Pattern HEX_COLOR_PATTERN = Pattern.compile("(?i)&#([0-9a-f]{6})");
+    private static final MiniMessage MINI_MESSAGE = MiniMessage.miniMessage();
+    private static final Map<String, String> THEME_COLORS = Map.of(
+        "&a", "&#00fb9a",
+        "&b", "&#5286ff",
+        "&c", "&#ff7e5e",
+        "&d", "&#c160ff",
+        "&e", "&#ffc43b",
+        "&6", "&#f5c962"
+    );
 
     private final JavaPlugin plugin;
     private FileConfiguration config;
@@ -32,7 +47,7 @@ public class LangManager {
     }
 
     public String getPrefix() {
-        return translateColorCodes(langFile.getString("prefix", "&6[EssentialsC] &r"));
+        return renderToLegacy(langFile.getString("prefix", "&6[EssentialsC] &r"));
     }
 
     public String getString(String path) {
@@ -40,11 +55,42 @@ public class LangManager {
         if (value == null) {
             return translateColorCodes("&c缺少语言文本: " + path);
         }
-        return translateColorCodes(value);
+        return renderToLegacy(value);
     }
 
     public String getString(String path, Map<String, String> placeholders) {
-        return applyPlaceholders(getString(path), placeholders);
+        String value = langFile.getString(path);
+        if (value == null) {
+            return translateColorCodes("&c缺少语言文本: " + path);
+        }
+        return renderToLegacy(applyPlaceholders(value, placeholders));
+    }
+
+    public Component getComponent(String path) {
+        return getComponent(path, Map.of());
+    }
+
+    public Component getComponent(String path, Map<String, String> placeholders) {
+        String value = langFile.getString(path);
+        if (value == null) {
+            return LegacyComponentSerializer.legacySection()
+                .deserialize(translateColorCodes("&c缺少语言文本: " + path));
+        }
+
+        return renderToComponent(applyPlaceholders(value, placeholders));
+    }
+
+    public Component getPrefixedComponent(String path) {
+        return getPrefixedComponent(path, Map.of());
+    }
+
+    public Component getPrefixedComponent(String path, Map<String, String> placeholders) {
+        String value = langFile.getString(path);
+        if (value == null) {
+            return LegacyComponentSerializer.legacySection()
+                .deserialize(getPrefix() + translateColorCodes("&c缺少语言文本: " + path));
+        }
+        return renderToComponent(langFile.getString("prefix", "") + applyPlaceholders(value, placeholders));
     }
 
     public String getPrefixedString(String path) {
@@ -63,7 +109,7 @@ public class LangManager {
 
         List<String> translated = new ArrayList<>();
         for (String value : values) {
-            translated.add(translateColorCodes(value));
+            translated.add(renderToLegacy(value));
         }
         return translated;
     }
@@ -87,6 +133,7 @@ public class LangManager {
         config = YamlConfiguration.loadConfiguration(configFile);
         config.addDefault("config-version", CURRENT_CONFIG_VERSION);
         config.addDefault("language", "zh_CN");
+        config.addDefault("debug", false);
         config.options().copyDefaults(true);
 
         try {
@@ -99,21 +146,38 @@ public class LangManager {
     private void migrateConfigIfNeeded(File configFile) {
         FileConfiguration existingConfig = YamlConfiguration.loadConfiguration(configFile);
         int existingVersion = existingConfig.getInt("config-version", 0);
-        if (existingVersion <= 0 || existingVersion >= CURRENT_CONFIG_VERSION) {
+        if (existingVersion >= CURRENT_CONFIG_VERSION) {
             return;
         }
 
-        String language = existingConfig.getString("language", "zh_CN");
         File backupFile = new File(plugin.getDataFolder(),
             "config.v" + existingVersion + ".bak-" + System.currentTimeMillis() + ".yml");
 
         try {
             Files.copy(configFile.toPath(), backupFile.toPath(), StandardCopyOption.REPLACE_EXISTING);
-            plugin.saveResource("config.yml", true);
-
-            FileConfiguration newConfig = YamlConfiguration.loadConfiguration(configFile);
-            newConfig.set("language", language);
-            newConfig.save(configFile);
+            InputStream defaultConfigStream = plugin.getResource("config.yml");
+            if (defaultConfigStream != null) {
+                YamlConfiguration migratedConfig = YamlConfiguration.loadConfiguration(
+                    new InputStreamReader(defaultConfigStream, StandardCharsets.UTF_8)
+                );
+                for (String path : existingConfig.getKeys(true)) {
+                    boolean migratedFeaturePath = path.startsWith("skin-bridge.") || path.startsWith("blocks-menu.");
+                    if (!existingConfig.isConfigurationSection(path)
+                        && (migratedConfig.contains(path) || migratedFeaturePath)) {
+                        migratedConfig.set(path, existingConfig.get(path));
+                    }
+                }
+                boolean debugEnabled = existingConfig.getBoolean("debug", false)
+                    || existingConfig.getBoolean("jei-sync.debug", false)
+                    || existingConfig.getBoolean("skin-bridge.debug", false);
+                migratedConfig.set("debug", debugEnabled);
+                migratedConfig.set("jei-sync.debug", null);
+                migratedConfig.set("config-version", CURRENT_CONFIG_VERSION);
+                migratedConfig.save(configFile);
+            } else {
+                existingConfig.set("config-version", CURRENT_CONFIG_VERSION);
+                existingConfig.save(configFile);
+            }
 
             plugin.getLogger().info("已将 config.yml 从版本 " + existingVersion
                 + " 迁移到 " + CURRENT_CONFIG_VERSION + "，备份文件: " + backupFile.getName());
@@ -147,26 +211,88 @@ public class LangManager {
     }
 
     private void loadDefaultLanguageFallback() {
-        InputStream defaultLangStream = plugin.getResource("lang/en_US.yml");
-        if (defaultLangStream == null) {
+        InputStream selectedLangStream = plugin.getResource("lang/" + currentLanguage + ".yml");
+        if (selectedLangStream == null) {
             return;
         }
 
-        YamlConfiguration defaultLang = YamlConfiguration.loadConfiguration(
-            new InputStreamReader(defaultLangStream, StandardCharsets.UTF_8)
+        YamlConfiguration selectedDefaults = YamlConfiguration.loadConfiguration(
+            new InputStreamReader(selectedLangStream, StandardCharsets.UTF_8)
         );
-        langFile.setDefaults(defaultLang);
+        if (!"en_US".equalsIgnoreCase(currentLanguage)) {
+            InputStream englishLangStream = plugin.getResource("lang/en_US.yml");
+            if (englishLangStream != null) {
+                YamlConfiguration englishDefaults = YamlConfiguration.loadConfiguration(
+                    new InputStreamReader(englishLangStream, StandardCharsets.UTF_8)
+                );
+                selectedDefaults.setDefaults(englishDefaults);
+            }
+        }
+        langFile.setDefaults(selectedDefaults);
     }
 
     private String applyPlaceholders(String value, Map<String, String> placeholders) {
         String result = value;
         for (Map.Entry<String, String> entry : placeholders.entrySet()) {
-            result = result.replace("{" + entry.getKey() + "}", entry.getValue());
+            result = result.replace("{" + entry.getKey() + "}", escapeMiniMessageReplacement(entry.getValue()));
         }
         return result;
     }
 
+    private String escapeMiniMessageReplacement(String value) {
+        if (value == null) {
+            return "";
+        }
+        return value.replace("\\", "\\\\").replace("<", "\\<");
+    }
+
     private String translateColorCodes(String text) {
-        return text == null ? "" : ChatColor.translateAlternateColorCodes('&', text);
+        if (text == null) {
+            return "";
+        }
+
+        String themedText = text;
+        for (Map.Entry<String, String> color : THEME_COLORS.entrySet()) {
+            themedText = themedText.replace(color.getKey(), color.getValue());
+        }
+        return ChatColor.translateAlternateColorCodes('&', expandHexColors(themedText));
+    }
+
+    private String expandHexColors(String text) {
+        Matcher matcher = HEX_COLOR_PATTERN.matcher(text);
+        StringBuilder result = new StringBuilder();
+        while (matcher.find()) {
+            String hex = matcher.group(1);
+            StringBuilder legacyHex = new StringBuilder("&x");
+            for (char digit : hex.toCharArray()) {
+                legacyHex.append('&').append(digit);
+            }
+            matcher.appendReplacement(result, Matcher.quoteReplacement(legacyHex.toString()));
+        }
+        matcher.appendTail(result);
+        return result.toString();
+    }
+
+    private String renderToLegacy(String text) {
+        return LegacyComponentSerializer.legacySection().serialize(renderToComponent(text));
+    }
+
+    private Component renderToComponent(String text) {
+        if (text == null) {
+            return Component.empty();
+        }
+        if (looksLikeMiniMessage(text)) {
+            try {
+                return MINI_MESSAGE.deserialize(text);
+            } catch (RuntimeException ignored) {
+                // 配置中 MiniMessage 语法错误时回退到旧颜色码解析，避免消息完全不可用。
+            }
+        }
+        return LegacyComponentSerializer.legacySection().deserialize(translateColorCodes(text));
+    }
+
+    private boolean looksLikeMiniMessage(String text) {
+        int open = text.indexOf('<');
+        return open >= 0 && text.indexOf('>', open) > open;
     }
 }

src/main/java/cn/infstar/essentialsC/ModuleManager.java

@@ -20,6 +20,7 @@ public final class ModuleManager {
     public static final String JEI_SYNC = "jei-sync";
     public static final String MOB_DROPS = "mob-drops";
     public static final String MAINTENANCE = "maintenance";
+    public static final String SKIN_BRIDGE = "skin-bridge";
 
     private static final Map<String, Boolean> DEFAULT_MODULES = new LinkedHashMap<>();
 
@@ -31,6 +32,7 @@ public final class ModuleManager {
         DEFAULT_MODULES.put(JEI_SYNC, true);
         DEFAULT_MODULES.put(MOB_DROPS, false);
         DEFAULT_MODULES.put(MAINTENANCE, true);
+        DEFAULT_MODULES.put(SKIN_BRIDGE, false);
     }
 
     private final JavaPlugin plugin;

src/main/java/cn/infstar/essentialsC/admin/AdminModeManager.java

@@ -1,8 +1,6 @@
 package cn.infstar.essentialsC.admin;
 
 import cn.infstar.essentialsC.EssentialsC;
-import net.kyori.adventure.text.Component;
-import net.kyori.adventure.text.serializer.legacy.LegacyComponentSerializer;
 import org.bukkit.GameMode;
 import org.bukkit.Material;
 import org.bukkit.attribute.Attribute;
@@ -270,9 +268,7 @@ public final class AdminModeManager implements Listener {
     }
 
     private void sendActionBar(Player player) {
-        String text = EssentialsC.getLangManager().getString("admin-mode.actionbar");
-        Component component = LegacyComponentSerializer.legacyAmpersand().deserialize(text);
-        player.sendActionBar(component);
+        player.sendActionBar(EssentialsC.getLangManager().getComponent("admin-mode.actionbar"));
     }
 
     private float getAdminFlySpeed() {

src/main/java/cn/infstar/essentialsC/commands/BaseCommand.java

@@ -33,19 +33,17 @@ public abstract class BaseCommand implements CommandExecutor {
     }
 
     protected void playBlockShortcutSound(Player player, Material material, Sound fallbackSound) {
-        Sound sound = resolvePlaceSound(material);
+        Sound sound = fallbackSound;
         if (sound == null) {
-            sound = fallbackSound;
+            sound = resolvePlaceSound(material);
         }
 
-        if (sound != null) {
-            player.playSound(player.getLocation(), sound, 1.0F, 1.0F);
-        }
+        playShortcutSound(player, sound);
     }
 
     protected void playShortcutSound(Player player, Sound sound) {
         if (sound != null) {
-            player.playSound(player.getLocation(), sound, 1.0F, 1.0F);
+            player.playSound(player.getLocation(), sound, 0.65F, 1.0F);
         }
     }
 

src/main/java/cn/infstar/essentialsC/commands/BlocksMenuCommand.java

@@ -4,6 +4,8 @@ import org.bukkit.Bukkit;
 import org.bukkit.ChatColor;
 import org.bukkit.Material;
 import org.bukkit.NamespacedKey;
+import org.bukkit.Sound;
+import org.bukkit.configuration.file.FileConfiguration;
 import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.Listener;
@@ -59,7 +61,8 @@ public class BlocksMenuCommand extends BaseCommand implements Listener {
     private void openMenu(Player player) {
         Inventory menu = new BlocksMenuHolder(getLang().getString("blocks-menu.title")).getInventory();
 
-        var sectionsConfig = plugin.getConfig().getConfigurationSection("blocks-menu.sections");
+        FileConfiguration menuConfig = plugin.getFeatureConfigManager().getBlocksMenuConfig();
+        var sectionsConfig = menuConfig.getConfigurationSection("sections");
         if (sectionsConfig != null) {
             int visibleSections = renderSections(menu, player, sectionsConfig);
             if (visibleSections > 1) {
@@ -70,10 +73,11 @@ public class BlocksMenuCommand extends BaseCommand implements Listener {
                 return;
             }
             player.openInventory(menu);
+            playShortcutSound(player, Sound.UI_BUTTON_CLICK);
             return;
         }
 
-        var itemsConfig = plugin.getConfig().getConfigurationSection("blocks-menu.items");
+        var itemsConfig = menuConfig.getConfigurationSection("items");
         if (itemsConfig == null) {
             return;
         }
@@ -85,6 +89,7 @@ public class BlocksMenuCommand extends BaseCommand implements Listener {
         }
 
         player.openInventory(menu);
+        playShortcutSound(player, Sound.UI_BUTTON_CLICK);
     }
 
     private int renderSections(Inventory menu, Player player, org.bukkit.configuration.ConfigurationSection sectionsConfig) {
@@ -250,66 +255,69 @@ public class BlocksMenuCommand extends BaseCommand implements Listener {
     }
 
     private void addConfigDefaults() {
-        plugin.getConfig().addDefault("blocks-menu.layout-version", 2);
+        FileConfiguration config = plugin.getFeatureConfigManager().getBlocksMenuConfig();
+        config.addDefault("config-version", 1);
+        config.addDefault("layout-version", 2);
 
-        addMenuItemDefaults("blocks-menu.sections.blocks.items.workbench", 10, "CRAFTING_TABLE",
+        addMenuItemDefaults(config, "sections.blocks.items.workbench", 10, "CRAFTING_TABLE",
             "essentialsc.command.workbench", "workbench");
-        addMenuItemDefaults("blocks-menu.sections.blocks.items.enderchest", 11, "ENDER_CHEST",
+        addMenuItemDefaults(config, "sections.blocks.items.enderchest", 11, "ENDER_CHEST",
             "essentialsc.command.enderchest", "enderchest");
-        addMenuItemDefaults("blocks-menu.sections.blocks.items.anvil", 12, "ANVIL",
+        addMenuItemDefaults(config, "sections.blocks.items.anvil", 12, "ANVIL",
             "essentialsc.command.anvil", "anvil");
-        addMenuItemDefaults("blocks-menu.sections.blocks.items.grindstone", 19, "GRINDSTONE",
+        addMenuItemDefaults(config, "sections.blocks.items.grindstone", 19, "GRINDSTONE",
             "essentialsc.command.grindstone", "grindstone");
-        addMenuItemDefaults("blocks-menu.sections.blocks.items.smithingtable", 20, "SMITHING_TABLE",
+        addMenuItemDefaults(config, "sections.blocks.items.smithingtable", 20, "SMITHING_TABLE",
             "essentialsc.command.smithingtable", "smithingtable");
-        addMenuItemDefaults("blocks-menu.sections.blocks.items.stonecutter", 21, "STONECUTTER",
+        addMenuItemDefaults(config, "sections.blocks.items.stonecutter", 21, "STONECUTTER",
             "essentialsc.command.stonecutter", "stonecutter");
-        addMenuItemDefaults("blocks-menu.sections.blocks.items.loom", 28, "LOOM",
+        addMenuItemDefaults(config, "sections.blocks.items.loom", 28, "LOOM",
             "essentialsc.command.loom", "loom");
-        addMenuItemDefaults("blocks-menu.sections.blocks.items.cartographytable", 29, "CARTOGRAPHY_TABLE",
+        addMenuItemDefaults(config, "sections.blocks.items.cartographytable", 29, "CARTOGRAPHY_TABLE",
             "essentialsc.command.cartographytable", "cartographytable");
 
-        addMenuItemDefaults("blocks-menu.sections.shortcuts.items.nightvision", 14, "TINTED_GLASS",
+        addMenuItemDefaults(config, "sections.shortcuts.items.nightvision", 14, "TINTED_GLASS",
             "essentialsc.command.nightvision", "nightvision");
-        addMenuItemDefaults("blocks-menu.sections.shortcuts.items.glow", 15, "GLOWSTONE",
+        addMenuItemDefaults(config, "sections.shortcuts.items.glow", 15, "GLOWSTONE",
             "essentialsc.command.glow", "glow");
 
-        plugin.getConfig().options().copyDefaults(true);
-        migrateLayoutIfNeeded();
-        plugin.saveConfig();
+        config.options().copyDefaults(true);
+        migrateLayoutIfNeeded(config);
+        plugin.getFeatureConfigManager().saveBlocksMenuConfig();
     }
 
-    private void migrateLayoutIfNeeded() {
-        boolean hasStoredLayoutVersion = plugin.getConfig().contains("blocks-menu.layout-version", true);
-        if (hasStoredLayoutVersion && plugin.getConfig().getInt("blocks-menu.layout-version", 0) >= 2) {
+    private void migrateLayoutIfNeeded(FileConfiguration config) {
+        boolean hasStoredLayoutVersion = config.contains("layout-version", true);
+        if (hasStoredLayoutVersion && config.getInt("layout-version", 0) >= 2) {
             return;
         }
 
-        applySlot("blocks", "workbench", 10);
-        applySlot("blocks", "enderchest", 11);
-        applySlot("blocks", "anvil", 12);
-        applySlot("blocks", "grindstone", 19);
-        applySlot("blocks", "smithingtable", 20);
-        applySlot("blocks", "stonecutter", 21);
-        applySlot("blocks", "loom", 28);
-        applySlot("blocks", "cartographytable", 29);
-        applySlot("shortcuts", "nightvision", 14);
-        applySlot("shortcuts", "glow", 15);
+        applySlot(config, "blocks", "workbench", 10);
+        applySlot(config, "blocks", "enderchest", 11);
+        applySlot(config, "blocks", "anvil", 12);
+        applySlot(config, "blocks", "grindstone", 19);
+        applySlot(config, "blocks", "smithingtable", 20);
+        applySlot(config, "blocks", "stonecutter", 21);
+        applySlot(config, "blocks", "loom", 28);
+        applySlot(config, "blocks", "cartographytable", 29);
+        applySlot(config, "shortcuts", "nightvision", 14);
+        applySlot(config, "shortcuts", "glow", 15);
 
-        plugin.getConfig().set("blocks-menu.sections.blocks.title-item", null);
-        plugin.getConfig().set("blocks-menu.sections.shortcuts.title-item", null);
-        plugin.getConfig().set("blocks-menu.layout-version", 2);
+        config.set("sections.blocks.title-item", null);
+        config.set("sections.shortcuts.title-item", null);
+        config.set("layout-version", 2);
     }
 
-    private void applySlot(String section, String key, int slot) {
-        plugin.getConfig().set("blocks-menu.sections." + section + ".items." + key + ".slot", slot);
+    private void applySlot(FileConfiguration config, String section, String key, int slot) {
+        config.set("sections." + section + ".items." + key + ".slot", slot);
     }
 
-    private void addMenuItemDefaults(String path, int slot, String material, String permission, String command) {
-        plugin.getConfig().addDefault(path + ".slot", slot);
-        plugin.getConfig().addDefault(path + ".material", material);
-        plugin.getConfig().addDefault(path + ".permission", permission);
-        plugin.getConfig().addDefault(path + ".command", command);
+    private void addMenuItemDefaults(FileConfiguration config, String path, int slot, String material,
+                                     String permission, String command) {
+        config.addDefault(path + ".slot", slot);
+        config.addDefault(path + ".material", material);
+        config.addDefault(path + ".permission", permission);
+        config.addDefault(path + ".command", command);
     }
 
     private record MenuItem(int slot, Material material, String name, List<String> lore, String commandKey) {

src/main/java/cn/infstar/essentialsC/commands/CommandRegistry.java

@@ -40,10 +40,17 @@ public final class CommandRegistry {
         register("seen", "essentialsc.command.seen", ModuleManager.PLAYER, "cn.infstar.essentialsC.commands.SeenCommand", "info");
         register("feed", "essentialsc.command.feed", ModuleManager.PLAYER, "cn.infstar.essentialsC.commands.FeedCommand");
         register("repair", "essentialsc.command.repair", ModuleManager.PLAYER, "cn.infstar.essentialsC.commands.RepairCommand", "rep");
+        register("tpa", "essentialsc.command.tpa", ModuleManager.PLAYER, "cn.infstar.essentialsC.commands.TpaCommand");
+        register("tpahere", "essentialsc.command.tpahere", ModuleManager.PLAYER, "cn.infstar.essentialsC.commands.TpaHereCommand");
+        register("tpaall", "essentialsc.command.tpaall", ModuleManager.PLAYER, "cn.infstar.essentialsC.commands.TpaAllCommand");
+        register("tpaccept", "essentialsc.command.tpaccept", ModuleManager.PLAYER, "cn.infstar.essentialsC.commands.TpAcceptCommand", "tpyes");
+        register("tpdeny", "essentialsc.command.tpdeny", ModuleManager.PLAYER, "cn.infstar.essentialsC.commands.TpDenyCommand", "tpdecline", "tpno");
+        register("tpignore", "essentialsc.command.tpignore", ModuleManager.PLAYER, "cn.infstar.essentialsC.commands.TpIgnoreCommand");
         register("tpsbar", "essentialsc.command.tpsbar", ModuleManager.TPSBAR, "cn.infstar.essentialsC.commands.TpsBarCommand");
         register("mobdrops", "essentialsc.mobdrops.enderman", ModuleManager.MOB_DROPS, "cn.infstar.essentialsC.commands.MobDropCommand");
         register("maintenance", "essentialsc.command.maintenance", ModuleManager.MAINTENANCE, "cn.infstar.essentialsC.commands.MaintenanceCommand", "maint");
         registerSubCommand("admin", "essentialsc.command.admin", ModuleManager.ADMIN_MODE, "cn.infstar.essentialsC.commands.AdminCommand");
+        registerSubCommand("skin", "essentialsc.command.skin", ModuleManager.SKIN_BRIDGE, "cn.infstar.essentialsC.commands.SkinBridgeCommand");
     }
 
     private CommandRegistry() {

src/main/java/cn/infstar/essentialsC/commands/HelpCommand.java

@@ -2,8 +2,7 @@ package cn.infstar.essentialsC.commands;
 
 import cn.infstar.essentialsC.EssentialsC;
 import cn.infstar.essentialsC.LangManager;
-import cn.infstar.essentialsC.ModuleManager;
-import cn.infstar.essentialsC.tpsbar.TpsBarService;
+import cn.infstar.essentialsC.teleport.TeleportRequestManager;
 import org.bukkit.Bukkit;
 import org.bukkit.command.Command;
 import org.bukkit.command.CommandSender;
@@ -35,19 +34,10 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
             }
             plugin.reloadConfig();
             EssentialsC.getLangManager().reload();
+            plugin.getFeatureConfigManager().reload();
             plugin.getModuleManager().reload();
             CommandRegistry.clearCache();
-            if (plugin.getMaintenanceManager() != null && plugin.getModuleManager().isEnabled(ModuleManager.MAINTENANCE)) {
-                plugin.getMaintenanceManager().reload();
-            }
-            TpsBarService tpsBarService = plugin.getTpsBarManager();
-            if (tpsBarService != null) {
-                if (plugin.getModuleManager().isEnabled(ModuleManager.TPSBAR)) {
-                    tpsBarService.reloadSettings();
-                } else {
-                    tpsBarService.shutdown();
-                }
-            }
+            plugin.reloadRuntimeModules();
             sender.sendMessage(getLang().getPrefixedString("messages.config-reloaded"));
             return true;
         }
@@ -66,19 +56,10 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
                 }
                 plugin.reloadConfig();
                 EssentialsC.getLangManager().reload();
+                plugin.getFeatureConfigManager().reload();
                 plugin.getModuleManager().reload();
                 CommandRegistry.clearCache();
-                if (plugin.getMaintenanceManager() != null && plugin.getModuleManager().isEnabled(ModuleManager.MAINTENANCE)) {
-                    plugin.getMaintenanceManager().reload();
-                }
-                TpsBarService tpsBarService = plugin.getTpsBarManager();
-                if (tpsBarService != null) {
-                    if (plugin.getModuleManager().isEnabled(ModuleManager.TPSBAR)) {
-                        tpsBarService.reloadSettings();
-                    } else {
-                        tpsBarService.shutdown();
-                    }
-                }
+                plugin.reloadRuntimeModules();
                 sender.sendMessage(getLang().getPrefixedString("messages.config-reloaded"));
                 return true;
             }
@@ -199,6 +180,34 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
             otherCommands.append(lang.getString("help.commands.seen")).append("\n");
             hasOtherCommands = true;
         }
+        if (CommandRegistry.isAvailable("tpa") && player.hasPermission("essentialsc.command.tpa")) {
+            otherCommands.append(lang.getString("help.commands.tpa")).append("\n");
+            hasOtherCommands = true;
+        }
+        if (CommandRegistry.isAvailable("tpahere") && player.hasPermission("essentialsc.command.tpahere")) {
+            otherCommands.append(lang.getString("help.commands.tpahere")).append("\n");
+            hasOtherCommands = true;
+        }
+        if (CommandRegistry.isAvailable("tpaall") && player.hasPermission("essentialsc.command.tpaall")) {
+            otherCommands.append(lang.getString("help.commands.tpaall")).append("\n");
+            hasOtherCommands = true;
+        }
+        if (CommandRegistry.isAvailable("tpaccept") && player.hasPermission("essentialsc.command.tpaccept")) {
+            otherCommands.append(lang.getString("help.commands.tpaccept")).append("\n");
+            hasOtherCommands = true;
+        }
+        if (CommandRegistry.isAvailable("tpdeny") && player.hasPermission("essentialsc.command.tpdeny")) {
+            otherCommands.append(lang.getString("help.commands.tpdeny")).append("\n");
+            hasOtherCommands = true;
+        }
+        if (CommandRegistry.isAvailable("tpignore") && player.hasPermission("essentialsc.command.tpignore")) {
+            otherCommands.append(lang.getString("help.commands.tpignore")).append("\n");
+            hasOtherCommands = true;
+        }
+        if (CommandRegistry.isAvailable("skin") && player.hasPermission("essentialsc.command.skin")) {
+            otherCommands.append(lang.getString("help.commands.skin")).append("\n");
+            hasOtherCommands = true;
+        }
         if (CommandRegistry.isAvailable("admin") && player.hasPermission("essentialsc.command.admin")) {
             otherCommands.append(lang.getString("help.commands.admin")).append("\n");
             hasOtherCommands = true;
@@ -281,6 +290,16 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
                 {"feed", "essentialsc.command.feed"},
                 {"repair", "essentialsc.command.repair"},
                 {"rep", "essentialsc.command.repair"},
+                {"tpa", "essentialsc.command.tpa"},
+                {"tpahere", "essentialsc.command.tpahere"},
+                {"tpaall", "essentialsc.command.tpaall"},
+                {"tpaccept", "essentialsc.command.tpaccept"},
+                {"tpyes", "essentialsc.command.tpaccept"},
+                {"tpdeny", "essentialsc.command.tpdeny"},
+                {"tpdecline", "essentialsc.command.tpdeny"},
+                {"tpno", "essentialsc.command.tpdeny"},
+                {"tpignore", "essentialsc.command.tpignore"},
+                {"skin", "essentialsc.command.skin"},
                 {"tpsbar", "essentialsc.command.tpsbar"},
                 {"maintenance", "essentialsc.command.maintenance"},
                 {"maint", "essentialsc.command.maintenance"},
@@ -318,6 +337,28 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
                 return players;
             }
 
+            Player completionPlayer = sender instanceof Player senderPlayer ? senderPlayer : null;
+            if ((subCmd.equals("tpa") || subCmd.equals("tpahere"))
+                && completionPlayer != null
+                && sender.hasPermission("essentialsc.command." + subCmd)) {
+                return completeOnlinePlayers(completionPlayer, args[1], false);
+            }
+
+            if ((subCmd.equals("tpaccept") || subCmd.equals("tpyes") || subCmd.equals("tpdeny")
+                || subCmd.equals("tpdecline") || subCmd.equals("tpno"))
+                && completionPlayer != null
+                && (sender.hasPermission("essentialsc.command.tpaccept") || sender.hasPermission("essentialsc.command.tpdeny"))) {
+                TeleportRequestManager manager = plugin.getTeleportRequestManager();
+                return manager == null ? List.of() : manager.getIncomingRequesterNames(completionPlayer, args[1]);
+            }
+
+            if (subCmd.equals("skin") && sender.hasPermission("essentialsc.command.skin")) {
+                String partial = args[1].toLowerCase();
+                return List.of("status", "refresh").stream()
+                    .filter(option -> option.startsWith(partial))
+                    .toList();
+            }
+
             if ((subCmd.equals("nightvision") || subCmd.equals("nv")) && sender.hasPermission("essentialsc.command.nightvision")) {
                 return completeToggleArgs(args[1]);
             }
@@ -343,6 +384,19 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
             }
         }
 
+        if (args.length == 3 && args[0].equalsIgnoreCase("skin")
+            && (args[1].equalsIgnoreCase("status") || args[1].equalsIgnoreCase("refresh"))
+            && sender.hasPermission("essentialsc.command.skin")) {
+            List<String> players = new ArrayList<>();
+            String partial = args[2].toLowerCase();
+            for (Player player : Bukkit.getOnlinePlayers()) {
+                if (player.getName().toLowerCase().startsWith(partial)) {
+                    players.add(player.getName());
+                }
+            }
+            return players;
+        }
+
         return new ArrayList<>();
     }
 
@@ -357,10 +411,22 @@ public class HelpCommand extends BaseCommand implements TabCompleter {
         return completions;
     }
 
+    private List<String> completeOnlinePlayers(Player sender, String partialInput, boolean includeSelf) {
+        List<String> completions = new ArrayList<>();
+        String partial = partialInput.toLowerCase();
+        for (Player player : Bukkit.getOnlinePlayers()) {
+            if ((includeSelf || !player.getUniqueId().equals(sender.getUniqueId()))
+                && player.getName().toLowerCase().startsWith(partial)) {
+                completions.add(player.getName());
+            }
+        }
+        return completions;
+    }
+
     private List<String> completeMaintenanceArgs(String partialInput) {
         List<String> completions = new ArrayList<>();
         String partial = partialInput.toLowerCase();
-        for (String option : List.of("on", "off", "status", "reload")) {
+        for (String option : List.of("on", "off", "status", "reload", "add", "remove", "list")) {
             if (option.startsWith(partial)) {
                 completions.add(option);
             }

src/main/java/cn/infstar/essentialsC/commands/MaintenanceCommand.java

@@ -8,6 +8,8 @@ import org.bukkit.entity.Player;
 
 import java.util.ArrayList;
 import java.util.List;
+import java.util.Locale;
+import java.util.Map;
 
 public class MaintenanceCommand extends BaseCommand implements TabCompleter {
 
@@ -37,7 +39,7 @@ public class MaintenanceCommand extends BaseCommand implements TabCompleter {
             return true;
         }
 
-        switch (args[0].toLowerCase()) {
+        switch (args[0].toLowerCase(Locale.ROOT)) {
             case "on", "enable", "enabled" -> {
                 maintenanceManager.setEnabled(true);
                 sender.sendMessage(getLang().getPrefixedString("maintenance.messages.enabled"));
@@ -53,6 +55,42 @@ public class MaintenanceCommand extends BaseCommand implements TabCompleter {
                 sender.sendMessage(getLang().getPrefixedString("maintenance.messages.reloaded"));
                 return true;
             }
+            case "add" -> {
+                if (args.length < 2) {
+                    sender.sendMessage(getLang().getPrefixedString("maintenance.messages.add-usage"));
+                    return true;
+                }
+
+                String target = args[1];
+                if (maintenanceManager.addWhitelistEntry(target)) {
+                    sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-added",
+                        Map.of("player", target)));
+                } else {
+                    sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-exists",
+                        Map.of("player", target)));
+                }
+                return true;
+            }
+            case "remove" -> {
+                if (args.length < 2) {
+                    sender.sendMessage(getLang().getPrefixedString("maintenance.messages.remove-usage"));
+                    return true;
+                }
+
+                String target = args[1];
+                if (maintenanceManager.removeWhitelistEntry(target)) {
+                    sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-removed",
+                        Map.of("player", target)));
+                } else {
+                    sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-missing",
+                        Map.of("player", target)));
+                }
+                return true;
+            }
+            case "list" -> {
+                sendWhitelist(sender, maintenanceManager);
+                return true;
+            }
             default -> {
                 sender.sendMessage(getLang().getPrefixedString("maintenance.messages.usage"));
                 return true;
@@ -65,19 +103,58 @@ public class MaintenanceCommand extends BaseCommand implements TabCompleter {
             ? "maintenance.status.enabled"
             : "maintenance.status.disabled");
         sender.sendMessage(getLang().getPrefixedString("maintenance.messages.status",
-            java.util.Map.of("status", status)));
+            Map.of(
+                "status", status,
+                "whitelist_count", String.valueOf(maintenanceManager.getWhitelistCount())
+            )));
+    }
+
+    private void sendWhitelist(CommandSender sender, MaintenanceManager maintenanceManager) {
+        List<String> entries = maintenanceManager.getWhitelistEntries();
+        if (entries.isEmpty()) {
+            sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-empty"));
+            return;
+        }
+
+        sender.sendMessage(getLang().getPrefixedString("maintenance.messages.whitelist-list",
+            Map.of(
+                "count", String.valueOf(entries.size()),
+                "entries", String.join(", ", entries)
+            )));
     }
 
     @Override
     public List<String> onTabComplete(CommandSender sender, Command command, String label, String[] args) {
-        if (args.length != 1 || !sender.hasPermission(getPermission())) {
+        if (!sender.hasPermission(getPermission())) {
             return List.of();
         }
 
-        String partial = args[0].toLowerCase();
+        if (args.length == 1) {
+            return complete(args[0], List.of("on", "off", "status", "reload", "add", "remove", "list"));
+        }
+
+        if (args.length == 2 && args[0].equalsIgnoreCase("add")) {
+            return complete(args[1], plugin.getServer().getOnlinePlayers().stream()
+                .map(Player::getName)
+                .toList());
+        }
+
+        if (args.length == 2 && args[0].equalsIgnoreCase("remove")) {
+            MaintenanceManager maintenanceManager = plugin.getMaintenanceManager();
+            if (maintenanceManager == null) {
+                return List.of();
+            }
+            return complete(args[1], maintenanceManager.getWhitelistEntries());
+        }
+
+        return List.of();
+    }
+
+    private List<String> complete(String input, List<String> options) {
+        String partial = input.toLowerCase(Locale.ROOT);
         List<String> completions = new ArrayList<>();
-        for (String option : List.of("on", "off", "status", "reload")) {
-            if (option.startsWith(partial)) {
+        for (String option : options) {
+            if (option.toLowerCase(Locale.ROOT).startsWith(partial)) {
                 completions.add(option);
             }
         }

src/main/java/cn/infstar/essentialsC/commands/SkinBridgeCommand.java

@@ -0,0 +1,127 @@
+package cn.infstar.essentialsC.commands;
+
+import cn.infstar.essentialsC.skinbridge.SkinBridgeManager;
+import org.bukkit.Bukkit;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.TabCompleter;
+import org.bukkit.entity.Player;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+
+public final class SkinBridgeCommand extends BaseCommand implements TabCompleter {
+
+    public SkinBridgeCommand() {
+        super("essentialsc.command.skin");
+    }
+
+    @Override
+    protected boolean execute(Player player, String[] args) {
+        return executeCommand(player, args, false);
+    }
+
+    @Override
+    protected boolean executeConsole(CommandSender sender, String[] args) {
+        return executeCommand(sender, args, true);
+    }
+
+    private boolean executeCommand(CommandSender sender, String[] args, boolean console) {
+        if (args.length < 1 || args.length > 2) {
+            sender.sendMessage(getLang().getPrefixedString("skin-bridge.messages.usage"));
+            return true;
+        }
+
+        SkinBridgeManager manager = plugin.getSkinBridgeManager();
+        if (manager == null) {
+            sender.sendMessage(getLang().getPrefixedString("messages.module-disabled"));
+            return true;
+        }
+
+        Player target = console ? null : (Player) sender;
+        if (args.length == 2) {
+            target = Bukkit.getPlayerExact(args[1]);
+            if (target == null || !target.isOnline()) {
+                sender.sendMessage(getLang().getPrefixedString("messages.player-not-found", Map.of("player", args[1])));
+                return true;
+            }
+        }
+        if (target == null) {
+            sender.sendMessage(getLang().getPrefixedString("skin-bridge.messages.usage"));
+            return true;
+        }
+
+        String action = args[0].toLowerCase(Locale.ROOT);
+        if (action.equals("status")) {
+            sendStatus(sender, target, manager);
+            return true;
+        }
+        if (action.equals("refresh")) {
+            sendRefreshResult(sender, target, manager.queueSync(target, true));
+            return true;
+        }
+
+        sender.sendMessage(getLang().getPrefixedString("skin-bridge.messages.usage"));
+        return true;
+    }
+
+    private void sendStatus(CommandSender sender, Player target, SkinBridgeManager manager) {
+        if (!manager.isEnabled()) {
+            sender.sendMessage(getLang().getPrefixedString("skin-bridge.messages.feature-disabled"));
+            return;
+        }
+        if (!manager.isSkinGatewayAvailable()) {
+            sender.sendMessage(getLang().getPrefixedString("skin-bridge.messages.dependency-missing"));
+            return;
+        }
+        if (manager.getProviderCount() == 0) {
+            sender.sendMessage(getLang().getPrefixedString("skin-bridge.messages.no-providers"));
+            return;
+        }
+
+        SkinBridgeManager.Status status = manager.getStatus(target);
+        Map<String, String> placeholders = Map.of("player", target.getName(), "provider", String.valueOf(status.providerId()));
+        switch (status.state()) {
+            case EXTERNAL -> sender.sendMessage(getLang().getPrefixedString("skin-bridge.messages.status-external", placeholders));
+            case NOT_EXTERNAL -> sender.sendMessage(getLang().getPrefixedString("skin-bridge.messages.status-not-external", placeholders));
+            case PENDING -> sender.sendMessage(getLang().getPrefixedString("skin-bridge.messages.status-pending", placeholders));
+            case UNKNOWN -> sender.sendMessage(getLang().getPrefixedString("skin-bridge.messages.status-unknown", placeholders));
+        }
+    }
+
+    private void sendRefreshResult(CommandSender sender, Player target, SkinBridgeManager.SyncResult result) {
+        Map<String, String> placeholders = Map.of("player", target.getName());
+        String messagePath = switch (result) {
+            case QUEUED -> "skin-bridge.messages.refresh-queued";
+            case CACHED -> "skin-bridge.messages.refresh-cached";
+            case ALREADY_RUNNING -> "skin-bridge.messages.refresh-running";
+            case FEATURE_DISABLED -> "skin-bridge.messages.feature-disabled";
+            case DEPENDENCY_MISSING -> "skin-bridge.messages.dependency-missing";
+            case NO_PROVIDERS -> "skin-bridge.messages.no-providers";
+        };
+        sender.sendMessage(getLang().getPrefixedString(messagePath, placeholders));
+    }
+
+    @Override
+    public List<String> onTabComplete(CommandSender sender, Command command, String label, String[] args) {
+        if (args.length == 1) {
+            String partial = args[0].toLowerCase(Locale.ROOT);
+            return List.of("status", "refresh").stream()
+                .filter(option -> option.startsWith(partial))
+                .toList();
+        }
+        if (args.length == 2 && (args[0].equalsIgnoreCase("status") || args[0].equalsIgnoreCase("refresh"))) {
+            String partial = args[1].toLowerCase(Locale.ROOT);
+            List<String> players = new ArrayList<>();
+            for (Player onlinePlayer : Bukkit.getOnlinePlayers()) {
+                if (onlinePlayer.getName().toLowerCase(Locale.ROOT).startsWith(partial)) {
+                    players.add(onlinePlayer.getName());
+                }
+            }
+            return players;
+        }
+        return List.of();
+    }
+}

src/main/java/cn/infstar/essentialsC/commands/TpAcceptCommand.java

@@ -0,0 +1,78 @@
+package cn.infstar.essentialsC.commands;
+
+import cn.infstar.essentialsC.teleport.TeleportRequestManager;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.TabCompleter;
+import org.bukkit.entity.Player;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+
+public final class TpAcceptCommand extends BaseCommand implements TabCompleter {
+
+    public TpAcceptCommand() {
+        super("essentialsc.command.tpaccept");
+    }
+
+    @Override
+    protected boolean execute(Player player, String[] args) {
+        if (args.length > 1) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.usage-tpaccept"));
+            return true;
+        }
+
+        TeleportRequestManager manager = plugin.getTeleportRequestManager();
+        if (manager == null) {
+            player.sendMessage(getLang().getPrefixedComponent("messages.module-disabled"));
+            return true;
+        }
+        if (manager.isIgnoringRequests(player)) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.ignoring-requests"));
+            return true;
+        }
+
+        Optional<TeleportRequestManager.TeleportRequest> request = manager.findIncoming(
+            player,
+            args.length == 0 ? null : args[0]
+        );
+        if (request.isEmpty()) {
+            player.sendMessage(args.length == 0
+                ? getLang().getPrefixedComponent("tpa.messages.no-request")
+                : getLang().getPrefixedComponent("tpa.messages.invalid-request", Map.of("requester", args[0])));
+            return true;
+        }
+
+        TeleportRequestManager.TeleportRequest accepted = request.get();
+        Map<String, String> placeholders = manager.placeholders(accepted);
+        TeleportRequestManager.TeleportResult result = manager.accept(player, accepted);
+        if (result.status() == TeleportRequestManager.TeleportResult.Status.EXPIRED) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.expired", placeholders));
+            return true;
+        }
+        if (result.status() == TeleportRequestManager.TeleportResult.Status.PLAYER_OFFLINE) {
+            return true;
+        }
+        if (result.status() == TeleportRequestManager.TeleportResult.Status.ON_COOLDOWN) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.accept-cooldown",
+                Map.of("seconds", String.valueOf(result.cooldownSeconds()))));
+            return true;
+        }
+
+        return true;
+    }
+
+    @Override
+    public List<String> onTabComplete(CommandSender sender, Command command, String label, String[] args) {
+        if (args.length != 1 || !(sender instanceof Player player)) {
+            return List.of();
+        }
+
+        TeleportRequestManager manager = plugin.getTeleportRequestManager();
+        if (manager == null) {
+            return List.of();
+        }
+        return manager.getIncomingRequesterNames(player, args[0]);
+    }
+}

src/main/java/cn/infstar/essentialsC/commands/TpDenyCommand.java

@@ -0,0 +1,69 @@
+package cn.infstar.essentialsC.commands;
+
+import cn.infstar.essentialsC.teleport.TeleportRequestManager;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.TabCompleter;
+import org.bukkit.entity.Player;
+
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+
+public final class TpDenyCommand extends BaseCommand implements TabCompleter {
+
+    public TpDenyCommand() {
+        super("essentialsc.command.tpdeny");
+    }
+
+    @Override
+    protected boolean execute(Player player, String[] args) {
+        if (args.length > 1) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.usage-tpdeny"));
+            return true;
+        }
+
+        TeleportRequestManager manager = plugin.getTeleportRequestManager();
+        if (manager == null) {
+            player.sendMessage(getLang().getPrefixedComponent("messages.module-disabled"));
+            return true;
+        }
+        if (manager.isIgnoringRequests(player)) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.ignoring-requests"));
+            return true;
+        }
+
+        Optional<TeleportRequestManager.TeleportRequest> request = manager.findIncoming(
+            player,
+            args.length == 0 ? null : args[0]
+        );
+        if (request.isEmpty()) {
+            player.sendMessage(args.length == 0
+                ? getLang().getPrefixedComponent("tpa.messages.no-request")
+                : getLang().getPrefixedComponent("tpa.messages.invalid-request", Map.of("requester", args[0])));
+            return true;
+        }
+
+        TeleportRequestManager.TeleportRequest denied = request.get();
+        TeleportRequestManager.TeleportResult result = manager.deny(player, denied);
+        if (result.status() == TeleportRequestManager.TeleportResult.Status.EXPIRED) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.expired", manager.placeholders(denied)));
+            return true;
+        }
+
+        return true;
+    }
+
+    @Override
+    public List<String> onTabComplete(CommandSender sender, Command command, String label, String[] args) {
+        if (args.length != 1 || !(sender instanceof Player player)) {
+            return List.of();
+        }
+
+        TeleportRequestManager manager = plugin.getTeleportRequestManager();
+        if (manager == null) {
+            return List.of();
+        }
+        return manager.getIncomingRequesterNames(player, args[0]);
+    }
+}

src/main/java/cn/infstar/essentialsC/commands/TpIgnoreCommand.java

@@ -0,0 +1,26 @@
+package cn.infstar.essentialsC.commands;
+
+import cn.infstar.essentialsC.teleport.TeleportRequestManager;
+import org.bukkit.entity.Player;
+
+public final class TpIgnoreCommand extends BaseCommand {
+
+    public TpIgnoreCommand() {
+        super("essentialsc.command.tpignore");
+    }
+
+    @Override
+    protected boolean execute(Player player, String[] args) {
+        TeleportRequestManager manager = plugin.getTeleportRequestManager();
+        if (manager == null) {
+            player.sendMessage(getLang().getPrefixedComponent("messages.module-disabled"));
+            return true;
+        }
+
+        boolean ignoring = manager.toggleIgnoringRequests(player);
+        player.sendMessage(getLang().getPrefixedComponent(ignoring
+            ? "tpa.messages.ignore-enabled"
+            : "tpa.messages.ignore-disabled"));
+        return true;
+    }
+}

src/main/java/cn/infstar/essentialsC/commands/TpaAllCommand.java

@@ -0,0 +1,38 @@
+package cn.infstar.essentialsC.commands;
+
+import cn.infstar.essentialsC.teleport.TeleportRequestManager;
+import org.bukkit.entity.Player;
+
+public final class TpaAllCommand extends BaseCommand {
+
+    public TpaAllCommand() {
+        super("essentialsc.command.tpaall");
+    }
+
+    @Override
+    protected boolean execute(Player player, String[] args) {
+        if (args.length != 0) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.usage-tpaall"));
+            return true;
+        }
+
+        TeleportRequestManager manager = plugin.getTeleportRequestManager();
+        if (manager == null) {
+            player.sendMessage(getLang().getPrefixedComponent("messages.module-disabled"));
+            return true;
+        }
+        if (manager.isIgnoringRequests(player)) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.ignoring-requests"));
+            return true;
+        }
+
+        int sent = manager.sendTeleportAllRequest(player);
+        if (sent <= 0) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.tpaall-no-targets"));
+            return true;
+        }
+
+        player.sendMessage(getLang().getPrefixedComponent("tpa.messages.tpaall-sent"));
+        return true;
+    }
+}

src/main/java/cn/infstar/essentialsC/commands/TpaCommand.java

@@ -0,0 +1,108 @@
+package cn.infstar.essentialsC.commands;
+
+import cn.infstar.essentialsC.teleport.TeleportRequestManager;
+import org.bukkit.Bukkit;
+import org.bukkit.command.Command;
+import org.bukkit.command.CommandSender;
+import org.bukkit.command.TabCompleter;
+import org.bukkit.entity.Player;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+
+public class TpaCommand extends BaseCommand implements TabCompleter {
+
+    public TpaCommand() {
+        super("essentialsc.command.tpa");
+    }
+
+    @Override
+    protected boolean execute(Player player, String[] args) {
+        return sendRequest(player, args, TeleportRequestManager.TeleportRequest.Type.TPA);
+    }
+
+    protected boolean sendRequest(Player player, String[] args, TeleportRequestManager.TeleportRequest.Type type) {
+        if (args.length != 1) {
+            player.sendMessage(getLang().getPrefixedComponent(type == TeleportRequestManager.TeleportRequest.Type.TPA
+                ? "tpa.messages.usage-tpa"
+                : "tpa.messages.usage-tpahere"));
+            return true;
+        }
+
+        TeleportRequestManager manager = plugin.getTeleportRequestManager();
+        if (manager == null) {
+            player.sendMessage(getLang().getPrefixedComponent("messages.module-disabled"));
+            return true;
+        }
+        if (manager.isIgnoringRequests(player)) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.ignoring-requests"));
+            return true;
+        }
+
+        if (args[0].equalsIgnoreCase(player.getName())) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.self"));
+            return true;
+        }
+
+        int remainingCooldown = manager.getRemainingSendCooldownSeconds(player);
+        if (remainingCooldown > 0) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.send-cooldown",
+                Map.of("seconds", String.valueOf(remainingCooldown))));
+            return true;
+        }
+
+        Player target = manager.findOnlinePlayer(args[0], onlinePlayer ->
+            !onlinePlayer.getUniqueId().equals(player.getUniqueId()) && !manager.isVanished(onlinePlayer)
+        ).orElse(null);
+        if (target == null || !target.isOnline()) {
+            player.sendMessage(getLang().getPrefixedComponent("messages.player-not-found", Map.of("player", args[0])));
+            return true;
+        }
+
+        TeleportRequestManager.CreateRequestResult createdRequest = manager.createRequest(player, target, type);
+        if (createdRequest.status() == TeleportRequestManager.CreateRequestStatus.ON_COOLDOWN) {
+            player.sendMessage(getLang().getPrefixedComponent("tpa.messages.send-cooldown",
+                Map.of("seconds", String.valueOf(createdRequest.cooldownSeconds()))));
+            return true;
+        }
+
+        TeleportRequestManager.TeleportRequest request = createdRequest.request();
+        Map<String, String> placeholders = manager.placeholders(request);
+        player.sendMessage(getLang().getPrefixedComponent(type == TeleportRequestManager.TeleportRequest.Type.TPA
+            ? "tpa.messages.sent-tpa"
+            : "tpa.messages.sent-tpahere", placeholders));
+        if (createdRequest.status() == TeleportRequestManager.CreateRequestStatus.IGNORED
+            || createdRequest.status() == TeleportRequestManager.CreateRequestStatus.DUPLICATE) {
+            return true;
+        }
+        target.sendMessage(getLang().getPrefixedComponent(type == TeleportRequestManager.TeleportRequest.Type.TPA
+            ? "tpa.messages.received-tpa"
+            : "tpa.messages.received-tpahere", placeholders));
+        manager.playRequestReceivedSound(target);
+        manager.sendResponseHint(target, placeholders);
+        return true;
+    }
+
+    @Override
+    public List<String> onTabComplete(CommandSender sender, Command command, String label, String[] args) {
+        if (args.length != 1 || !(sender instanceof Player player)) {
+            return List.of();
+        }
+
+        TeleportRequestManager manager = plugin.getTeleportRequestManager();
+        if (manager == null) {
+            return List.of();
+        }
+        String partial = args[0].toLowerCase();
+        List<String> completions = new ArrayList<>();
+        for (Player onlinePlayer : Bukkit.getOnlinePlayers()) {
+            if (!onlinePlayer.getUniqueId().equals(player.getUniqueId())
+                && !manager.isVanished(onlinePlayer)
+                && onlinePlayer.getName().toLowerCase().startsWith(partial)) {
+                completions.add(onlinePlayer.getName());
+            }
+        }
+        return completions;
+    }
+}

src/main/java/cn/infstar/essentialsC/commands/TpaHereCommand.java

@@ -0,0 +1,17 @@
+package cn.infstar.essentialsC.commands;
+
+import cn.infstar.essentialsC.teleport.TeleportRequestManager;
+import org.bukkit.entity.Player;
+
+public final class TpaHereCommand extends TpaCommand {
+
+    public TpaHereCommand() {
+        super();
+        this.permission = "essentialsc.command.tpahere";
+    }
+
+    @Override
+    protected boolean execute(Player player, String[] args) {
+        return sendRequest(player, args, TeleportRequestManager.TeleportRequest.Type.TPAHERE);
+    }
+}

src/main/java/cn/infstar/essentialsC/commands/VanishCommand.java

@@ -1,5 +1,6 @@
 package cn.infstar.essentialsC.commands;
 
+import cn.infstar.essentialsC.EssentialsC;
 import org.bukkit.entity.Player;
 
 import java.util.HashSet;
@@ -20,17 +21,38 @@ public class VanishCommand extends BaseCommand {
 
         if (vanishedPlayers.contains(uuid)) {
             vanishedPlayers.remove(uuid);
-            showPlayerToAll(player);
+            showPlayerToAll(plugin, player);
             player.sendMessage(getLang().getPrefixedString("messages.vanish-disabled"));
         } else {
             vanishedPlayers.add(uuid);
-            hidePlayerFromAll(player);
+            hidePlayerFromAll(plugin, player);
             player.sendMessage(getLang().getPrefixedString("messages.vanish-enabled"));
         }
         return true;
     }
 
-    private void hidePlayerFromAll(Player player) {
+    public static void hideVanishedPlayersFrom(EssentialsC plugin, Player observer) {
+        for (Player vanished : plugin.getServer().getOnlinePlayers()) {
+            if (!observer.equals(vanished) && isVanished(vanished)) {
+                observer.hidePlayer(plugin, vanished);
+            }
+        }
+    }
+
+    public static void removeVanished(Player player) {
+        vanishedPlayers.remove(player.getUniqueId());
+    }
+
+    public static void clearAll(EssentialsC plugin) {
+        for (Player player : plugin.getServer().getOnlinePlayers()) {
+            if (isVanished(player)) {
+                showPlayerToAll(plugin, player);
+            }
+        }
+        vanishedPlayers.clear();
+    }
+
+    private static void hidePlayerFromAll(EssentialsC plugin, Player player) {
         for (Player online : player.getServer().getOnlinePlayers()) {
             if (online != player) {
                 online.hidePlayer(plugin, player);
@@ -38,7 +60,7 @@ public class VanishCommand extends BaseCommand {
         }
     }
 
-    private void showPlayerToAll(Player player) {
+    private static void showPlayerToAll(EssentialsC plugin, Player player) {
         for (Player online : player.getServer().getOnlinePlayers()) {
             if (online != player) {
                 online.showPlayer(plugin, player);

src/main/java/cn/infstar/essentialsC/commands/WorkbenchCommand.java

@@ -13,7 +13,7 @@ public class WorkbenchCommand extends BaseCommand {
     @Override
     protected boolean execute(Player player, String[] args) {
         player.openWorkbench(null, true);
-        playBlockShortcutSound(player, Material.CRAFTING_TABLE, Sound.BLOCK_CRAFTER_CRAFT);
+        playBlockShortcutSound(player, Material.CRAFTING_TABLE, Sound.UI_BUTTON_CLICK);
         return true;
     }
 }

src/main/java/cn/infstar/essentialsC/listeners/JeiRecipeSyncListener.java

@@ -1,27 +1,15 @@
 package cn.infstar.essentialsC.listeners;
 
 import cn.infstar.essentialsC.EssentialsC;
-import io.netty.buffer.Unpooled;
-import net.minecraft.core.registries.BuiltInRegistries;
-import net.minecraft.network.RegistryFriendlyByteBuf;
-import net.minecraft.network.protocol.common.ClientboundCustomPayloadPacket;
-import net.minecraft.network.protocol.common.custom.DiscardedPayload;
-import net.minecraft.resources.Identifier;
-import net.minecraft.server.MinecraftServer;
-import net.minecraft.server.level.ServerPlayer;
-import net.minecraft.world.item.crafting.RecipeHolder;
-import net.minecraft.world.item.crafting.RecipeMap;
-import net.minecraft.world.item.crafting.RecipeSerializer;
+import cn.infstar.essentialsC.compat.jei.JeiRecipeSyncAdapter;
 import org.bukkit.configuration.file.FileConfiguration;
-import org.bukkit.craftbukkit.entity.CraftPlayer;
 import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.Listener;
 import org.bukkit.event.player.PlayerJoinEvent;
 
-import java.util.ArrayList;
-import java.util.HashSet;
-import java.util.List;
+import java.util.Locale;
+import java.util.logging.Level;
 
 /**
  * 为 Fabric / NeoForge 客户端补发配方同步数据，修复 1.21.2+ 的 JEI 配方显示问题。
@@ -32,14 +20,22 @@ public class JeiRecipeSyncListener implements Listener {
     private final boolean enabled;
     private final boolean debug;
     private final boolean sendPlayerMessage;
+    private final int brandCheckDelayTicks;
+    private final JeiRecipeSyncAdapter adapter;
 
     public JeiRecipeSyncListener(EssentialsC plugin) {
         this.plugin = plugin;
 
         FileConfiguration config = plugin.getConfig();
+        config.addDefault("jei-sync.brand-check-delay-ticks", 20);
+        config.options().copyDefaults(true);
+        plugin.saveConfig();
+
         this.enabled = config.getBoolean("jei-sync.enabled", true);
-        this.debug = config.getBoolean("jei-sync.debug", false);
+        this.debug = config.getBoolean("debug", false);
         this.sendPlayerMessage = config.getBoolean("jei-sync.send-player-message", true);
+        this.brandCheckDelayTicks = Math.max(0, config.getInt("jei-sync.brand-check-delay-ticks", 20));
+        this.adapter = loadAdapter();
     }
 
     @EventHandler
@@ -47,16 +43,28 @@ public class JeiRecipeSyncListener implements Listener {
         if (!enabled) {
             return;
         }
+        if (adapter == null) {
+            if (debug) {
+                plugin.getLogger().warning("当前服务端版本没有可用的 JEI 配方同步适配器。");
+            }
+            return;
+        }
 
         Player player = event.getPlayer();
+        plugin.getServer().getScheduler().runTaskLater(plugin, () -> detectAndSync(player), brandCheckDelayTicks);
+    }
+
+    private void detectAndSync(Player player) {
+        if (!player.isOnline()) {
+            return;
+        }
+
         String clientBrand = player.getClientBrandName();
 
         if (debug) {
-            plugin.getLogger().info("========================================");
-            plugin.getLogger().info("玩家 " + player.getName() + " 加入");
-            plugin.getLogger().info("客户端品牌: '" + (clientBrand != null ? clientBrand : "null") + "'");
-            plugin.getLogger().info("JEI 同步功能: " + (enabled ? "启用" : "禁用"));
-            plugin.getLogger().info("========================================");
+            plugin.getLogger().info("JEI 客户端检测: player=" + player.getName()
+                + ", brand=" + (clientBrand == null || clientBrand.isBlank() ? "unknown" : clientBrand)
+                + ", delayTicks=" + brandCheckDelayTicks);
         }
 
         if (clientBrand == null || clientBrand.isEmpty()) {
@@ -66,7 +74,7 @@ public class JeiRecipeSyncListener implements Listener {
             return;
         }
 
-        String brandLower = clientBrand.toLowerCase();
+        String brandLower = clientBrand.toLowerCase(Locale.ROOT);
         if (brandLower.contains("fabric")) {
             if (debug) {
                 plugin.getLogger().info("检测到 Fabric 客户端，开始发送配方同步...");
@@ -104,233 +112,50 @@ public class JeiRecipeSyncListener implements Listener {
             return;
         }
 
-        String fullMessage = EssentialsC.getLangManager().getPrefixedString(messageKey);
-        net.kyori.adventure.text.Component component =
-            net.kyori.adventure.text.serializer.legacy.LegacyComponentSerializer.legacyAmpersand().deserialize(fullMessage);
-        player.sendMessage(component);
+        player.sendMessage(EssentialsC.getLangManager().getPrefixedComponent(messageKey));
     }
 
-    @SuppressWarnings({"unchecked", "deprecation"})
     private void sendFabricRecipeSync(Player player) {
         try {
-            ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
-            MinecraftServer server = serverPlayer.level().getServer();
-            if (server == null) {
-                if (debug) {
-                    plugin.getLogger().warning("服务端实例为 null");
-                }
-                return;
-            }
-
-            RecipeMap recipeMap = server.getRecipeManager().recipes;
-            if (debug) {
-                plugin.getLogger().info("开始构建 Fabric 配方数据");
-            }
-
-            var list = new ArrayList<FabricRecipeEntry>();
-            var seen = new HashSet<RecipeSerializer<?>>();
-
-            for (RecipeSerializer<?> serializer : BuiltInRegistries.RECIPE_SERIALIZER) {
-                if (!seen.add(serializer)) {
-                    continue;
-                }
-
-                List<RecipeHolder<?>> recipes = new ArrayList<>();
-                for (RecipeHolder<?> holder : recipeMap.values()) {
-                    if (holder.value().getSerializer() == serializer) {
-                        recipes.add(holder);
-                    }
-                }
-
-                if (!recipes.isEmpty()) {
-                    RecipeSerializer<?> entrySerializer = recipes.get(0).value().getSerializer();
-                    list.add(new FabricRecipeEntry(entrySerializer, recipes));
-                }
-            }
-
-            var payload = new FabricRecipeSyncPayload(list);
-            if (debug) {
-                plugin.getLogger().info("Fabric 配方条目数: " + list.size());
-            }
-
-            RegistryFriendlyByteBuf buffer = new RegistryFriendlyByteBuf(Unpooled.buffer(), server.registryAccess());
-            getFabricCodec().encode(buffer, payload);
-
-            byte[] bytes = new byte[buffer.writerIndex()];
-            buffer.getBytes(0, bytes);
-
-            Identifier id = Identifier.fromNamespaceAndPath("fabric", "recipe_sync");
-            DiscardedPayload discardedPayload = new DiscardedPayload(id, bytes);
-            serverPlayer.connection.send(new ClientboundCustomPayloadPacket(discardedPayload));
-
-            if (debug) {
-                plugin.getLogger().info("已发送 Fabric 配方同步 [" + id + "], 大小: " + bytes.length + " bytes");
-            }
+            adapter.sendFabricRecipeSync(player, plugin.getLogger(), debug);
         } catch (Exception e) {
             plugin.getLogger().warning("发送 Fabric 配方同步失败: " + e.getMessage());
-            e.printStackTrace();
+            if (debug) {
+                plugin.getLogger().log(Level.WARNING, "Fabric 配方同步异常详情", e);
+            }
         }
     }
 
-    @SuppressWarnings({"unchecked", "deprecation"})
-    private net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, FabricRecipeSyncPayload> getFabricCodec() {
-        return FabricRecipeEntry.CODEC.apply(net.minecraft.network.codec.ByteBufCodecs.list())
-            .map(FabricRecipeSyncPayload::new, FabricRecipeSyncPayload::entries);
-    }
-
-    @SuppressWarnings({"unchecked", "deprecation"})
     private void sendNeoForgeRecipeSync(Player player) {
         try {
-            ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
-            MinecraftServer server = serverPlayer.level().getServer();
-            if (server == null) {
-                if (debug) {
-                    plugin.getLogger().warning("服务端实例为 null");
-                }
-                return;
-            }
-
-            RecipeMap recipeMap = server.getRecipeManager().recipes;
-            if (debug) {
-                plugin.getLogger().info("开始构建 NeoForge 配方数据");
-            }
-
-            java.util.List<net.minecraft.world.item.crafting.RecipeType<?>> allRecipeTypes =
-                BuiltInRegistries.RECIPE_TYPE.stream().toList();
-            if (debug) {
-                plugin.getLogger().info("NeoForge 配方类型数: " + allRecipeTypes.size());
-            }
-
-            var payload = createNeoForgePayload(allRecipeTypes, recipeMap);
-            RegistryFriendlyByteBuf buffer = new RegistryFriendlyByteBuf(Unpooled.buffer(), server.registryAccess());
-            getNeoForgeStreamCodec().encode(buffer, payload);
-
-            byte[] bytes = new byte[buffer.writerIndex()];
-            buffer.getBytes(0, bytes);
-
-            Identifier id = Identifier.fromNamespaceAndPath("neoforge", "recipe_content");
-            DiscardedPayload discardedPayload = new DiscardedPayload(id, bytes);
-            serverPlayer.connection.send(new ClientboundCustomPayloadPacket(discardedPayload));
-            serverPlayer.connection.send(new net.minecraft.network.protocol.common.ClientboundUpdateTagsPacket(
-                net.minecraft.tags.TagNetworkSerialization.serializeTagsToNetwork(server.registries())
-            ));
-
-            if (debug) {
-                plugin.getLogger().info("已发送 NeoForge 配方同步 [" + id + "], 大小: " + bytes.length + " bytes");
-            }
+            adapter.sendNeoForgeRecipeSync(player, plugin.getLogger(), debug);
         } catch (Exception e) {
             plugin.getLogger().warning("发送 NeoForge 配方同步失败: " + e.getMessage());
-            e.printStackTrace();
-        }
-    }
-
-    private NeoForgeRecipeSyncPayload createNeoForgePayload(
-        java.util.List<net.minecraft.world.item.crafting.RecipeType<?>> recipeTypes,
-        RecipeMap recipeMap
-    ) {
-        var recipeTypeSet = new java.util.HashSet<>(recipeTypes);
-        if (recipeTypeSet.isEmpty()) {
-            return new NeoForgeRecipeSyncPayload(recipeTypeSet, java.util.List.of());
-        }
-
-        var recipeSubset = recipeMap.values().stream()
-            .filter(h -> recipeTypeSet.contains(h.value().getType()))
-            .toList();
-        return new NeoForgeRecipeSyncPayload(recipeTypeSet, recipeSubset);
-    }
-
-    @SuppressWarnings({"unchecked", "deprecation"})
-    private net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, NeoForgeRecipeSyncPayload> getNeoForgeStreamCodec() {
-        return net.minecraft.network.codec.StreamCodec.composite(
-            net.minecraft.network.codec.ByteBufCodecs.registry(net.minecraft.core.registries.Registries.RECIPE_TYPE)
-                .apply(net.minecraft.network.codec.ByteBufCodecs.collection(java.util.HashSet::new)),
-            NeoForgeRecipeSyncPayload::recipeTypes,
-            RecipeHolder.STREAM_CODEC.apply(net.minecraft.network.codec.ByteBufCodecs.list()),
-            NeoForgeRecipeSyncPayload::recipes,
-            NeoForgeRecipeSyncPayload::new
-        );
-    }
-
-    @SuppressWarnings("deprecation")
-    private static class FabricRecipeEntry {
-        // 这里保留 Object，是为了避免直接绑定易变的 NMS 泛型签名。
-        final Object serializer;
-        final List<RecipeHolder<?>> recipes;
-
-        FabricRecipeEntry(Object serializer, List<RecipeHolder<?>> recipes) {
-            this.serializer = serializer;
-            this.recipes = recipes;
-        }
-
-        static final net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, FabricRecipeEntry> CODEC =
-            net.minecraft.network.codec.StreamCodec.ofMember(
-                FabricRecipeEntry::write,
-                FabricRecipeEntry::read
-            );
-
-        @SuppressWarnings("unchecked")
-        private static FabricRecipeEntry read(RegistryFriendlyByteBuf buf) {
-            Identifier recipeSerializerId = buf.readIdentifier();
-            RecipeSerializer<?> recipeSerializer = BuiltInRegistries.RECIPE_SERIALIZER.getValue(recipeSerializerId);
-
-            if (recipeSerializer == null) {
-                throw new RuntimeException("Tried syncing unsupported packet serializer '" + recipeSerializerId + "'!");
+            if (debug) {
+                plugin.getLogger().log(Level.WARNING, "NeoForge 配方同步异常详情", e);
             }
+        }
+    }
 
-            int count = buf.readVarInt();
-            var list = new ArrayList<RecipeHolder<?>>();
-            for (int i = 0; i < count; i++) {
-                net.minecraft.resources.ResourceKey<net.minecraft.world.item.crafting.Recipe<?>> id =
-                    buf.readResourceKey(net.minecraft.core.registries.Registries.RECIPE);
-
-                try {
-                    var streamCodecMethod = recipeSerializer.getClass().getMethod("streamCodec");
-                    var streamCodec = streamCodecMethod.invoke(recipeSerializer);
-                    net.minecraft.world.item.crafting.Recipe<?> recipe =
-                        ((net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, net.minecraft.world.item.crafting.Recipe<?>>) streamCodec)
-                            .decode(buf);
-                    list.add(new RecipeHolder<>(id, recipe));
-                } catch (Exception e) {
-                    throw new RuntimeException("Failed to decode recipe: " + e.getMessage(), e);
+    private JeiRecipeSyncAdapter loadAdapter() {
+        String versionKey = plugin.getServer().getBukkitVersion().split("-")[0]
+            .replace('.', '_');
+        String className = "cn.infstar.essentialsC.v" + versionKey + ".jei.JeiRecipeSyncAdapterImpl";
+        try {
+            Class<?> adapterClass = Class.forName(className);
+            Object instance = adapterClass.getDeclaredConstructor().newInstance();
+            if (instance instanceof JeiRecipeSyncAdapter jeiRecipeSyncAdapter) {
+                if (debug) {
+                    plugin.getLogger().info("已加载 JEI 配方同步适配器: " + className);
                 }
+                return jeiRecipeSyncAdapter;
             }
-
-            return new FabricRecipeEntry(recipeSerializer, list);
-        }
-
-        private void write(RegistryFriendlyByteBuf buf) {
-            try {
-                var getKeyMethod = BuiltInRegistries.RECIPE_SERIALIZER.getClass().getMethod("getKey", Object.class);
-                Identifier identifier = (Identifier) getKeyMethod.invoke(BuiltInRegistries.RECIPE_SERIALIZER, this.serializer);
-                buf.writeIdentifier(identifier);
-            } catch (Exception e) {
-                throw new RuntimeException("Failed to get serializer key: " + e.getMessage(), e);
-            }
-
-            buf.writeVarInt(this.recipes.size());
-
-            try {
-                var streamCodecMethod = this.serializer.getClass().getMethod("streamCodec");
-                @SuppressWarnings("unchecked")
-                var codec = (net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, net.minecraft.world.item.crafting.Recipe<?>>)
-                    streamCodecMethod.invoke(this.serializer);
-
-                for (RecipeHolder<?> recipe : this.recipes) {
-                    buf.writeResourceKey(recipe.id());
-                    codec.encode(buf, recipe.value());
-                }
-            } catch (Exception e) {
-                throw new RuntimeException("Failed to encode recipe: " + e.getMessage(), e);
+            plugin.getLogger().warning("JEI 配方同步适配器类型无效: " + className);
+        } catch (ReflectiveOperationException | LinkageError e) {
+            if (debug) {
+                plugin.getLogger().warning("加载 JEI 配方同步适配器失败: " + className + " (" + e.getMessage() + ")");
             }
         }
-    }
-
-    private record FabricRecipeSyncPayload(List<FabricRecipeEntry> entries) {
-    }
-
-    private record NeoForgeRecipeSyncPayload(
-        java.util.Set<net.minecraft.world.item.crafting.RecipeType<?>> recipeTypes,
-        java.util.List<RecipeHolder<?>> recipes
-    ) {
+        return null;
     }
 }

src/main/java/cn/infstar/essentialsC/listeners/VanishListener.java

@@ -0,0 +1,29 @@
+package cn.infstar.essentialsC.listeners;
+
+import cn.infstar.essentialsC.EssentialsC;
+import cn.infstar.essentialsC.commands.VanishCommand;
+import org.bukkit.entity.Player;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.player.PlayerJoinEvent;
+import org.bukkit.event.player.PlayerQuitEvent;
+
+public final class VanishListener implements Listener {
+
+    private final EssentialsC plugin;
+
+    public VanishListener(EssentialsC plugin) {
+        this.plugin = plugin;
+    }
+
+    @EventHandler
+    public void onPlayerJoin(PlayerJoinEvent event) {
+        VanishCommand.hideVanishedPlayersFrom(plugin, event.getPlayer());
+    }
+
+    @EventHandler
+    public void onPlayerQuit(PlayerQuitEvent event) {
+        Player player = event.getPlayer();
+        VanishCommand.removeVanished(player);
+    }
+}

src/main/java/cn/infstar/essentialsC/maintenance/MaintenanceListener.java

@@ -2,6 +2,7 @@ package cn.infstar.essentialsC.maintenance;
 
 import cn.infstar.essentialsC.EssentialsC;
 import cn.infstar.essentialsC.ModuleManager;
+import org.bukkit.entity.Player;
 import org.bukkit.event.EventHandler;
 import org.bukkit.event.Listener;
 import org.bukkit.event.player.PlayerLoginEvent;
@@ -9,6 +10,9 @@ import org.bukkit.event.player.PlayerJoinEvent;
 import org.bukkit.event.player.PlayerQuitEvent;
 import org.bukkit.event.server.ServerListPingEvent;
 
+import java.net.InetAddress;
+import java.util.Map;
+
 public final class MaintenanceListener implements Listener {
 
     private final EssentialsC plugin;
@@ -39,11 +43,12 @@ public final class MaintenanceListener implements Listener {
             return;
         }
 
-        if (event.getPlayer().hasPermission(maintenanceManager.getBypassPermission())) {
+        if (maintenanceManager.canJoin(event.getPlayer())) {
             return;
         }
 
         event.disallow(PlayerLoginEvent.Result.KICK_OTHER, maintenanceManager.getKickMessage());
+        notifyBlockedLogin(event, maintenanceManager);
     }
 
     @EventHandler
@@ -63,4 +68,29 @@ public final class MaintenanceListener implements Listener {
             maintenanceManager.removeBossBarPlayer(event.getPlayer());
         }
     }
+
+    private void notifyBlockedLogin(PlayerLoginEvent event, MaintenanceManager maintenanceManager) {
+        if (!maintenanceManager.isNotifyEnabled()) {
+            return;
+        }
+
+        String address = "";
+        InetAddress inetAddress = event.getAddress();
+        if (inetAddress != null) {
+            address = inetAddress.getHostAddress();
+        }
+
+        String message = EssentialsC.getLangManager().getPrefixedString("maintenance.messages.login-blocked",
+            Map.of(
+                "player", event.getPlayer().getName(),
+                "uuid", event.getPlayer().getUniqueId().toString(),
+                "address", address
+            ));
+
+        for (Player player : plugin.getServer().getOnlinePlayers()) {
+            if (player.hasPermission(maintenanceManager.getNotifyPermission())) {
+                player.sendMessage(message);
+            }
+        }
+    }
 }

src/main/java/cn/infstar/essentialsC/maintenance/MaintenanceManager.java

@@ -11,8 +11,12 @@ import org.bukkit.entity.Player;
 
 import java.io.File;
 import java.io.IOException;
+import java.util.ArrayList;
+import java.util.LinkedHashSet;
 import java.util.List;
 import java.util.Locale;
+import java.util.Set;
+import java.util.UUID;
 
 public final class MaintenanceManager {
 
@@ -38,6 +42,10 @@ public final class MaintenanceManager {
         config.addDefault("config-version", CURRENT_CONFIG_VERSION);
         config.addDefault("enabled", false);
         config.addDefault("bypass-permission", "essentialsc.maintenance.bypass");
+        config.addDefault("notify.enabled", true);
+        config.addDefault("notify.permission", "essentialsc.maintenance.notify");
+        config.addDefault("whitelist.uuids", List.of());
+        config.addDefault("whitelist.names", List.of());
         config.addDefault("motd.enabled", true);
         config.addDefault("motd.lines", List.of("&c服务器维护中", "&7请稍后再试"));
         config.addDefault("kick-message", List.of("&c服务器正在维护", "&7请稍后再进入"));
@@ -65,6 +73,66 @@ public final class MaintenanceManager {
         return config.getString("bypass-permission", "essentialsc.maintenance.bypass");
     }
 
+    public boolean isNotifyEnabled() {
+        return config.getBoolean("notify.enabled", true);
+    }
+
+    public String getNotifyPermission() {
+        return config.getString("notify.permission", "essentialsc.maintenance.notify");
+    }
+
+    public boolean canJoin(Player player) {
+        return player != null && (player.hasPermission(getBypassPermission()) || isWhitelisted(player));
+    }
+
+    public boolean isWhitelisted(Player player) {
+        if (player == null) {
+            return false;
+        }
+
+        return getWhitelistUuids().contains(player.getUniqueId().toString().toLowerCase(Locale.ROOT))
+            || getWhitelistNames().contains(normalizeName(player.getName()));
+    }
+
+    public boolean addWhitelistEntry(String input) {
+        String normalized = normalizeEntry(input);
+        if (normalized.isEmpty()) {
+            return false;
+        }
+
+        UUID uuid = parseUuid(normalized);
+        if (uuid != null) {
+            return addWhitelistUuid(uuid.toString());
+        }
+
+        return addWhitelistName(input);
+    }
+
+    public boolean removeWhitelistEntry(String input) {
+        String normalized = normalizeEntry(input);
+        if (normalized.isEmpty()) {
+            return false;
+        }
+
+        UUID uuid = parseUuid(normalized);
+        if (uuid != null) {
+            return removeWhitelistUuid(uuid.toString());
+        }
+
+        return removeWhitelistName(input);
+    }
+
+    public List<String> getWhitelistEntries() {
+        List<String> entries = new ArrayList<>();
+        entries.addAll(getWhitelistNames());
+        entries.addAll(getWhitelistUuids());
+        return entries;
+    }
+
+    public int getWhitelistCount() {
+        return getWhitelistEntries().size();
+    }
+
     public boolean isMotdEnabled() {
         return config.getBoolean("motd.enabled", true);
     }
@@ -100,7 +168,7 @@ public final class MaintenanceManager {
         if (bossBar == null || player == null || !player.isOnline()) {
             return;
         }
-        if (player.hasPermission(getBypassPermission())) {
+        if (canJoin(player)) {
             bossBar.removePlayer(player);
             return;
         }
@@ -154,6 +222,81 @@ public final class MaintenanceManager {
         return Math.max(0.0D, Math.min(1.0D, progress));
     }
 
+    private boolean addWhitelistUuid(String uuid) {
+        return updateWhitelist("whitelist.uuids", uuid.toLowerCase(Locale.ROOT), true);
+    }
+
+    private boolean addWhitelistName(String name) {
+        return updateWhitelist("whitelist.names", normalizeName(name), true);
+    }
+
+    private boolean removeWhitelistUuid(String uuid) {
+        return updateWhitelist("whitelist.uuids", uuid.toLowerCase(Locale.ROOT), false);
+    }
+
+    private boolean removeWhitelistName(String name) {
+        return updateWhitelist("whitelist.names", normalizeName(name), false);
+    }
+
+    private boolean updateWhitelist(String path, String value, boolean add) {
+        if (value == null || value.isBlank()) {
+            return false;
+        }
+
+        Set<String> entries = path.endsWith(".names") ? getWhitelistNames() : getWhitelistUuids();
+        boolean changed;
+        if (add) {
+            changed = entries.add(value);
+        } else {
+            changed = entries.remove(value);
+        }
+
+        if (changed) {
+            config.set(path, new ArrayList<>(entries));
+            save();
+            refreshBossBar();
+        }
+        return changed;
+    }
+
+    private Set<String> getWhitelistUuids() {
+        Set<String> entries = new LinkedHashSet<>();
+        for (String value : config.getStringList("whitelist.uuids")) {
+            String normalized = normalizeEntry(value).toLowerCase(Locale.ROOT);
+            if (!normalized.isEmpty()) {
+                entries.add(normalized);
+            }
+        }
+        return entries;
+    }
+
+    private Set<String> getWhitelistNames() {
+        Set<String> entries = new LinkedHashSet<>();
+        for (String value : config.getStringList("whitelist.names")) {
+            String normalized = normalizeName(value);
+            if (!normalized.isEmpty()) {
+                entries.add(normalized);
+            }
+        }
+        return entries;
+    }
+
+    private UUID parseUuid(String input) {
+        try {
+            return UUID.fromString(input);
+        } catch (IllegalArgumentException ignored) {
+            return null;
+        }
+    }
+
+    private String normalizeEntry(String input) {
+        return input == null ? "" : input.trim();
+    }
+
+    private String normalizeName(String input) {
+        return normalizeEntry(input).toLowerCase(Locale.ROOT);
+    }
+
     private String colorizeLines(List<String> lines) {
         if (lines == null || lines.isEmpty()) {
             return "";

src/main/java/cn/infstar/essentialsC/skinbridge/MineSkinGateway.java

@@ -0,0 +1,179 @@
+package cn.infstar.essentialsC.skinbridge;
+
+import com.destroystokyo.paper.profile.PlayerProfile;
+import com.destroystokyo.paper.profile.ProfileProperty;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonParser;
+import org.bukkit.entity.Player;
+
+import java.net.URI;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.nio.charset.StandardCharsets;
+import java.time.Duration;
+
+public final class MineSkinGateway implements SkinBridgeGateway {
+
+    private static final String TEXTURES_PROPERTY = "textures";
+    private static final String QUEUE_PATH = "/v2/queue";
+    private static final long POLL_INTERVAL_MILLIS = 1000L;
+
+    private final HttpClient httpClient;
+    private final URI queueUri;
+    private final String apiKey;
+    private final String visibility;
+    private final int timeoutSeconds;
+    private final String userAgent;
+
+    public MineSkinGateway(HttpClient httpClient, String endpoint, String apiKey, String visibility, int timeoutSeconds, String userAgent) {
+        this.httpClient = httpClient;
+        this.queueUri = URI.create(normalizeEndpoint(endpoint) + QUEUE_PATH);
+        this.apiKey = apiKey;
+        this.visibility = normalizeVisibility(visibility);
+        this.timeoutSeconds = timeoutSeconds;
+        this.userAgent = userAgent;
+    }
+
+    @Override
+    public GeneratedSkin generateSkin(String skinUrl, SkinModel model) throws Exception {
+        JsonObject requestBody = new JsonObject();
+        requestBody.addProperty("url", skinUrl);
+        requestBody.addProperty("variant", model == SkinModel.SLIM ? "slim" : "classic");
+        requestBody.addProperty("visibility", visibility);
+
+        HttpResponse<String> response = send(HttpRequest.newBuilder(queueUri)
+            .POST(HttpRequest.BodyPublishers.ofString(requestBody.toString(), StandardCharsets.UTF_8))
+            .header("Content-Type", "application/json"));
+        JsonObject body = parseResponse(response);
+        if (response.statusCode() == 200) {
+            return parseGeneratedSkin(body);
+        }
+        if (response.statusCode() != 202) {
+            throw apiError("提交 MineSkin 生成请求", response, body);
+        }
+
+        JsonObject job = object(body, "job");
+        String jobId = string(job, "id");
+        return pollJob(jobId);
+    }
+
+    @Override
+    public void applySkin(Player player, GeneratedSkin skin) {
+        PlayerProfile profile = player.getPlayerProfile();
+        profile.removeProperty(TEXTURES_PROPERTY);
+        profile.setProperty(new ProfileProperty(TEXTURES_PROPERTY, skin.value(), skin.signature()));
+        player.setPlayerProfile(profile);
+    }
+
+    private GeneratedSkin pollJob(String jobId) throws Exception {
+        long deadline = System.nanoTime() + Duration.ofSeconds(timeoutSeconds).toNanos();
+        URI jobUri = URI.create(queueUri + "/" + jobId);
+        while (System.nanoTime() < deadline) {
+            HttpResponse<String> response = send(HttpRequest.newBuilder(jobUri).GET());
+            JsonObject body = parseResponse(response);
+            if (response.statusCode() != 200) {
+                throw apiError("查询 MineSkin 生成任务", response, body);
+            }
+
+            JsonObject job = object(body, "job");
+            String status = string(job, "status");
+            if ("completed".equalsIgnoreCase(status)) {
+                return parseGeneratedSkin(body);
+            }
+            if ("failed".equalsIgnoreCase(status)) {
+                throw new IllegalStateException("MineSkin 生成任务失败: " + errorMessage(body));
+            }
+            if (!"waiting".equalsIgnoreCase(status) && !"active".equalsIgnoreCase(status)) {
+                throw new IllegalStateException("MineSkin 返回未知任务状态: " + status);
+            }
+            Thread.sleep(POLL_INTERVAL_MILLIS);
+        }
+        throw new IllegalStateException("MineSkin 生成任务超时，请增大 skin-bridge.yml 中的 mineskin.request-timeout-seconds。");
+    }
+
+    private HttpResponse<String> send(HttpRequest.Builder builder) throws Exception {
+        HttpRequest request = builder
+            .timeout(Duration.ofSeconds(timeoutSeconds))
+            .header("Accept", "application/json")
+            .header("Authorization", "Bearer " + apiKey)
+            .header("User-Agent", userAgent)
+            .build();
+        return httpClient.send(request, HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8));
+    }
+
+    private JsonObject parseResponse(HttpResponse<String> response) {
+        if (response.body() == null || response.body().isBlank()) {
+            throw new IllegalStateException("MineSkin 返回空响应，HTTP " + response.statusCode());
+        }
+        if (response.body().length() > 1_048_576) {
+            throw new IllegalStateException("MineSkin 响应超过 1 MiB 限制。");
+        }
+        try {
+            return JsonParser.parseString(response.body()).getAsJsonObject();
+        } catch (RuntimeException exception) {
+            throw new IllegalStateException("MineSkin 返回了无效 JSON，HTTP " + response.statusCode(), exception);
+        }
+    }
+
+    private GeneratedSkin parseGeneratedSkin(JsonObject body) {
+        JsonObject skin = object(body, "skin");
+        JsonObject texture = object(skin, "texture");
+        JsonObject data = object(texture, "data");
+        return new GeneratedSkin(string(data, "value"), string(data, "signature"));
+    }
+
+    private IllegalStateException apiError(String action, HttpResponse<String> response, JsonObject body) {
+        return new IllegalStateException(action + "失败，HTTP " + response.statusCode() + ": " + errorMessage(body));
+    }
+
+    private String errorMessage(JsonObject body) {
+        for (String key : new String[]{"message", "error", "code"}) {
+            if (body.has(key) && body.get(key).isJsonPrimitive()) {
+                return body.get(key).getAsString();
+            }
+        }
+        return "未提供错误信息";
+    }
+
+    private static JsonObject object(JsonObject parent, String key) {
+        if (!parent.has(key) || !parent.get(key).isJsonObject()) {
+            throw new IllegalStateException("MineSkin 响应缺少对象字段: " + key);
+        }
+        return parent.getAsJsonObject(key);
+    }
+
+    private static String string(JsonObject parent, String key) {
+        if (!parent.has(key) || !parent.get(key).isJsonPrimitive()) {
+            throw new IllegalStateException("MineSkin 响应缺少字符串字段: " + key);
+        }
+        String value = parent.get(key).getAsString();
+        if (value.isBlank()) {
+            throw new IllegalStateException("MineSkin 响应字符串字段为空: " + key);
+        }
+        return value;
+    }
+
+    private static String normalizeEndpoint(String endpoint) {
+        String normalized = endpoint == null ? "" : endpoint.trim();
+        while (normalized.endsWith("/")) {
+            normalized = normalized.substring(0, normalized.length() - 1);
+        }
+        if (normalized.isBlank()) {
+            throw new IllegalArgumentException("MineSkin API 地址不能为空。");
+        }
+        URI uri = URI.create(normalized);
+        if (!"https".equalsIgnoreCase(uri.getScheme())) {
+            throw new IllegalArgumentException("MineSkin API 必须使用 HTTPS。");
+        }
+        return normalized;
+    }
+
+    private static String normalizeVisibility(String visibility) {
+        String normalized = visibility == null ? "" : visibility.trim().toLowerCase(java.util.Locale.ROOT);
+        if (!normalized.equals("public") && !normalized.equals("unlisted") && !normalized.equals("private")) {
+            throw new IllegalArgumentException("MineSkin visibility 必须是 public、unlisted 或 private。");
+        }
+        return normalized;
+    }
+}

src/main/java/cn/infstar/essentialsC/skinbridge/SkinBridgeGateway.java

@@ -0,0 +1,18 @@
+package cn.infstar.essentialsC.skinbridge;
+
+import org.bukkit.entity.Player;
+
+interface SkinBridgeGateway {
+
+    GeneratedSkin generateSkin(String skinUrl, SkinModel model) throws Exception;
+
+    void applySkin(Player player, GeneratedSkin skin) throws Exception;
+}
+
+enum SkinModel {
+    CLASSIC,
+    SLIM
+}
+
+record GeneratedSkin(String value, String signature) {
+}

src/main/java/cn/infstar/essentialsC/skinbridge/SkinBridgeManager.java

@@ -0,0 +1,491 @@
+package cn.infstar.essentialsC.skinbridge;
+
+import cn.infstar.essentialsC.EssentialsC;
+import com.google.gson.JsonArray;
+import com.google.gson.JsonElement;
+import com.google.gson.JsonObject;
+import com.google.gson.JsonParser;
+import org.bukkit.Bukkit;
+import org.bukkit.configuration.ConfigurationSection;
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.entity.Player;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.Listener;
+import org.bukkit.event.player.PlayerJoinEvent;
+
+import java.net.URI;
+import java.net.http.HttpClient;
+import java.net.http.HttpRequest;
+import java.net.http.HttpResponse;
+import java.nio.charset.StandardCharsets;
+import java.time.Duration;
+import java.util.ArrayList;
+import java.util.Base64;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.UUID;
+import java.util.concurrent.ConcurrentHashMap;
+import java.util.concurrent.ConcurrentMap;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+import java.util.concurrent.ThreadFactory;
+import java.util.concurrent.atomic.AtomicLong;
+
+public final class SkinBridgeManager implements Listener {
+
+    private final EssentialsC plugin;
+    private final HttpClient httpClient;
+    private final ExecutorService executor;
+    private final ConcurrentMap<UUID, CachedLookup> cache = new ConcurrentHashMap<>();
+    private final ConcurrentMap<UUID, Long> pendingLookups = new ConcurrentHashMap<>();
+    private final AtomicLong configurationGeneration = new AtomicLong();
+
+    private volatile List<SkinProvider> providers = List.of();
+    private volatile SkinBridgeGateway gateway;
+    private volatile boolean enabled;
+    private volatile boolean debug;
+    private volatile boolean sendPlayerMessage;
+    private volatile int requestTimeoutSeconds;
+    private volatile int cacheMinutes;
+    private volatile long joinDelayTicks;
+
+    public SkinBridgeManager(EssentialsC plugin) {
+        this.plugin = plugin;
+        this.httpClient = HttpClient.newBuilder()
+            .connectTimeout(Duration.ofSeconds(5))
+            .followRedirects(HttpClient.Redirect.NEVER)
+            .build();
+        this.executor = Executors.newFixedThreadPool(2, new SkinBridgeThreadFactory());
+        reload();
+    }
+
+    public void reload() {
+        configurationGeneration.incrementAndGet();
+        FileConfiguration config = plugin.getFeatureConfigManager().getSkinBridgeConfig();
+        addDefaults(config);
+        config.options().copyDefaults(true);
+        plugin.getFeatureConfigManager().saveSkinBridgeConfig();
+
+        enabled = config.getBoolean("enabled", false);
+        debug = plugin.getConfig().getBoolean("debug", false);
+        sendPlayerMessage = config.getBoolean("send-player-message", true);
+        requestTimeoutSeconds = clamp(config.getInt("profile-request-timeout-seconds", 5), 1, 30);
+        String mineSkinEndpoint = config.getString("mineskin.endpoint", "https://api.mineskin.org");
+        String mineSkinApiKey = config.getString("mineskin.api-key", "").trim();
+        String mineSkinVisibility = config.getString("mineskin.visibility", "unlisted");
+        int mineSkinTimeoutSeconds = clamp(config.getInt("mineskin.request-timeout-seconds", 30), 10, 180);
+        cacheMinutes = clamp(config.getInt("cache-minutes", 120), 5, 10080);
+        joinDelayTicks = clamp(config.getLong("join-delay-ticks", 20L), 0, 200);
+        providers = loadProviders(config);
+        cache.clear();
+        gateway = loadGateway(mineSkinEndpoint, mineSkinApiKey, mineSkinVisibility, mineSkinTimeoutSeconds);
+
+        if (enabled && gateway == null) {
+            plugin.getLogger().warning("SkinBridge 已启用，但未配置有效的 MineSkin API Key，皮肤同步不会执行。");
+        }
+    }
+
+    public void shutdown() {
+        configurationGeneration.incrementAndGet();
+        cache.clear();
+        pendingLookups.clear();
+        executor.shutdownNow();
+    }
+
+    @EventHandler
+    public void onPlayerJoin(PlayerJoinEvent event) {
+        queueSync(event.getPlayer(), false);
+    }
+
+    public SyncResult queueSync(Player player, boolean force) {
+        if (!enabled) {
+            return SyncResult.FEATURE_DISABLED;
+        }
+        if (gateway == null) {
+            return SyncResult.DEPENDENCY_MISSING;
+        }
+        if (providers.isEmpty()) {
+            return SyncResult.NO_PROVIDERS;
+        }
+
+        UUID playerId = player.getUniqueId();
+        if (force) {
+            cache.remove(playerId);
+        }
+
+        CachedLookup cached = cache.get(playerId);
+        if (!force && cached != null && !cached.hasExpired()) {
+            if (cached.skin() != null) {
+                applySkin(playerId, cached, configurationGeneration.get());
+            }
+            return SyncResult.CACHED;
+        }
+
+        long lookupGeneration = configurationGeneration.get();
+        if (!registerPendingLookup(playerId, lookupGeneration)) {
+            return SyncResult.ALREADY_RUNNING;
+        }
+
+        String playerName = player.getName();
+        Bukkit.getScheduler().runTaskLater(plugin, () -> startLookup(playerId, playerName, lookupGeneration), joinDelayTicks);
+        sendPlayerNotification(playerId, "skin-bridge.notifications.detecting", Map.of());
+        return SyncResult.QUEUED;
+    }
+
+    public Status getStatus(Player player) {
+        CachedLookup cached = cache.get(player.getUniqueId());
+        if (cached != null && !cached.hasExpired()) {
+            return new Status(cached.state(), cached.providerId());
+        }
+        if (pendingLookups.containsKey(player.getUniqueId())) {
+            return new Status(State.PENDING, null);
+        }
+        return new Status(State.UNKNOWN, null);
+    }
+
+    public boolean isEnabled() {
+        return enabled;
+    }
+
+    public boolean isSkinGatewayAvailable() {
+        return gateway != null;
+    }
+
+    public int getProviderCount() {
+        return providers.size();
+    }
+
+    public String getModuleDetail() {
+        if (!enabled) {
+            return "配置未启用";
+        }
+        if (gateway == null) {
+            return "缺少 MineSkin API Key 或配置无效";
+        }
+        if (providers.isEmpty()) {
+            return "未配置有效 Provider";
+        }
+        return providers.size() + " 个 Provider 已就绪";
+    }
+
+    private void startLookup(UUID playerId, String playerName, long lookupGeneration) {
+        if (executor.isShutdown() || lookupGeneration != configurationGeneration.get()) {
+            pendingLookups.remove(playerId, lookupGeneration);
+            return;
+        }
+        executor.execute(() -> {
+            try {
+                CachedLookup resolved = resolve(playerId, playerName);
+                if (lookupGeneration != configurationGeneration.get()) {
+                    return;
+                }
+                cache.put(playerId, resolved);
+                if (resolved.skin() != null) {
+                    applySkin(playerId, resolved, lookupGeneration);
+                } else {
+                    sendPlayerNotification(playerId, "skin-bridge.notifications.not-external", Map.of());
+                    if (debug) {
+                        plugin.getLogger().info("SkinBridge 未识别到外置登录玩家: " + playerName);
+                    }
+                }
+            } catch (Exception exception) {
+                plugin.getLogger().warning("SkinBridge 查询 " + playerName + " 的皮肤资料失败: " + exception.getMessage());
+                sendPlayerNotification(playerId, "skin-bridge.notifications.failed", Map.of());
+                if (debug) {
+                    plugin.getLogger().warning("SkinBridge 异常类型: " + exception.getClass().getName());
+                }
+            } finally {
+                pendingLookups.remove(playerId, lookupGeneration);
+            }
+        });
+    }
+
+    private boolean registerPendingLookup(UUID playerId, long lookupGeneration) {
+        while (true) {
+            Long runningGeneration = pendingLookups.putIfAbsent(playerId, lookupGeneration);
+            if (runningGeneration == null) {
+                return true;
+            }
+            if (runningGeneration == lookupGeneration) {
+                return false;
+            }
+            if (pendingLookups.replace(playerId, runningGeneration, lookupGeneration)) {
+                return true;
+            }
+        }
+    }
+
+    private CachedLookup resolve(UUID playerId, String playerName) throws Exception {
+        Exception lastFailure = null;
+        for (SkinProvider provider : providers) {
+            Optional<ProviderProfile> profile;
+            try {
+                profile = queryProfile(provider, playerId, playerName);
+            } catch (Exception exception) {
+                lastFailure = exception;
+                plugin.getLogger().warning("SkinBridge Provider " + provider.id() + " 查询失败: " + exception.getMessage());
+                continue;
+            }
+            if (profile.isEmpty()) {
+                continue;
+            }
+
+            SkinBridgeGateway currentGateway = gateway;
+            if (currentGateway == null) {
+                throw new IllegalStateException("MineSkin 网关在查询期间不可用。");
+            }
+
+            ProviderProfile matchedProfile = profile.get();
+            GeneratedSkin generatedSkin = currentGateway.generateSkin(matchedProfile.skinUrl(), matchedProfile.model());
+            return cached(provider.id(), generatedSkin, State.EXTERNAL);
+        }
+
+        if (lastFailure != null) {
+            throw new IllegalStateException("所有可用 Provider 均未能完成确认。", lastFailure);
+        }
+        return cached(null, null, State.NOT_EXTERNAL);
+    }
+
+    private Optional<ProviderProfile> queryProfile(SkinProvider provider, UUID playerId, String playerName) throws Exception {
+        URI requestUri = URI.create(provider.resolveProfileUrl(playerId));
+        HttpRequest request = HttpRequest.newBuilder(requestUri)
+            .timeout(Duration.ofSeconds(requestTimeoutSeconds))
+            .header("Accept", "application/json")
+            .header("User-Agent", "EssentialsC/" + plugin.getDescription().getVersion() + " SkinBridge")
+            .GET()
+            .build();
+        HttpResponse<String> response = httpClient.send(request, HttpResponse.BodyHandlers.ofString(StandardCharsets.UTF_8));
+
+        if (response.statusCode() == 204 || response.statusCode() == 404) {
+            return Optional.empty();
+        }
+        if (response.statusCode() != 200) {
+            throw new IllegalStateException(provider.id() + " 返回 HTTP " + response.statusCode());
+        }
+        if (response.body().length() > 1_048_576) {
+            throw new IllegalStateException(provider.id() + " 返回的 profile 超过 1 MiB 限制。");
+        }
+
+        JsonObject profile = JsonParser.parseString(response.body()).getAsJsonObject();
+        String profileId = requireString(profile, "id");
+        String profileName = requireString(profile, "name");
+        if (!normalizeUuid(profileId).equals(normalizeUuid(playerId.toString())) || !profileName.equalsIgnoreCase(playerName)) {
+            if (debug) {
+                plugin.getLogger().warning("SkinBridge 忽略 " + provider.id() + " 的不匹配 profile: " + profileName + " / " + profileId);
+            }
+            return Optional.empty();
+        }
+
+        JsonObject textureData = findTextureData(profile);
+        JsonObject skin = textureData.getAsJsonObject("textures").getAsJsonObject("SKIN");
+        String skinUrl = requireString(skin, "url");
+        URI skinUri = URI.create(skinUrl);
+        if (!"https".equalsIgnoreCase(skinUri.getScheme()) && !"http".equalsIgnoreCase(skinUri.getScheme())) {
+            throw new IllegalStateException(provider.id() + " 返回了不支持的皮肤 URL 协议。");
+        }
+
+        SkinModel model = SkinModel.CLASSIC;
+        JsonObject metadata = skin.has("metadata") && skin.get("metadata").isJsonObject()
+            ? skin.getAsJsonObject("metadata")
+            : null;
+        if (metadata != null && "slim".equalsIgnoreCase(metadata.has("model") ? metadata.get("model").getAsString() : "")) {
+            model = SkinModel.SLIM;
+        }
+        return Optional.of(new ProviderProfile(skinUrl, model));
+    }
+
+    private JsonObject findTextureData(JsonObject profile) {
+        JsonArray properties = profile.has("properties") && profile.get("properties").isJsonArray()
+            ? profile.getAsJsonArray("properties")
+            : new JsonArray();
+        for (JsonElement element : properties) {
+            if (!element.isJsonObject()) {
+                continue;
+            }
+            JsonObject property = element.getAsJsonObject();
+            if (!"textures".equals(property.has("name") ? property.get("name").getAsString() : "")) {
+                continue;
+            }
+            String encodedValue = requireString(property, "value");
+            String decodedValue = new String(Base64.getDecoder().decode(encodedValue), StandardCharsets.UTF_8);
+            JsonObject textureData = JsonParser.parseString(decodedValue).getAsJsonObject();
+            if (textureData.has("textures")
+                && textureData.get("textures").isJsonObject()
+                && textureData.getAsJsonObject("textures").has("SKIN")
+                && textureData.getAsJsonObject("textures").get("SKIN").isJsonObject()) {
+                return textureData;
+            }
+        }
+        throw new IllegalStateException("profile 不包含有效的皮肤 textures 属性。");
+    }
+
+    private List<SkinProvider> loadProviders(FileConfiguration config) {
+        ConfigurationSection providersSection = config.getConfigurationSection("providers");
+        if (providersSection == null) {
+            return List.of();
+        }
+
+        List<SkinProvider> loadedProviders = new ArrayList<>();
+        for (String key : providersSection.getKeys(false)) {
+            ConfigurationSection providerSection = providersSection.getConfigurationSection(key);
+            if (providerSection == null || !providerSection.getBoolean("enabled", false)) {
+                continue;
+            }
+            String profileUrl = providerSection.getString("profile-url", "").trim();
+            if (!profileUrl.contains("{uuid}") && !profileUrl.contains("{uuid-dashed}")) {
+                plugin.getLogger().warning("SkinBridge Provider " + key + " 缺少 {uuid} 或 {uuid-dashed} 占位符，已跳过。");
+                continue;
+            }
+            try {
+                URI.create(profileUrl.replace("{uuid}", "00000000000000000000000000000000")
+                    .replace("{uuid-dashed}", "00000000-0000-0000-0000-000000000000"));
+                loadedProviders.add(new SkinProvider(key, profileUrl, providerSection.getInt("priority", 100)));
+            } catch (IllegalArgumentException exception) {
+                plugin.getLogger().warning("SkinBridge Provider " + key + " 的 profile-url 无效，已跳过。");
+            }
+        }
+        loadedProviders.sort(Comparator.comparingInt(SkinProvider::priority).thenComparing(SkinProvider::id));
+        return List.copyOf(loadedProviders);
+    }
+
+    private SkinBridgeGateway loadGateway(String endpoint, String apiKey, String visibility, int timeoutSeconds) {
+        if (apiKey.isBlank()) {
+            return null;
+        }
+        try {
+            return new MineSkinGateway(httpClient, endpoint, apiKey, visibility, timeoutSeconds,
+                "EssentialsC/" + plugin.getDescription().getVersion() + " SkinBridge");
+        } catch (Exception | LinkageError exception) {
+            plugin.getLogger().warning("加载 MineSkin SkinBridge 适配器失败: " + exception.getMessage());
+            return null;
+        }
+    }
+
+    private void addDefaults(FileConfiguration config) {
+        config.addDefault("config-version", 1);
+        config.addDefault("enabled", false);
+        config.addDefault("send-player-message", true);
+        config.addDefault("profile-request-timeout-seconds", 5);
+        config.addDefault("mineskin.endpoint", "https://api.mineskin.org");
+        config.addDefault("mineskin.api-key", "");
+        config.addDefault("mineskin.visibility", "unlisted");
+        config.addDefault("mineskin.request-timeout-seconds", 30);
+        config.addDefault("cache-minutes", 120);
+        config.addDefault("join-delay-ticks", 20);
+    }
+
+    private void applySkin(UUID playerId, CachedLookup resolved, long lookupGeneration) {
+        Bukkit.getScheduler().runTask(plugin, () -> {
+            if (lookupGeneration != configurationGeneration.get()) {
+                return;
+            }
+            Player player = Bukkit.getPlayer(playerId);
+            SkinBridgeGateway currentGateway = gateway;
+            if (player == null || !player.isOnline() || currentGateway == null || resolved.skin() == null) {
+                return;
+            }
+            try {
+                currentGateway.applySkin(player, resolved.skin());
+                sendPlayerNotification(playerId, "skin-bridge.notifications.synced",
+                    Map.of("provider", resolved.providerId()));
+                if (debug) {
+                    plugin.getLogger().info("SkinBridge 已应用 " + player.getName() + " 的 " + resolved.providerId() + " 皮肤。");
+                }
+            } catch (Exception exception) {
+                plugin.getLogger().warning("SkinBridge 应用 " + player.getName() + " 的皮肤失败: " + exception.getMessage());
+                sendPlayerNotification(playerId, "skin-bridge.notifications.failed", Map.of());
+            }
+        });
+    }
+
+    private void sendPlayerNotification(UUID playerId, String messagePath, Map<String, String> placeholders) {
+        if (!sendPlayerMessage) {
+            return;
+        }
+
+        Runnable notification = () -> {
+            Player player = Bukkit.getPlayer(playerId);
+            if (player != null && player.isOnline()) {
+                player.sendMessage(EssentialsC.getLangManager().getPrefixedString(messagePath, placeholders));
+            }
+        };
+        if (Bukkit.isPrimaryThread()) {
+            notification.run();
+        } else {
+            Bukkit.getScheduler().runTask(plugin, notification);
+        }
+    }
+
+    private CachedLookup cached(String providerId, GeneratedSkin skin, State state) {
+        return new CachedLookup(providerId, skin, state, System.currentTimeMillis() + Duration.ofMinutes(cacheMinutes).toMillis());
+    }
+
+    private static String requireString(JsonObject object, String key) {
+        if (!object.has(key) || !object.get(key).isJsonPrimitive()) {
+            throw new IllegalStateException("缺少字符串字段: " + key);
+        }
+        String value = object.get(key).getAsString();
+        if (value.isBlank()) {
+            throw new IllegalStateException("字符串字段为空: " + key);
+        }
+        return value;
+    }
+
+    private static String normalizeUuid(String value) {
+        return value.replace("-", "").toLowerCase(java.util.Locale.ROOT);
+    }
+
+    private static int clamp(int value, int min, int max) {
+        return Math.max(min, Math.min(max, value));
+    }
+
+    private static long clamp(long value, long min, long max) {
+        return Math.max(min, Math.min(max, value));
+    }
+
+    private record SkinProvider(String id, String profileUrl, int priority) {
+        private String resolveProfileUrl(UUID playerId) {
+            return profileUrl.replace("{uuid}", playerId.toString().replace("-", ""))
+                .replace("{uuid-dashed}", playerId.toString());
+        }
+    }
+
+    private record ProviderProfile(String skinUrl, SkinModel model) {
+    }
+
+    private record CachedLookup(String providerId, GeneratedSkin skin, State state, long expiresAtMillis) {
+        private boolean hasExpired() {
+            return System.currentTimeMillis() >= expiresAtMillis;
+        }
+    }
+
+    private static final class SkinBridgeThreadFactory implements ThreadFactory {
+        @Override
+        public Thread newThread(Runnable runnable) {
+            Thread thread = new Thread(runnable, "EssentialsC-SkinBridge");
+            thread.setDaemon(true);
+            return thread;
+        }
+    }
+
+    public enum SyncResult {
+        QUEUED,
+        CACHED,
+        ALREADY_RUNNING,
+        FEATURE_DISABLED,
+        DEPENDENCY_MISSING,
+        NO_PROVIDERS
+    }
+
+    public record Status(State state, String providerId) {
+    }
+
+    public enum State {
+        EXTERNAL,
+        NOT_EXTERNAL,
+        PENDING,
+        UNKNOWN
+    }
+}

src/main/java/cn/infstar/essentialsC/teleport/TeleportRequestManager.java

@@ -0,0 +1,950 @@
+package cn.infstar.essentialsC.teleport;
+
+import cn.infstar.essentialsC.EssentialsC;
+import cn.infstar.essentialsC.commands.VanishCommand;
+import net.kyori.adventure.title.Title;
+import org.bukkit.Bukkit;
+import org.bukkit.Location;
+import org.bukkit.configuration.file.FileConfiguration;
+import org.bukkit.configuration.file.YamlConfiguration;
+import org.bukkit.entity.Player;
+import org.bukkit.event.EventHandler;
+import org.bukkit.event.EventPriority;
+import org.bukkit.event.Listener;
+import org.bukkit.event.entity.EntityDamageEvent;
+import org.bukkit.event.player.PlayerJoinEvent;
+import org.bukkit.event.player.PlayerQuitEvent;
+import org.bukkit.event.player.PlayerTeleportEvent;
+import org.bukkit.permissions.PermissionAttachmentInfo;
+import org.bukkit.scheduler.BukkitTask;
+
+import java.io.File;
+import java.io.IOException;
+import java.time.Duration;
+import java.time.Instant;
+import java.util.ArrayDeque;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.Deque;
+import java.util.HashMap;
+import java.util.HashSet;
+import java.util.List;
+import java.util.Locale;
+import java.util.Map;
+import java.util.Optional;
+import java.util.Set;
+import java.util.UUID;
+import java.util.function.Predicate;
+
+public final class TeleportRequestManager implements Listener {
+
+    public static final String BYPASS_WARMUP_PERMISSION = "essentialsc.tpa.bypass-warmup";
+    public static final String BYPASS_COOLDOWN_PERMISSION = "essentialsc.tpa.bypass-cooldown";
+    public static final String WARMUP_PERMISSION_PREFIX = "essentialsc.tpa.warmup.";
+    private static final double MOVEMENT_THRESHOLD = 0.1D;
+
+    private final EssentialsC plugin;
+    private final Map<UUID, Deque<TeleportRequest>> requests = new HashMap<>();
+    private final Map<UUID, PendingTeleport> warmups = new HashMap<>();
+    private final Map<UUID, Long> sendCooldowns = new HashMap<>();
+    private final Map<UUID, Long> acceptCooldowns = new HashMap<>();
+    private final Map<UUID, BukkitTask> invulnerabilityTasks = new HashMap<>();
+    private final Set<UUID> warmupDamagedPlayers = new HashSet<>();
+    private final Set<UUID> invulnerablePlayers = new HashSet<>();
+    private final Set<UUID> ignoringRequests = new HashSet<>();
+    private final File ignoreFile;
+
+    private int timeoutSeconds;
+    private boolean strictTpaRequests;
+    private boolean strictTpaHereRequests;
+    private int warmupSeconds;
+    private boolean cancelWarmupOnMove;
+    private boolean cancelWarmupOnDamage;
+    private boolean cooldownsEnabled;
+    private int sendCooldownSeconds;
+    private int acceptCooldownSeconds;
+    private String warmupDisplay;
+    private int teleportInvulnerabilitySeconds;
+    private boolean teleportAsync;
+    private boolean soundsEnabled;
+    private String requestSound;
+    private String warmupSound;
+    private String cancelSound;
+    private String completeSound;
+
+    public TeleportRequestManager(EssentialsC plugin) {
+        this.plugin = plugin;
+        this.ignoreFile = new File(plugin.getDataFolder(), "teleport-ignore.yml");
+        reload();
+    }
+
+    public void reload() {
+        plugin.getConfig().addDefault("tpa.timeout-seconds", 60);
+        plugin.getConfig().addDefault("tpa.strict-tpa-requests", false);
+        plugin.getConfig().addDefault("tpa.strict-tpahere-requests", true);
+        plugin.getConfig().addDefault("tpa.warmup-seconds", 5);
+        plugin.getConfig().addDefault("tpa.cancel-warmup-on-move", true);
+        plugin.getConfig().addDefault("tpa.cancel-warmup-on-damage", true);
+        plugin.getConfig().addDefault("tpa.cooldowns.enabled", true);
+        plugin.getConfig().addDefault("tpa.cooldowns.cooldown-times.SEND_TELEPORT_REQUEST", 0);
+        plugin.getConfig().addDefault("tpa.cooldowns.cooldown-times.ACCEPT_TELEPORT_REQUEST", 0);
+        plugin.getConfig().addDefault("tpa.warmup-display", "actionbar");
+        plugin.getConfig().addDefault("tpa.teleport-invulnerability-seconds", 0);
+        plugin.getConfig().addDefault("tpa.teleport-async", true);
+        plugin.getConfig().addDefault("tpa.sounds.enabled", true);
+        plugin.getConfig().addDefault("tpa.sounds.request-received", "entity.experience_orb.pickup");
+        plugin.getConfig().addDefault("tpa.sounds.warmup", "block.note_block.banjo");
+        plugin.getConfig().addDefault("tpa.sounds.cancelled", "entity.item.break");
+        plugin.getConfig().addDefault("tpa.sounds.complete", "entity.enderman.teleport");
+        plugin.getConfig().set("tpa.warmup-move-threshold", null);
+        plugin.getConfig().options().copyDefaults(true);
+        plugin.saveConfig();
+
+        timeoutSeconds = Math.max(0, plugin.getConfig().getInt("tpa.timeout-seconds", 60));
+        strictTpaRequests = plugin.getConfig().getBoolean("tpa.strict-tpa-requests", false);
+        strictTpaHereRequests = plugin.getConfig().getBoolean("tpa.strict-tpahere-requests", true);
+        warmupSeconds = Math.max(0, plugin.getConfig().getInt("tpa.warmup-seconds", 5));
+        cancelWarmupOnMove = plugin.getConfig().getBoolean("tpa.cancel-warmup-on-move", true);
+        cancelWarmupOnDamage = plugin.getConfig().getBoolean("tpa.cancel-warmup-on-damage", true);
+        cooldownsEnabled = plugin.getConfig().getBoolean("tpa.cooldowns.enabled", true);
+        sendCooldownSeconds = Math.max(0, plugin.getConfig().getInt("tpa.cooldowns.cooldown-times.SEND_TELEPORT_REQUEST", 0));
+        acceptCooldownSeconds = Math.max(0, plugin.getConfig().getInt("tpa.cooldowns.cooldown-times.ACCEPT_TELEPORT_REQUEST", 0));
+        warmupDisplay = plugin.getConfig().getString("tpa.warmup-display", "actionbar").toLowerCase(Locale.ROOT);
+        teleportInvulnerabilitySeconds = Math.max(0,
+            plugin.getConfig().getInt("tpa.teleport-invulnerability-seconds", 0));
+        teleportAsync = plugin.getConfig().getBoolean("tpa.teleport-async", true);
+        soundsEnabled = plugin.getConfig().getBoolean("tpa.sounds.enabled", true);
+        requestSound = plugin.getConfig().getString("tpa.sounds.request-received", "entity.experience_orb.pickup");
+        warmupSound = plugin.getConfig().getString("tpa.sounds.warmup", "block.note_block.banjo");
+        cancelSound = plugin.getConfig().getString("tpa.sounds.cancelled", "entity.item.break");
+        completeSound = plugin.getConfig().getString("tpa.sounds.complete", "entity.enderman.teleport");
+        loadIgnoringRequests();
+    }
+
+    public void shutdown() {
+        requests.clear();
+        sendCooldowns.clear();
+        acceptCooldowns.clear();
+        cancelAllWarmups();
+        clearAllInvulnerability();
+        saveIgnoringRequests();
+    }
+
+    public CreateRequestResult createRequest(Player requester, Player target, TeleportRequest.Type type) {
+        return createRequest(requester, target, type, true);
+    }
+
+    private CreateRequestResult createRequest(Player requester, Player target, TeleportRequest.Type type, boolean applyCooldown) {
+        OptionalIntCooldown sendCooldown = getRemainingCooldown(requester, sendCooldowns);
+        if (applyCooldown && sendCooldown.active()) {
+            return new CreateRequestResult(CreateRequestStatus.ON_COOLDOWN, null, sendCooldown.seconds());
+        }
+
+        Optional<TeleportRequest> existingRequest = findIncoming(target, requester.getName());
+        if (existingRequest.isPresent()
+            && existingRequest.get().type() == type
+            && !existingRequest.get().hasExpired()) {
+            if (applyCooldown) {
+                startCooldown(requester, sendCooldowns, sendCooldownSeconds);
+            }
+            return new CreateRequestResult(CreateRequestStatus.DUPLICATE, existingRequest.get());
+        }
+
+        TeleportRequest request = new TeleportRequest(
+            requester.getUniqueId(),
+            requester.getName(),
+            requester.getLocation().clone(),
+            target.getUniqueId(),
+            target.getName(),
+            target.getLocation().clone(),
+            type,
+            Instant.now().plusSeconds(timeoutSeconds).toEpochMilli(),
+            TeleportRequest.Status.PENDING
+        );
+
+        if (isIgnoringRequests(target) || isVanished(target)) {
+            request.setStatus(TeleportRequest.Status.IGNORED);
+            if (applyCooldown) {
+                startCooldown(requester, sendCooldowns, sendCooldownSeconds);
+            }
+            return new CreateRequestResult(CreateRequestStatus.IGNORED, request);
+        }
+
+        Deque<TeleportRequest> targetRequests = requests.computeIfAbsent(target.getUniqueId(), ignored -> new ArrayDeque<>());
+        targetRequests.addFirst(request);
+        if (applyCooldown) {
+            startCooldown(requester, sendCooldowns, sendCooldownSeconds);
+        }
+        return new CreateRequestResult(CreateRequestStatus.SUCCESS, request, 0);
+    }
+
+    public Optional<TeleportRequest> findIncoming(Player target, String requesterName) {
+        Deque<TeleportRequest> targetRequests = requests.getOrDefault(target.getUniqueId(), new ArrayDeque<>());
+        if (requesterName == null) {
+            return targetRequests.stream().findFirst();
+        }
+
+        Optional<TeleportRequest> unexpired = targetRequests.stream()
+            .filter(request -> request.requesterName().equalsIgnoreCase(requesterName))
+            .filter(request -> !request.hasExpired())
+            .findFirst();
+        if (unexpired.isPresent()) {
+            return unexpired;
+        }
+
+        return targetRequests.stream()
+            .filter(request -> request.requesterName().equalsIgnoreCase(requesterName))
+            .findFirst();
+    }
+
+    public Optional<TeleportRequest> findOutgoing(Player requester, String targetName) {
+        return requests.values().stream()
+            .flatMap(Deque::stream)
+            .filter(request -> request.requesterId().equals(requester.getUniqueId()))
+            .filter(request -> !request.hasExpired())
+            .filter(request -> targetName == null || request.targetName().equalsIgnoreCase(targetName))
+            .max(Comparator.comparingLong(TeleportRequest::expiresAtMillis));
+    }
+
+    public List<String> getIncomingRequesterNames(Player target, String partial) {
+        String partialLower = partial == null ? "" : partial.toLowerCase();
+        return requests.getOrDefault(target.getUniqueId(), new ArrayDeque<>()).stream()
+            .filter(request -> !request.hasExpired())
+            .map(TeleportRequest::requesterName)
+            .filter(name -> name.toLowerCase().startsWith(partialLower))
+            .distinct()
+            .sorted(String.CASE_INSENSITIVE_ORDER)
+            .toList();
+    }
+
+    public List<String> getOutgoingTargetNames(Player requester, String partial) {
+        String partialLower = partial == null ? "" : partial.toLowerCase();
+        return requests.values().stream()
+            .flatMap(Deque::stream)
+            .filter(request -> request.requesterId().equals(requester.getUniqueId()))
+            .filter(request -> !request.hasExpired())
+            .map(TeleportRequest::targetName)
+            .filter(name -> name.toLowerCase().startsWith(partialLower))
+            .distinct()
+            .sorted(String.CASE_INSENSITIVE_ORDER)
+            .toList();
+    }
+
+    public TeleportResult accept(Player target, TeleportRequest request) {
+        OptionalIntCooldown acceptCooldown = getRemainingCooldown(target, acceptCooldowns);
+        if (acceptCooldown.active()) {
+            return TeleportResult.onCooldown(acceptCooldown.seconds());
+        }
+
+        removeIncomingByRequester(target, request.requesterName());
+        if (request.hasExpired()) {
+            return TeleportResult.EXPIRED;
+        }
+
+        request.setStatus(TeleportRequest.Status.ACCEPTED);
+        Map<String, String> placeholders = placeholders(request);
+        target.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.accepted-target", placeholders));
+
+        Player requester = Bukkit.getPlayer(request.requesterId());
+        if (requester == null || !requester.isOnline()) {
+            target.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.player-offline", placeholders));
+            return TeleportResult.PLAYER_OFFLINE;
+        }
+        requester.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.accepted-sender", placeholders));
+
+        TeleportPlan plan = createTeleportPlan(request, requester, target);
+        Player teleporter = plan.teleporter();
+        int playerWarmupSeconds = getTeleportWarmupSeconds(teleporter);
+        if (playerWarmupSeconds <= 0 || teleporter.hasPermission(BYPASS_WARMUP_PERMISSION)) {
+            return executeTeleport(plan, true);
+        }
+
+        if (warmups.containsKey(teleporter.getUniqueId())) {
+            teleporter.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.already-warming-up"));
+            return TeleportResult.ACCEPTED_WITHOUT_TELEPORT;
+        }
+        OptionalIntCooldown teleporterCooldown = getRemainingCooldown(teleporter, acceptCooldowns);
+        if (teleporterCooldown.active()) {
+            sendAcceptCooldown(teleporter, teleporterCooldown.seconds());
+            return TeleportResult.ACCEPTED_WITHOUT_TELEPORT;
+        }
+        if (isMoving(teleporter)) {
+            teleporter.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.warmup-stand-still"));
+            return TeleportResult.ACCEPTED_WITHOUT_TELEPORT;
+        }
+
+        startWarmup(plan, playerWarmupSeconds);
+        return TeleportResult.WARMING_UP;
+    }
+
+    public TeleportResult deny(Player target, TeleportRequest request) {
+        if (!removeIncomingByRequester(target, request.requesterName())) {
+            return TeleportResult.EXPIRED;
+        }
+        if (request.hasExpired()) {
+            return TeleportResult.EXPIRED;
+        }
+        request.setStatus(TeleportRequest.Status.DECLINED);
+        Map<String, String> placeholders = placeholders(request);
+        target.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.denied-target", placeholders));
+        Player requester = Bukkit.getPlayer(request.requesterId());
+        if (requester != null && requester.isOnline()) {
+            requester.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.denied-sender", placeholders));
+        } else {
+            target.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.player-offline", placeholders));
+        }
+        return TeleportResult.SUCCESS;
+    }
+
+    public boolean cancel(TeleportRequest request) {
+        Deque<TeleportRequest> targetRequests = requests.get(request.targetId());
+        if (targetRequests == null) {
+            return false;
+        }
+
+        boolean removed = targetRequests.removeIf(candidate ->
+            candidate.requesterName().equalsIgnoreCase(request.requesterName()));
+        if (targetRequests.isEmpty()) {
+            requests.remove(request.targetId());
+        }
+        return removed;
+    }
+
+    public boolean isIgnoringRequests(Player player) {
+        return ignoringRequests.contains(player.getUniqueId());
+    }
+
+    public boolean isVanished(Player player) {
+        if (VanishCommand.isVanished(player)) {
+            return true;
+        }
+        return player.hasMetadata("vanished") && player.getMetadata("vanished").stream()
+            .map(metadata -> metadata.asBoolean())
+            .findFirst()
+            .orElse(false);
+    }
+
+    public boolean toggleIgnoringRequests(Player player) {
+        UUID uuid = player.getUniqueId();
+        boolean nowIgnoring;
+        if (ignoringRequests.contains(uuid)) {
+            ignoringRequests.remove(uuid);
+            nowIgnoring = false;
+        } else {
+            ignoringRequests.add(uuid);
+            nowIgnoring = true;
+        }
+        saveIgnoringRequests();
+        return nowIgnoring;
+    }
+
+    public void playRequestReceivedSound(Player player) {
+        playConfiguredSound(player, requestSound, 1.0F, 1.0F);
+    }
+
+    public int sendTeleportAllRequest(Player requester) {
+        int recipients = 0;
+        for (Player target : Bukkit.getOnlinePlayers()) {
+            if (target.getUniqueId().equals(requester.getUniqueId())) {
+                continue;
+            }
+            recipients++;
+            CreateRequestResult result = createRequest(requester, target, TeleportRequest.Type.TPAHERE, false);
+            if (result.status() != CreateRequestStatus.SUCCESS) {
+                continue;
+            }
+            Map<String, String> placeholders = placeholders(result.request());
+            target.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.received-tpahere", placeholders));
+            sendResponseHint(target, placeholders);
+            playRequestReceivedSound(target);
+        }
+        return recipients;
+    }
+
+    public int getRemainingSendCooldownSeconds(Player player) {
+        return getRemainingCooldown(player, sendCooldowns).seconds();
+    }
+
+    public Optional<Player> findOnlinePlayer(String playerName, Predicate<Player> filter) {
+        Optional<Player> exactMatch = Bukkit.getOnlinePlayers().stream()
+            .map(Player.class::cast)
+            .filter(filter)
+            .filter(player -> player.getName().equalsIgnoreCase(playerName))
+            .findFirst();
+        if (exactMatch.isPresent()) {
+            return exactMatch;
+        }
+
+        String playerNameLower = playerName.toLowerCase();
+        return Bukkit.getOnlinePlayers().stream()
+            .map(Player.class::cast)
+            .filter(filter)
+            .filter(player -> player.getName().toLowerCase().startsWith(playerNameLower))
+            .findFirst();
+    }
+
+    public void sendResponseHint(Player target, Map<String, String> placeholders) {
+        target.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.response-buttons", placeholders));
+    }
+
+    public int getTimeoutSeconds() {
+        return timeoutSeconds;
+    }
+
+    private OptionalIntCooldown getRemainingCooldown(Player player, Map<UUID, Long> cooldowns) {
+        if (player.hasPermission(BYPASS_COOLDOWN_PERMISSION)) {
+            return OptionalIntCooldown.inactive();
+        }
+        if (!cooldownsEnabled) {
+            return OptionalIntCooldown.inactive();
+        }
+
+        long expiresAt = cooldowns.getOrDefault(player.getUniqueId(), 0L);
+        long now = System.currentTimeMillis();
+        if (expiresAt <= now) {
+            cooldowns.remove(player.getUniqueId());
+            return OptionalIntCooldown.inactive();
+        }
+
+        int seconds = (int) Math.ceil((expiresAt - now) / 1000.0D);
+        return new OptionalIntCooldown(true, Math.max(1, seconds));
+    }
+
+    private void startCooldown(Player player, Map<UUID, Long> cooldowns, int seconds) {
+        if (!cooldownsEnabled || seconds <= 0 || player.hasPermission(BYPASS_COOLDOWN_PERMISSION)) {
+            return;
+        }
+        cooldowns.put(player.getUniqueId(), System.currentTimeMillis() + seconds * 1000L);
+    }
+
+    private TeleportPlan createTeleportPlan(TeleportRequest request, Player requester, Player currentTarget) {
+        if (request.type() == TeleportRequest.Type.TPA) {
+            return new TeleportPlan(
+                requester,
+                strictTpaRequests ? currentTarget.getLocation().clone() : null,
+                strictTpaRequests ? null : currentTarget.getUniqueId()
+            );
+        }
+        return new TeleportPlan(
+            currentTarget,
+            strictTpaHereRequests ? request.requesterLocation().clone() : null,
+            strictTpaHereRequests ? null : requester.getUniqueId()
+        );
+    }
+
+    private int getTeleportWarmupSeconds(Player player) {
+        return player.getEffectivePermissions().stream()
+            .filter(PermissionAttachmentInfo::getValue)
+            .map(PermissionAttachmentInfo::getPermission)
+            .filter(permission -> permission.startsWith(WARMUP_PERMISSION_PREFIX))
+            .map(permission -> permission.substring(WARMUP_PERMISSION_PREFIX.length()))
+            .mapToInt(this::parseWarmupPermission)
+            .filter(seconds -> seconds >= 0)
+            .max()
+            .orElse(warmupSeconds);
+    }
+
+    private int parseWarmupPermission(String value) {
+        try {
+            return Integer.parseInt(value);
+        } catch (NumberFormatException ignored) {
+            return -1;
+        }
+    }
+
+    private void startWarmup(TeleportPlan plan, int playerWarmupSeconds) {
+        Player teleporter = plan.teleporter();
+        UUID uuid = teleporter.getUniqueId();
+        PendingTeleport pendingTeleport = new PendingTeleport(
+            plan,
+            teleporter.getLocation().clone(),
+            playerWarmupSeconds
+        );
+        warmupDamagedPlayers.remove(uuid);
+        BukkitTask task = Bukkit.getScheduler().runTaskTimer(plugin, () -> tickWarmup(uuid), 0L, 20L);
+        pendingTeleport.setTask(task);
+        warmups.put(uuid, pendingTeleport);
+        teleporter.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.warmup-start",
+            Map.of("seconds", String.valueOf(playerWarmupSeconds))));
+    }
+
+    private void tickWarmup(UUID teleporterId) {
+        PendingTeleport pendingTeleport = warmups.get(teleporterId);
+        if (pendingTeleport == null) {
+            return;
+        }
+
+        Player teleporter = Bukkit.getPlayer(teleporterId);
+        if (teleporter == null || !teleporter.isOnline()) {
+            cancelWarmup(teleporterId, null, false);
+            return;
+        }
+
+        if (cancelWarmupOnDamage && warmupDamagedPlayers.contains(teleporterId)) {
+            cancelWarmup(teleporterId, "tpa.messages.warmup-cancelled-damage", true);
+            return;
+        }
+        if (cancelWarmupOnMove && hasMoved(pendingTeleport.startLocation(), teleporter.getLocation())) {
+            cancelWarmup(teleporterId, "tpa.messages.warmup-cancelled-move", true);
+            return;
+        }
+
+        if (pendingTeleport.remainingSeconds() <= 0) {
+            sendWarmupStatus(teleporter, "tpa.messages.warmup-processing", Map.of());
+            cancelWarmup(teleporterId, null, false);
+            TeleportResult result = executeTeleport(pendingTeleport.plan(), true);
+            if (result.status() == TeleportResult.Status.ON_COOLDOWN) {
+                sendAcceptCooldown(teleporter, result.cooldownSeconds());
+            }
+            return;
+        }
+
+        sendWarmupStatus(teleporter, "tpa.messages.warmup-status",
+            Map.of("seconds", String.valueOf(pendingTeleport.remainingSeconds())));
+        playConfiguredSound(teleporter, warmupSound, 1.0F, 1.0F);
+        pendingTeleport.decrementRemainingSeconds();
+    }
+
+    private TeleportResult executeTeleport(TeleportPlan plan, boolean notifyCompletion) {
+        Player teleporter = plan.teleporter();
+        if (!teleporter.isOnline()) {
+            return TeleportResult.PLAYER_OFFLINE;
+        }
+
+        OptionalIntCooldown acceptCooldown = getRemainingCooldown(teleporter, acceptCooldowns);
+        if (acceptCooldown.active()) {
+            return TeleportResult.onCooldown(acceptCooldown.seconds());
+        }
+
+        Location destination = plan.fixedDestination();
+        if (destination == null && plan.dynamicTargetId() != null) {
+            Player dynamicTarget = Bukkit.getPlayer(plan.dynamicTargetId());
+            if (dynamicTarget == null || !dynamicTarget.isOnline()) {
+                teleporter.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.target-offline"));
+                return TeleportResult.TARGET_OFFLINE;
+            }
+            destination = dynamicTarget.getLocation().clone();
+        }
+
+        if (destination == null) {
+            teleporter.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.target-offline"));
+            return TeleportResult.TARGET_OFFLINE;
+        }
+
+        teleporter.leaveVehicle();
+        teleporter.eject();
+        teleporter.setFallDistance(0.0F);
+        startCooldown(teleporter, acceptCooldowns, acceptCooldownSeconds);
+        if (teleportAsync) {
+            try {
+                teleporter.teleportAsync(destination, PlayerTeleportEvent.TeleportCause.PLUGIN)
+                    .whenComplete((success, throwable) -> {
+                        if (!plugin.isEnabled()) {
+                            return;
+                        }
+                        Bukkit.getScheduler().runTask(plugin, () -> handleTeleportCompletion(
+                            teleporter, Boolean.TRUE.equals(success), throwable, notifyCompletion));
+                    });
+            } catch (RuntimeException exception) {
+                handleTeleportCompletion(teleporter, false, exception, notifyCompletion);
+            }
+        } else {
+            try {
+                boolean success = teleporter.teleport(destination, PlayerTeleportEvent.TeleportCause.PLUGIN);
+                handleTeleportCompletion(teleporter, success, null, notifyCompletion);
+            } catch (RuntimeException exception) {
+                handleTeleportCompletion(teleporter, false, exception, notifyCompletion);
+            }
+        }
+        return TeleportResult.SUCCESS;
+    }
+
+    private void handleTeleportCompletion(Player teleporter, boolean success, Throwable throwable,
+                                          boolean notifyCompletion) {
+        if (!success) {
+            if (teleporter.isOnline()) {
+                teleporter.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.teleport-failed"));
+            }
+            if (throwable != null) {
+                String detail = throwable.getMessage() == null
+                    ? throwable.getClass().getSimpleName()
+                    : throwable.getMessage();
+                plugin.getLogger().warning("TPA 传送执行失败: " + detail);
+            }
+            return;
+        }
+
+        applyTeleportInvulnerability(teleporter);
+        if (notifyCompletion && teleporter.isOnline()) {
+            teleporter.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.teleport-complete"));
+            playConfiguredSound(teleporter, completeSound, 1.0F, 1.0F);
+        }
+    }
+
+    private void applyTeleportInvulnerability(Player player) {
+        if (teleportInvulnerabilitySeconds <= 0 || !player.isOnline()) {
+            return;
+        }
+
+        UUID uuid = player.getUniqueId();
+        BukkitTask previousTask = invulnerabilityTasks.remove(uuid);
+        if (previousTask != null) {
+            previousTask.cancel();
+        }
+        if (player.isInvulnerable() && !invulnerablePlayers.contains(uuid)) {
+            return;
+        }
+
+        invulnerablePlayers.add(uuid);
+        player.setInvulnerable(true);
+        BukkitTask task = Bukkit.getScheduler().runTaskLater(plugin,
+            () -> clearInvulnerability(uuid), teleportInvulnerabilitySeconds * 20L);
+        invulnerabilityTasks.put(uuid, task);
+    }
+
+    private void clearInvulnerability(UUID uuid) {
+        BukkitTask task = invulnerabilityTasks.remove(uuid);
+        if (task != null) {
+            task.cancel();
+        }
+        if (!invulnerablePlayers.remove(uuid)) {
+            return;
+        }
+        Player player = Bukkit.getPlayer(uuid);
+        if (player != null) {
+            player.setInvulnerable(false);
+        }
+    }
+
+    private void clearAllInvulnerability() {
+        for (BukkitTask task : invulnerabilityTasks.values()) {
+            task.cancel();
+        }
+        invulnerabilityTasks.clear();
+        for (UUID uuid : new HashSet<>(invulnerablePlayers)) {
+            clearInvulnerability(uuid);
+        }
+    }
+
+    private void sendAcceptCooldown(Player player, int seconds) {
+        player.sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.accept-cooldown",
+            Map.of("seconds", String.valueOf(seconds))));
+    }
+
+    private void sendWarmupStatus(Player player, String messagePath, Map<String, String> placeholders) {
+        net.kyori.adventure.text.Component message = plugin.getLangManager().getPrefixedComponent(messagePath, placeholders);
+        switch (warmupDisplay.replace("-", "_")) {
+            case "actionbar", "action_bar" -> player.sendActionBar(message);
+            case "title" -> player.showTitle(Title.title(message, net.kyori.adventure.text.Component.empty(),
+                Title.Times.times(Duration.ZERO, Duration.ofSeconds(1), Duration.ofMillis(250))));
+            case "subtitle" -> player.showTitle(Title.title(net.kyori.adventure.text.Component.empty(), message,
+                Title.Times.times(Duration.ZERO, Duration.ofSeconds(1), Duration.ofMillis(250))));
+            case "none" -> {
+            }
+            default -> player.sendMessage(message);
+        }
+    }
+
+    private void cancelWarmup(UUID teleporterId, String messagePath, boolean playSound) {
+        PendingTeleport pendingTeleport = warmups.remove(teleporterId);
+        warmupDamagedPlayers.remove(teleporterId);
+        if (pendingTeleport == null) {
+            return;
+        }
+        if (pendingTeleport.task() != null) {
+            pendingTeleport.task().cancel();
+        }
+
+        Player player = Bukkit.getPlayer(teleporterId);
+        if (player != null && player.isOnline() && messagePath != null) {
+            player.sendMessage(plugin.getLangManager().getPrefixedComponent(messagePath));
+            sendWarmupStatus(player, "tpa.messages.warmup-cancelled-actionbar", Map.of());
+            if (playSound) {
+                playConfiguredSound(player, cancelSound, 1.0F, 1.0F);
+            }
+        }
+    }
+
+    private void cancelAllWarmups() {
+        List<UUID> warmingPlayers = new ArrayList<>(warmups.keySet());
+        for (UUID warmingPlayer : warmingPlayers) {
+            cancelWarmup(warmingPlayer, null, false);
+        }
+    }
+
+    private void playConfiguredSound(Player player, String sound, float volume, float pitch) {
+        if (!soundsEnabled || sound == null || sound.isBlank()) {
+            return;
+        }
+        try {
+            player.playSound(player.getLocation(), sound, volume, pitch);
+        } catch (IllegalArgumentException ignored) {
+            plugin.getLogger().warning("无效的 TPA 音效配置: " + sound);
+        }
+    }
+
+    private boolean removeIncomingByRequester(Player target, String requesterName) {
+        Deque<TeleportRequest> targetRequests = requests.get(target.getUniqueId());
+        if (targetRequests == null) {
+            return false;
+        }
+
+        boolean removed = targetRequests.removeIf(request ->
+            request.requesterName().equalsIgnoreCase(requesterName));
+        if (targetRequests.isEmpty()) {
+            requests.remove(target.getUniqueId());
+        }
+        return removed;
+    }
+
+    public Map<String, String> placeholders(TeleportRequest request) {
+        Map<String, String> placeholders = new HashMap<>();
+        placeholders.put("requester", request.requesterName());
+        placeholders.put("target", request.targetName());
+        placeholders.put("seconds", String.valueOf(timeoutSeconds));
+        placeholders.put("type", request.type().name().toLowerCase());
+        return placeholders;
+    }
+
+    @EventHandler(priority = EventPriority.MONITOR, ignoreCancelled = true)
+    private void onEntityDamage(EntityDamageEvent event) {
+        if (event.getDamage() <= 0) {
+            return;
+        }
+        if (event.getEntity() instanceof Player player && warmups.containsKey(player.getUniqueId())) {
+            warmupDamagedPlayers.add(player.getUniqueId());
+        }
+    }
+
+    @EventHandler
+    private void onPlayerJoin(PlayerJoinEvent event) {
+        if (!isIgnoringRequests(event.getPlayer())) {
+            return;
+        }
+
+        event.getPlayer().sendMessage(plugin.getLangManager().getPrefixedComponent("tpa.messages.ignore-notification"));
+    }
+
+    @EventHandler
+    private void onPlayerQuit(PlayerQuitEvent event) {
+        UUID uuid = event.getPlayer().getUniqueId();
+        cancelWarmup(uuid, null, false);
+        clearInvulnerability(uuid);
+    }
+
+    private boolean hasMoved(Location start, Location current) {
+        if (start.getWorld() == null || current.getWorld() == null
+            || !start.getWorld().getUID().equals(current.getWorld().getUID())) {
+            return true;
+        }
+        double distance = Math.abs(start.getX() - current.getX())
+            + Math.abs(start.getY() - current.getY())
+            + Math.abs(start.getZ() - current.getZ());
+        return distance > MOVEMENT_THRESHOLD;
+    }
+
+    private boolean isMoving(Player player) {
+        return player.getVelocity().length() >= MOVEMENT_THRESHOLD;
+    }
+
+    private void loadIgnoringRequests() {
+        ignoringRequests.clear();
+        if (!ignoreFile.exists()) {
+            return;
+        }
+
+        FileConfiguration ignoreConfig = YamlConfiguration.loadConfiguration(ignoreFile);
+        if (!ignoreConfig.isConfigurationSection("ignored")) {
+            return;
+        }
+
+        for (String key : ignoreConfig.getConfigurationSection("ignored").getKeys(false)) {
+            if (!ignoreConfig.getBoolean("ignored." + key, false)) {
+                continue;
+            }
+            try {
+                ignoringRequests.add(UUID.fromString(key));
+            } catch (IllegalArgumentException ignored) {
+                plugin.getLogger().warning("忽略无效的 TPA 忽略记录 UUID: " + key);
+            }
+        }
+    }
+
+    private void saveIgnoringRequests() {
+        FileConfiguration ignoreConfig = new YamlConfiguration();
+        for (UUID uuid : ignoringRequests) {
+            ignoreConfig.set("ignored." + uuid, true);
+        }
+        try {
+            ignoreConfig.save(ignoreFile);
+        } catch (IOException e) {
+            plugin.getLogger().warning("保存 teleport-ignore.yml 失败: " + e.getMessage());
+        }
+    }
+
+    public enum CreateRequestStatus {
+        SUCCESS,
+        DUPLICATE,
+        IGNORED,
+        ON_COOLDOWN
+    }
+
+    public record TeleportResult(Status status, int cooldownSeconds) {
+        public static final TeleportResult SUCCESS = new TeleportResult(Status.SUCCESS, 0);
+        public static final TeleportResult WARMING_UP = new TeleportResult(Status.WARMING_UP, 0);
+        public static final TeleportResult EXPIRED = new TeleportResult(Status.EXPIRED, 0);
+        public static final TeleportResult PLAYER_OFFLINE = new TeleportResult(Status.PLAYER_OFFLINE, 0);
+        public static final TeleportResult TARGET_OFFLINE = new TeleportResult(Status.TARGET_OFFLINE, 0);
+        public static final TeleportResult ALREADY_WARMING_UP = new TeleportResult(Status.ALREADY_WARMING_UP, 0);
+        public static final TeleportResult ACCEPTED_WITHOUT_TELEPORT = new TeleportResult(Status.ACCEPTED_WITHOUT_TELEPORT, 0);
+
+        public static TeleportResult onCooldown(int seconds) {
+            return new TeleportResult(Status.ON_COOLDOWN, seconds);
+        }
+
+        public enum Status {
+            SUCCESS,
+            WARMING_UP,
+            EXPIRED,
+            PLAYER_OFFLINE,
+            TARGET_OFFLINE,
+            ALREADY_WARMING_UP,
+            ACCEPTED_WITHOUT_TELEPORT,
+            ON_COOLDOWN
+        }
+    }
+
+    public record CreateRequestResult(CreateRequestStatus status, TeleportRequest request, int cooldownSeconds) {
+        public CreateRequestResult(CreateRequestStatus status, TeleportRequest request) {
+            this(status, request, 0);
+        }
+    }
+
+    public static final class TeleportRequest {
+        private final UUID requesterId;
+        private final String requesterName;
+        private final Location requesterLocation;
+        private final UUID targetId;
+        private final String targetName;
+        private final Location targetLocation;
+        private final Type type;
+        private final long expiresAtMillis;
+        private Status status;
+
+        public TeleportRequest(UUID requesterId, String requesterName, Location requesterLocation,
+                               UUID targetId, String targetName, Location targetLocation,
+                               Type type, long expiresAtMillis, Status status) {
+            this.requesterId = requesterId;
+            this.requesterName = requesterName;
+            this.requesterLocation = requesterLocation;
+            this.targetId = targetId;
+            this.targetName = targetName;
+            this.targetLocation = targetLocation;
+            this.type = type;
+            this.expiresAtMillis = expiresAtMillis;
+            this.status = status;
+        }
+
+        public UUID requesterId() {
+            return requesterId;
+        }
+
+        public String requesterName() {
+            return requesterName;
+        }
+
+        public Location requesterLocation() {
+            return requesterLocation;
+        }
+
+        public UUID targetId() {
+            return targetId;
+        }
+
+        public String targetName() {
+            return targetName;
+        }
+
+        public Location targetLocation() {
+            return targetLocation;
+        }
+
+        public Type type() {
+            return type;
+        }
+
+        public long expiresAtMillis() {
+            return expiresAtMillis;
+        }
+
+        public Status status() {
+            return status;
+        }
+
+        public void setStatus(Status status) {
+            this.status = status;
+        }
+
+        public boolean hasExpired() {
+            return Instant.now().isAfter(Instant.ofEpochMilli(expiresAtMillis));
+        }
+
+        public enum Type {
+            TPA,
+            TPAHERE
+        }
+
+        public enum Status {
+            PENDING,
+            ACCEPTED,
+            DECLINED,
+            IGNORED
+        }
+    }
+
+    private record TeleportPlan(Player teleporter, Location fixedDestination, UUID dynamicTargetId) {
+    }
+
+    private record OptionalIntCooldown(boolean active, int seconds) {
+        private static OptionalIntCooldown inactive() {
+            return new OptionalIntCooldown(false, 0);
+        }
+    }
+
+    private static final class PendingTeleport {
+        private final TeleportPlan plan;
+        private final Location startLocation;
+        private int remainingSeconds;
+        private BukkitTask task;
+
+        private PendingTeleport(TeleportPlan plan, Location startLocation, int remainingSeconds) {
+            this.plan = plan;
+            this.startLocation = startLocation;
+            this.remainingSeconds = remainingSeconds;
+        }
+
+        private TeleportPlan plan() {
+            return plan;
+        }
+
+        private Location startLocation() {
+            return startLocation;
+        }
+
+        private int remainingSeconds() {
+            return remainingSeconds;
+        }
+
+        private void decrementRemainingSeconds() {
+            remainingSeconds--;
+        }
+
+        private BukkitTask task() {
+            return task;
+        }
+
+        private void setTask(BukkitTask task) {
+            this.task = task;
+        }
+    }
+}

src/main/resources/blocks-menu.yml

@@ -0,0 +1,73 @@
+# ============================================================================
+# EssentialsC - 便捷菜单布局
+# ============================================================================
+# 模块总开关位于 modules.yml：modules.blocks.enabled
+# 菜单名称与物品文本位于 lang/<语言>.yml 的 blocks-menu 节点。
+
+config-version: 1
+layout-version: 2
+
+# 每个菜单项包含：
+#   slot       槽位编号，范围为 0 - 35
+#   material   Bukkit Material 名称
+#   permission 显示并使用该项目所需的权限
+#   command    点击后执行的 EssentialsC 命令键
+
+sections:
+  # 功能方块命令
+  blocks:
+    items:
+      workbench:
+        slot: 10
+        material: CRAFTING_TABLE
+        permission: essentialsc.command.workbench
+        command: workbench
+      enderchest:
+        slot: 11
+        material: ENDER_CHEST
+        permission: essentialsc.command.enderchest
+        command: enderchest
+      anvil:
+        slot: 12
+        material: ANVIL
+        permission: essentialsc.command.anvil
+        command: anvil
+      grindstone:
+        slot: 19
+        material: GRINDSTONE
+        permission: essentialsc.command.grindstone
+        command: grindstone
+      smithingtable:
+        slot: 20
+        material: SMITHING_TABLE
+        permission: essentialsc.command.smithingtable
+        command: smithingtable
+      stonecutter:
+        slot: 21
+        material: STONECUTTER
+        permission: essentialsc.command.stonecutter
+        command: stonecutter
+      loom:
+        slot: 28
+        material: LOOM
+        permission: essentialsc.command.loom
+        command: loom
+      cartographytable:
+        slot: 29
+        material: CARTOGRAPHY_TABLE
+        permission: essentialsc.command.cartographytable
+        command: cartographytable
+
+  # 玩家快捷功能
+  shortcuts:
+    items:
+      nightvision:
+        slot: 14
+        material: TINTED_GLASS
+        permission: essentialsc.command.nightvision
+        command: nightvision
+      glow:
+        slot: 15
+        material: GLOWSTONE
+        permission: essentialsc.command.glow
+        command: glow

src/main/resources/config.yml

@@ -1,96 +1,72 @@
-# EssentialsC 主配置文件
+# EssentialsC 主配置
+# 其他配置：modules.yml、maintenance.yml、skin-bridge.yml、blocks-menu.yml
+# 消息与颜色：lang/<语言>.yml
+# 修改后使用 /essc reload 重载；命令注册状态发生变化时建议重启服务器。
 
-# 配置文件版本号
 config-version: 2
-
-# 语言文件名称，对应插件数据目录下 lang/<语言名>.yml
 language: "zh_CN"
 
+# 输出 EssentialsC 及所有功能模块的详细调试日志。
+debug: false
+
+# 管理模式
 admin-mode:
-  # 原版默认飞行速度为 0.1，这里 0.2 表示两倍飞行速度
+  # 原版飞行速度为 0.1；0.2 表示两倍速度。
   fly-speed: 0.2
+  # 状态提示刷新间隔，单位为 tick。
   actionbar:
-    # 管理模式状态提示的刷新间隔，单位为 tick
     interval-ticks: 40
 
-jei-sync:
-  # 是否启用 JEI 配方同步修复
-  enabled: true
-  # 是否输出调试日志
-  debug: false
-  # 是否在玩家加入时发送同步提示
-  send-player-message: true
-
-mob-drops:
-  enderman:
-    # 是否允许末影人掉落方块
-    enabled: true
-
+# TPS 状态栏：off（关闭）/ auto（自动检测）/ on（请求启用）
 tpsbar:
-  # 可选值：off / auto / on
-  # auto: 若服务端没有原生 /tpsbar，则启用插件实现
-  # on: 始终启用插件实现；若服务端已有原生命令，则自动跳过以避免冲突
   mode: auto
 
-blocks-menu:
-  # 菜单布局版本，用于后续自动迁移槽位布局
-  layout-version: 2
-  sections:
-    blocks:
-      items:
-        workbench:
-          # 物品所在槽位
-          slot: 10
-          # 菜单图标材质
-          material: CRAFTING_TABLE
-          # 所需权限
-          permission: essentialsc.command.workbench
-          # 点击后执行的命令键
-          command: workbench
-        enderchest:
-          slot: 11
-          material: ENDER_CHEST
-          permission: essentialsc.command.enderchest
-          command: enderchest
-        anvil:
-          slot: 12
-          material: ANVIL
-          permission: essentialsc.command.anvil
-          command: anvil
-        grindstone:
-          slot: 19
-          material: GRINDSTONE
-          permission: essentialsc.command.grindstone
-          command: grindstone
-        smithingtable:
-          slot: 20
-          material: SMITHING_TABLE
-          permission: essentialsc.command.smithingtable
-          command: smithingtable
-        stonecutter:
-          slot: 21
-          material: STONECUTTER
-          permission: essentialsc.command.stonecutter
-          command: stonecutter
-        loom:
-          slot: 28
-          material: LOOM
-          permission: essentialsc.command.loom
-          command: loom
-        cartographytable:
-          slot: 29
-          material: CARTOGRAPHY_TABLE
-          permission: essentialsc.command.cartographytable
-          command: cartographytable
-    shortcuts:
-      items:
-        nightvision:
-          slot: 14
-          material: TINTED_GLASS
-          permission: essentialsc.command.nightvision
-          command: nightvision
-        glow:
-          slot: 15
-          material: GLOWSTONE
-          permission: essentialsc.command.glow
-          command: glow
+# JEI 配方同步修复；同时受 modules.yml 中的模块开关控制。
+jei-sync:
+  enabled: true
+  # 玩家加入后延迟多少 tick 检测客户端品牌。
+  brand-check-delay-ticks: 20
+  send-player-message: true
+
+# 生物掉落
+mob-drops:
+  enderman:
+    # 允许末影人掉落搬运的方块。
+    enabled: true
+
+# TPA 传送请求，行为参考 HuskHomes。
+tpa:
+  # 请求有效时间，单位为秒。
+  timeout-seconds: 60
+
+  # 位置规则
+  # /tpa：使用目标接受请求时的位置快照。
+  strict-tpa-requests: false
+  # /tpahere：使用请求者发起请求时的位置快照。
+  strict-tpahere-requests: true
+
+  # 传送预热
+  warmup-seconds: 5
+  cancel-warmup-on-move: true
+  cancel-warmup-on-damage: true
+  # chat / actionbar / title / subtitle / none
+  warmup-display: actionbar
+  # 异步传送会先加载目标区块，推荐 Paper / Leaves 服务器保持开启。
+  teleport-async: true
+  # 传送完成后的无敌时间，单位为秒；0 表示关闭。
+  teleport-invulnerability-seconds: 0
+
+  # 冷却时间；单位为秒，0 表示关闭对应冷却。
+  cooldowns:
+    enabled: true
+    cooldown-times:
+      SEND_TELEPORT_REQUEST: 0
+      ACCEPT_TELEPORT_REQUEST: 0
+
+  # 音效
+  sounds:
+    enabled: true
+    request-received: "entity.experience_orb.pickup"
+    warmup: "block.note_block.banjo"
+    cancelled: "entity.item.break"
+    complete: "entity.enderman.teleport"

src/main/resources/lang/en_US.yml

@@ -1,184 +1,261 @@
 # English language file
+# HuskHomes-inspired style: MiniMessage, green success, red errors, gray details.
 
-prefix: "&6[EssentialsC] &r"
+prefix: ''
 
 messages:
-  no-permission: "&cYou don't have permission to use this command!\n&7Required permission: {permission}"
-  player-only: "&cThis command can only be executed by players!"
-  config-reloaded: "&aConfiguration reloaded."
-  version: "&fEssentialsC v{version}"
-  paper-version: "&7Running on Paper {version}"
-  unknown-subcommand: "&cUnknown subcommand: {command}"
-  help-usage: "&7Use &f/essc help &7to view available commands."
-  module-disabled: "&cThis feature module is currently disabled. Please contact an administrator."
-  blocks-menu-empty: "&cYou do not currently have any available shortcut menu entries."
+  no-permission: '<#FF3300>Error:</#FF3300> <#FF7E5E>You do not have permission to use this command.</#FF7E5E> <gray>Required: {permission}</gray>'
+  player-only: '<#FF3300>Error:</#FF3300> <#FF7E5E>This command can only be run by players.</#FF7E5E>'
+  config-reloaded: '<#00FB9A>Configuration reloaded.</#00FB9A>'
+  version: '<#00FB9A>EssentialsC v{version}</#00FB9A>'
+  paper-version: '<gray>Running on Paper {version}</gray>'
+  unknown-subcommand: '<#FF3300>Error:</#FF3300> <#FF7E5E>Unknown subcommand: {command}</#FF7E5E>'
+  help-usage: '<gray>Use <white>/essc help</white> to view available commands.</gray>'
+  module-disabled: '<#FF3300>Error:</#FF3300> <#FF7E5E>This feature module is currently disabled.</#FF7E5E>'
+  blocks-menu-empty: '<#FF3300>Error:</#FF3300> <#FF7E5E>You do not have any available shortcut menu entries.</#FF7E5E>'
 
-  hat-success: "&aYou are now wearing {item} on your head!"
-  hat-failed: "&cFailed to wear the item on your head!"
-  hat-no-item: "&cYou need to hold an item in your hand!"
-  suicide-message: "&e{player} has committed suicide!"
-  fly-enabled: "&aFlight mode enabled!"
-  fly-disabled: "&cFlight mode disabled!"
-  nightvision-enabled: "&aNight vision enabled!"
-  nightvision-disabled: "&cNight vision disabled!"
-  nightvision-usage: "&cUsage: /nightvision [on|off|toggle]"
-  glow-enabled: "&aGlowing enabled!"
-  glow-disabled: "&cGlowing disabled!"
-  glow-usage: "&cUsage: /glow [on|off|toggle]"
-  vanish-enabled: "&aYou are now vanished!"
-  vanish-disabled: "&cYou are no longer vanished!"
-  seen-usage: "&cUsage: /seen <player>"
-  seen-usage-console: "&cUsage: /seen <player>"
-  player-not-found: "&cPlayer not found: {player}"
-  no-permission-others: "&cYou don't have permission to affect other players!"
+  hat-success: '<#00FB9A>You are now wearing <bold>{item}</bold> on your head.</#00FB9A>'
+  hat-failed: '<#FF3300>Error:</#FF3300> <#FF7E5E>Could not wear that item on your head.</#FF7E5E>'
+  hat-no-item: '<#FF3300>Error:</#FF3300> <#FF7E5E>You need to hold an item.</#FF7E5E>'
+  suicide-message: '<#FF7E5E>{player} died by suicide.</#FF7E5E>'
+  fly-enabled: '<#00FB9A>Flight mode enabled.</#00FB9A>'
+  fly-disabled: '<#FF7E5E>Flight mode disabled.</#FF7E5E>'
+  nightvision-enabled: '<#00FB9A>Night vision enabled.</#00FB9A>'
+  nightvision-disabled: '<#FF7E5E>Night vision disabled.</#FF7E5E>'
+  nightvision-usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /nightvision [on|off|toggle]</#FF7E5E>'
+  glow-enabled: '<#00FB9A>Glowing enabled.</#00FB9A>'
+  glow-disabled: '<#FF7E5E>Glowing disabled.</#FF7E5E>'
+  glow-usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /glow [on|off|toggle]</#FF7E5E>'
+  vanish-enabled: '<#00FB9A>You are now vanished.</#00FB9A>'
+  vanish-disabled: '<#FF7E5E>You are no longer vanished.</#FF7E5E>'
+  seen-usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /seen [player]</#FF7E5E>'
+  seen-usage-console: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /seen [player]</#FF7E5E>'
+  player-not-found: '<#FF3300>Error:</#FF3300> <#FF7E5E>Could not find the player {player}.</#FF7E5E>'
+  no-permission-others: '<#FF3300>Error:</#FF3300> <#FF7E5E>You do not have permission to affect other players.</#FF7E5E>'
 
-  anvil-opened: "&aAnvil opened!"
-  enchantingtable-opened: "&aEnchanting table opened!"
-  heal-self: "&aYour health and hunger have been restored!"
-  heal-other: "&aYou have healed player {player}!"
-  heal-by-other: "&aYou have been healed by admin {admin}!"
-  feed-self: "&aYour hunger has been restored!"
-  feed-other: "&aYou have fed player {player}!"
-  feed-by-other: "&aYou have been fed by admin {admin}!"
-  repair-hand-success: "&aItem in hand repaired!"
-  repair-all-success: "&aRepaired {count} items!"
-  repair-not-damaged: "&cThis item is not damaged!"
-  repair-no-item-in-hand: "&cYou don't have an item in your hand!"
-  repair-no-items: "&cNo repairable items in inventory!"
-  no-permission-repair-all: "&cYou don't have permission to repair all items!"
+  anvil-opened: '<#00FB9A>Opened an anvil.</#00FB9A>'
+  enchantingtable-opened: '<#00FB9A>Opened an enchanting table.</#00FB9A>'
+  heal-self: '<#00FB9A>Your health and hunger have been restored.</#00FB9A>'
+  heal-other: '<#00FB9A>You healed <bold>{player}</bold>.</#00FB9A>'
+  heal-by-other: '<#00FB9A>You were healed by <bold>{admin}</bold>.</#00FB9A>'
+  feed-self: '<#00FB9A>Your hunger has been restored.</#00FB9A>'
+  feed-other: '<#00FB9A>You fed <bold>{player}</bold>.</#00FB9A>'
+  feed-by-other: '<#00FB9A>You were fed by <bold>{admin}</bold>.</#00FB9A>'
+  repair-hand-success: '<#00FB9A>Repaired the item in your hand.</#00FB9A>'
+  repair-all-success: '<#00FB9A>Repaired <bold>{count}</bold> item(s).</#00FB9A>'
+  repair-not-damaged: '<#FF3300>Error:</#FF3300> <#FF7E5E>This item is not damaged.</#FF7E5E>'
+  repair-no-item-in-hand: '<#FF3300>Error:</#FF3300> <#FF7E5E>You do not have an item in your hand.</#FF7E5E>'
+  repair-no-items: '<#FF3300>Error:</#FF3300> <#FF7E5E>There are no repairable items in your inventory.</#FF7E5E>'
+  no-permission-repair-all: '<#FF3300>Error:</#FF3300> <#FF7E5E>You do not have permission to repair all items.</#FF7E5E>'
 
-  mobdrop-save-failed: "&cFailed to save config: {error}"
-  mobdrop-toggled: "&aEnderman drops are now {status}&a."
-  shulkerbox-nested: "&cYou cannot put a shulker box inside another shulker box."
-  shulkerbox-unstack-first: "&cPlease unstack the shulker box before using quick open."
-  jei-sync-fabric: "&6JEI-FIX&8(&bFabric&8): &eSynchronizing recipes..."
-  jei-sync-neoforge: "&6JEI-FIX&8(&bNeoForge&8): &eSynchronizing recipes..."
+  mobdrop-save-failed: '<#FF3300>Error:</#FF3300> <#FF7E5E>Failed to save config: {error}</#FF7E5E>'
+  mobdrop-toggled: '<#00FB9A>Enderman drops are now {status}.</#00FB9A>'
+  shulkerbox-nested: '<#FF3300>Error:</#FF3300> <#FF7E5E>You cannot put a shulker box inside another shulker box.</#FF7E5E>'
+  shulkerbox-unstack-first: '<#FF3300>Error:</#FF3300> <#FF7E5E>Please unstack the shulker box before quick opening it.</#FF7E5E>'
+  jei-sync-fabric: '<#00FB9A>Synchronizing recipes for your <bold>Fabric</bold> client…</#00FB9A>'
+  jei-sync-neoforge: '<#00FB9A>Synchronizing recipes for your <bold>NeoForge</bold> client…</#00FB9A>'
 
 help:
-  title: "&6========== &eEssentialsC Help &6=========="
-  version: "&7Plugin Version: &f{version}"
-  section-blocks: "&6Functional Block Commands:"
-  section-other: "&6Other Commands:"
-  footer: "&7Each command requires the corresponding permission."
+  title: '<#00FB9A><bold>EssentialsC</bold></#00FB9A> <gray>Command Help</gray>'
+  version: '<gray>Plugin version: <white>{version}</white></gray>'
+  section-blocks: '<#00FB9A>Functional Block Commands</#00FB9A>'
+  section-other: '<#00FB9A>Other Commands</#00FB9A>'
+  footer: '<gray>Each command requires the corresponding permission.</gray>'
 
   commands:
-    workbench: "  &f/workbench &7- Open a crafting table"
-    anvil: "  &f/anvil &7- Open an anvil"
-    enchantingtable: "  &f/enchantingtable &7- Open an enchanting table"
-    cartographytable: "  &f/cartographytable &7- Open a cartography table"
-    grindstone: "  &f/grindstone &7- Open a grindstone"
-    loom: "  &f/loom &7- Open a loom"
-    smithingtable: "  &f/smithingtable &7- Open a smithing table"
-    stonecutter: "  &f/stonecutter &7- Open a stonecutter"
-    enderchest: "  &f/enderchest &7- Open your ender chest"
-    blocks: "  &f/blocks &7- Open the shortcut menu"
-    hat: "  &f/hat &7- Wear the held item as a hat"
-    suicide: "  &f/suicide &7- Commit suicide"
-    fly: "  &f/fly &7- Toggle flight mode"
-    nightvision: "  &f/nightvision &7- Toggle night vision"
-    glow: "  &f/glow &7- Toggle glowing"
-    heal: "  &f/heal &7- Restore health and hunger"
-    vanish: "  &f/vanish &7- Toggle vanish mode"
-    seen: "  &f/seen &7- View player information"
-    feed: "  &f/feed &7- Restore hunger"
-    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"
+    workbench: '<white>/workbench</white> <gray>- Open a crafting table</gray>'
+    anvil: '<white>/anvil</white> <gray>- Open an anvil</gray>'
+    enchantingtable: '<white>/enchantingtable</white> <gray>- Open an enchanting table</gray>'
+    cartographytable: '<white>/cartographytable</white> <gray>- Open a cartography table</gray>'
+    grindstone: '<white>/grindstone</white> <gray>- Open a grindstone</gray>'
+    loom: '<white>/loom</white> <gray>- Open a loom</gray>'
+    smithingtable: '<white>/smithingtable</white> <gray>- Open a smithing table</gray>'
+    stonecutter: '<white>/stonecutter</white> <gray>- Open a stonecutter</gray>'
+    enderchest: '<white>/enderchest</white> <gray>- Open your ender chest</gray>'
+    blocks: '<white>/blocks</white> <gray>- Open the shortcut menu</gray>'
+    hat: '<white>/hat</white> <gray>- Wear the held item as a hat</gray>'
+    suicide: '<white>/suicide</white> <gray>- Die by suicide</gray>'
+    fly: '<white>/fly</white> <gray>- Toggle flight mode</gray>'
+    nightvision: '<white>/nightvision</white> <gray>- Toggle night vision</gray>'
+    glow: '<white>/glow</white> <gray>- Toggle glowing</gray>'
+    heal: '<white>/heal</white> <gray>- Restore health and hunger</gray>'
+    vanish: '<white>/vanish</white> <gray>- Toggle vanish mode</gray>'
+    seen: '<white>/seen</white> <gray>- View player information</gray>'
+    feed: '<white>/feed</white> <gray>- Restore hunger</gray>'
+    repair: '<white>/repair</white> <gray>- Repair held or all items</gray>'
+    tpa: '<white>/tpa [player]</white> <gray>- Request to teleport to a player</gray>'
+    tpahere: '<white>/tpahere [player]</white> <gray>- Request a player teleport to you</gray>'
+    tpaall: '<white>/tpaall</white> <gray>- Request all players teleport to you</gray>'
+    tpaccept: '<white>/tpaccept [player]</white> <gray>- Accept a teleport request</gray>'
+    tpdeny: '<white>/tpdeny [player]</white> <gray>- Deny a teleport request</gray>'
+    tpignore: '<white>/tpignore</white> <gray>- Toggle ignoring teleport requests</gray>'
+    skin: '<white>/essc skin [status|refresh] [player]</white> <gray>- View or refresh SkinBridge status</gray>'
+    admin: '<white>/essc admin</white> <gray>- Toggle admin mode</gray>'
+    tpsbar: '<white>/tpsbar [player]</white> <gray>- Toggle TPS boss bar</gray>'
+    maintenance: '<white>/maintenance [on|off|status|reload|add|remove|list]</white> <gray>- Manage maintenance mode</gray>'
+
+tpa:
+  messages:
+    usage-tpa: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /tpa [player]</#FF7E5E>'
+    usage-tpahere: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /tpahere [player]</#FF7E5E>'
+    usage-tpaall: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /tpaall</#FF7E5E>'
+    usage-tpaccept: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /tpaccept [player]</#FF7E5E>'
+    usage-tpdeny: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /tpdeny [player]</#FF7E5E>'
+    self: '<#FF3300>Error:</#FF3300> <#FF7E5E>You cannot send a teleport request to yourself.</#FF7E5E>'
+    sent-tpa: '<#00FB9A>You sent a teleport request asking to teleport to</#00FB9A> <bold><#00FB9A>{target}</#00FB9A></bold><#00FB9A>.</#00FB9A>'
+    sent-tpahere: '<#00FB9A>You sent a teleport request asking</#00FB9A> <bold><#00FB9A>{target}</#00FB9A></bold> <#00FB9A>to teleport to you.</#00FB9A>'
+    ignoring-requests: '<#FF3300>Error:</#FF3300> <#FF7E5E>You are currently ignoring teleport requests.</#FF7E5E> <#FF7E5E><click:run_command:/tpignore><hover:show_text:"<#FF7E5E>Click to listen for incoming teleport requests</#FF7E5E>">[Stop Ignoring...]</hover></click></#FF7E5E>'
+    send-cooldown: '<#FF3300>Error:</#FF3300> <#FF7E5E>You must wait {seconds}s before doing that again.</#FF7E5E>'
+    accept-cooldown: '<#FF3300>Error:</#FF3300> <#FF7E5E>You must wait {seconds}s before doing that again.</#FF7E5E>'
+    received-tpa: '<bold><#00FB9A>{requester}</#00FB9A></bold> <#00FB9A>has requested to teleport to you.</#00FB9A>'
+    received-tpahere: '<bold><#00FB9A>{requester}</#00FB9A></bold> <#00FB9A>has requested that you teleport to them.</#00FB9A>'
+    response-buttons: '<gray>Options:</gray> <#00FB9A><click:run_command:''/tpaccept {requester}''><hover:show_text:"<#00FB9A>Accept teleport request\n<dark_gray>Click to accept {requester}''s request</dark_gray></#00FB9A>">[✔ Accept…]</hover></click></#00FB9A>   <#FF3300><click:run_command:''/tpdeny {requester}''><hover:show_text:"<#FF3300>Decline teleport request\n<dark_gray>Click to decline {requester}''s request</dark_gray></#FF3300>">[❌ Decline…]</hover></click></#FF3300>'
+    no-request: '<#FF3300>Error:</#FF3300> <#FF7E5E>You do not have a pending teleport request.</#FF7E5E>'
+    invalid-request: '<#FF3300>Error:</#FF3300> <#FF7E5E>You do not have a pending teleport request from {requester}.</#FF7E5E>'
+    accepted-target: '<#00FB9A>You accepted {requester}''s teleport request!</#00FB9A>'
+    accepted-sender: '<#00FB9A>{target} has accepted your teleport request!</#00FB9A>'
+    denied-target: '<#FF7E5E>You declined {requester}''s teleport request.</#FF7E5E>'
+    denied-sender: '<#FF7E5E>{target} has declined your teleport request.</#FF7E5E>'
+    expired: '<#FF3300>Error:</#FF3300> <#FF7E5E>Your pending teleport request has expired.</#FF7E5E>'
+    player-offline: '<#FF3300>Error:</#FF3300> <#FF7E5E>The sender of your pending teleport request is no longer online.</#FF7E5E>'
+    target-offline: '<#FF3300>Error:</#FF3300> <#FF7E5E>The teleport target could not be found.</#FF7E5E>'
+    already-warming-up: '<#FF3300>Error:</#FF3300> <#FF7E5E>A related player is already warming up for teleportation.</#FF7E5E>'
+    warmup-start: '<#00FB9A>You will be teleported in</#00FB9A> <bold><#00FB9A>{seconds}</#00FB9A></bold> <#00FB9A>seconds, please stand still…</#00FB9A>'
+    warmup-status: '<#00FB9A>Teleporting in</#00FB9A> <bold><#00FB9A>{seconds}</#00FB9A></bold><#00FB9A>…</#00FB9A>'
+    warmup-processing: '<#00FB9A>Teleporting…</#00FB9A>'
+    warmup-cancelled-move: '<#FF7E5E>Teleportation cancelled—you moved!</#FF7E5E>'
+    warmup-cancelled-damage: '<#FF7E5E>Teleportation cancelled—you took damage!</#FF7E5E>'
+    warmup-cancelled-actionbar: '<#FF7E5E>Teleportation cancelled!</#FF7E5E>'
+    warmup-stand-still: '<#FF3300>Error:</#FF3300> <#FF7E5E>You must be standing still before starting a teleport!</#FF7E5E>'
+    teleport-complete: '<#00FB9A>Teleportation complete!</#00FB9A>'
+    teleport-failed: '<#FF3300>Error:</#FF3300> <#FF7E5E>Teleportation could not be completed. Please try again.</#FF7E5E>'
+    ignore-enabled: '<#00FB9A>Now</#00FB9A> <bold><#00FB9A>ignoring</#00FB9A></bold> <#00FB9A>incoming teleport requests.</#00FB9A>'
+    ignore-disabled: '<#00FB9A>Now</#00FB9A> <bold><#00FB9A>listening</#00FB9A></bold> <#00FB9A>to incoming teleport requests.</#00FB9A>'
+    ignore-notification: '<gray>You are currently ignoring teleport requests.</gray>'
+    tpaall-sent: '<#00FB9A>You sent a teleport request to every player asking them to teleport to you.</#00FB9A>'
+    tpaall-no-targets: '<#FF3300>Error:</#FF3300> <#FF7E5E>There are no other players online.</#FF7E5E>'
+
+skin-bridge:
+  notifications:
+    detecting: '<#00FB9A>Detecting your skin source…</#00FB9A>'
+    synced: '<#00FB9A>Skin synchronized through <bold>{provider}</bold>.</#00FB9A>'
+    not-external: '<gray>No external skin provider matched; your current skin was kept.</gray>'
+    failed: '<#FF3300>Error:</#FF3300> <#FF7E5E>Skin detection or synchronization failed. Please try again later.</#FF7E5E>'
+  messages:
+    usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /essc skin [status|refresh] [player]</#FF7E5E>'
+    feature-disabled: '<#FF3300>Error:</#FF3300> <#FF7E5E>SkinBridge is disabled in skin-bridge.yml.</#FF7E5E>'
+    dependency-missing: '<#FF3300>Error:</#FF3300> <#FF7E5E>No valid MineSkin API key is configured in skin-bridge.yml.</#FF7E5E>'
+    no-providers: '<#FF3300>Error:</#FF3300> <#FF7E5E>No valid SkinBridge provider is enabled.</#FF7E5E>'
+    status-external: '<#00FB9A>{player} is identified as an external skin provider player.</#00FB9A> <gray>Provider: <white>{provider}</white></gray>'
+    status-not-external: '<gray>{player} does not match any configured external skin provider.</gray>'
+    status-pending: '<#FFC43B>SkinBridge is still detecting {player}''s login source.</#FFC43B>'
+    status-unknown: '<gray>{player} has not been checked by SkinBridge yet.</gray>'
+    refresh-queued: '<#00FB9A>SkinBridge is detecting and refreshing {player}''s skin.</#00FB9A>'
+    refresh-cached: '<gray>{player} is using a valid skin cache entry.</gray>'
+    refresh-running: '<#FFC43B>SkinBridge is already processing {player}.</#FFC43B>'
 
 blocks-menu:
-  title: "&6&lEssentialsC &8- &e&lShortcut Menu"
+  title: '<#00FB9A><bold>Shortcut Menu</bold></#00FB9A>'
   items:
     workbench:
-      name: "&eWorkbench"
+      name: '<#00FB9A>Workbench</#00FB9A>'
       lore:
-        - "&7/workbench"
-        - "&7Open a crafting table"
+        - '<gray>/workbench</gray>'
+        - '<gray>Open a crafting table</gray>'
     enderchest:
-      name: "&eEnder Chest"
+      name: '<#00FB9A>Ender Chest</#00FB9A>'
       lore:
-        - "&7/enderchest"
-        - "&7Open your ender chest"
+        - '<gray>/enderchest</gray>'
+        - '<gray>Open your ender chest</gray>'
     anvil:
-      name: "&eAnvil"
+      name: '<#00FB9A>Anvil</#00FB9A>'
       lore:
-        - "&7/anvil"
-        - "&7Open an anvil"
+        - '<gray>/anvil</gray>'
+        - '<gray>Open an anvil</gray>'
     grindstone:
-      name: "&eGrindstone"
+      name: '<#00FB9A>Grindstone</#00FB9A>'
       lore:
-        - "&7/grindstone"
-        - "&7Open a grindstone"
+        - '<gray>/grindstone</gray>'
+        - '<gray>Open a grindstone</gray>'
     smithingtable:
-      name: "&eSmithing Table"
+      name: '<#00FB9A>Smithing Table</#00FB9A>'
       lore:
-        - "&7/smithingtable"
-        - "&7Open a smithing table"
+        - '<gray>/smithingtable</gray>'
+        - '<gray>Open a smithing table</gray>'
     stonecutter:
-      name: "&eStonecutter"
+      name: '<#00FB9A>Stonecutter</#00FB9A>'
       lore:
-        - "&7/stonecutter"
-        - "&7Open a stonecutter"
+        - '<gray>/stonecutter</gray>'
+        - '<gray>Open a stonecutter</gray>'
     loom:
-      name: "&eLoom"
+      name: '<#00FB9A>Loom</#00FB9A>'
       lore:
-        - "&7/loom"
-        - "&7Open a loom"
+        - '<gray>/loom</gray>'
+        - '<gray>Open a loom</gray>'
     cartographytable:
-      name: "&eCartography Table"
+      name: '<#00FB9A>Cartography Table</#00FB9A>'
       lore:
-        - "&7/cartographytable"
-        - "&7Open a cartography table"
+        - '<gray>/cartographytable</gray>'
+        - '<gray>Open a cartography table</gray>'
     nightvision:
-      name: "&bNight Vision"
+      name: '<#00FB9A>Night Vision</#00FB9A>'
       lore:
-        - "&7/nightvision"
-        - "&7Toggle night vision"
+        - '<gray>/nightvision</gray>'
+        - '<gray>Toggle night vision</gray>'
     glow:
-      name: "&eGlow"
+      name: '<#00FB9A>Glow</#00FB9A>'
       lore:
-        - "&7/glow"
-        - "&7Toggle your glowing effect"
+        - '<gray>/glow</gray>'
+        - '<gray>Toggle your glowing effect</gray>'
 
 admin-mode:
-  actionbar: "&c&lAdmin Mode"
+  actionbar: '<#FF7E5E><bold>Admin Mode</bold></#FF7E5E>'
   messages:
-    enabled: "&aAdmin mode enabled, normal inventory has been saved."
-    disabled: "&cAdmin mode disabled, normal inventory has been restored."
-    crash-restored: "&eThe previous admin mode session has been restored safely."
+    enabled: '<#00FB9A>Admin mode enabled; normal inventory has been saved.</#00FB9A>'
+    disabled: '<#FF7E5E>Admin mode disabled; normal inventory has been restored.</#FF7E5E>'
+    crash-restored: '<#FFC43B>The previous admin mode session has been restored safely.</#FFC43B>'
 
 tpsbar:
-  title-format: "&eTPS&7: {tps_1m} &8| &eMSPT&7: {mspt} &8| &ePing&7: {ping}"
+  title-format: '<#00FB9A>TPS</#00FB9A><gray>: {tps_1m} | </gray><#00FB9A>MSPT</#00FB9A><gray>: {mspt} | </gray><#00FB9A>Ping</#00FB9A><gray>: {ping}</gray>'
   messages:
-    enabled-self: "&aTPSBar enabled."
-    disabled-self: "&cTPSBar disabled."
-    enabled-other: "&aEnabled TPSBar for {player}."
-    disabled-other: "&cDisabled TPSBar for {player}."
-    usage: "&cUsage: /tpsbar [player]"
-    player-not-found: "&cPlayer not found: {player}"
-    no-targets: "&cNo matching players were found to toggle."
-    native-detected: "&7Detected a native /tpsbar command on this server, skipped plugin implementation."
-    plugin-enabled: "&7No native /tpsbar command was detected, plugin implementation enabled."
-    plugin-forced-but-native-exists: "&eThe configuration requests the plugin TPSBar, but a native /tpsbar already exists, so the plugin implementation was skipped to avoid conflicts."
-    mode-changed-reload: "&eTPSBar mode has been updated, but command registration changes require a server restart to fully take effect."
+    enabled-self: '<#00FB9A>TPSBar enabled.</#00FB9A>'
+    disabled-self: '<#FF7E5E>TPSBar disabled.</#FF7E5E>'
+    enabled-other: '<#00FB9A>Enabled TPSBar for {player}.</#00FB9A>'
+    disabled-other: '<#FF7E5E>Disabled TPSBar for {player}.</#FF7E5E>'
+    usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /tpsbar [player]</#FF7E5E>'
+    player-not-found: '<#FF3300>Error:</#FF3300> <#FF7E5E>Could not find the player {player}.</#FF7E5E>'
+    no-targets: '<#FF3300>Error:</#FF3300> <#FF7E5E>No matching players were found to toggle.</#FF7E5E>'
+    native-detected: '<gray>Detected a native /tpsbar command on this server; skipped plugin implementation.</gray>'
+    plugin-enabled: '<gray>No native /tpsbar command was detected; plugin implementation enabled.</gray>'
+    plugin-forced-but-native-exists: '<#FFC43B>The configuration requests the plugin TPSBar, but a native /tpsbar already exists, so the plugin implementation was skipped to avoid conflicts.</#FFC43B>'
+    mode-changed-reload: '<#FFC43B>TPSBar mode has been updated, but command registration changes require a server restart to fully take effect.</#FFC43B>'
 
 mobdrops-menu:
-  title: "&6&lMob Drop Control"
+  title: '<#00FB9A><bold>Mob Drop Control</bold></#00FB9A>'
   status:
-    enabled: "&aEnabled"
-    disabled: "&cDisabled"
+    enabled: '<#00FB9A>Enabled</#00FB9A>'
+    disabled: '<#FF7E5E>Disabled</#FF7E5E>'
   enderman:
-    name: "&dEnderman Drops"
-    status: "&7Current status: {status}"
-    toggle: "&eClick to toggle"
+    name: '<#00FB9A>Enderman Drops</#00FB9A>'
+    status: '<gray>Current status: {status}</gray>'
+    toggle: '<gray>Click to toggle</gray>'
 
 maintenance:
   status:
-    enabled: "&cEnabled"
-    disabled: "&aDisabled"
+    enabled: '<#FF7E5E>Enabled</#FF7E5E>'
+    disabled: '<#00FB9A>Disabled</#00FB9A>'
   messages:
-    enabled: "&aMaintenance mode enabled."
-    disabled: "&cMaintenance mode disabled."
-    reloaded: "&aMaintenance configuration reloaded."
-    status: "&7Maintenance mode status: {status}"
-    usage: "&cUsage: /maintenance <on|off|status|reload>"
+    enabled: '<#00FB9A>Maintenance mode enabled.</#00FB9A>'
+    disabled: '<#FF7E5E>Maintenance mode disabled.</#FF7E5E>'
+    reloaded: '<#00FB9A>Maintenance configuration reloaded.</#00FB9A>'
+    status: '<gray>Maintenance mode status: {status} | Whitelist: <white>{whitelist_count}</white></gray>'
+    usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /maintenance [on|off|status|reload|add|remove|list]</#FF7E5E>'
+    add-usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /maintenance add [player|uuid]</#FF7E5E>'
+    remove-usage: '<#FF3300>Error:</#FF3300> <#FF7E5E>Usage: /maintenance remove [player|uuid]</#FF7E5E>'
+    whitelist-added: '<#00FB9A>Added {player} to the maintenance whitelist.</#00FB9A>'
+    whitelist-removed: '<#00FB9A>Removed {player} from the maintenance whitelist.</#00FB9A>'
+    whitelist-exists: '<#FFC43B>{player} is already on the maintenance whitelist.</#FFC43B>'
+    whitelist-missing: '<#FF3300>Error:</#FF3300> <#FF7E5E>{player} is not on the maintenance whitelist.</#FF7E5E>'
+    whitelist-empty: '<gray>The maintenance whitelist is empty.</gray>'
+    whitelist-list: '<gray>Maintenance whitelist ({count}): <white>{entries}</white></gray>'
+    login-blocked: '<#FFC43B>{player} was blocked by maintenance mode.</#FFC43B> <gray>UUID: {uuid} | IP: {address}</gray>'

src/main/resources/lang/zh_CN.yml

@@ -1,184 +1,261 @@
 # 简体中文语言文件
+# 文本风格参考 HuskHomes：MiniMessage、绿色成功、红色错误、灰色说明。
 
-prefix: "&7[&6EssentialsC&7]&f：&r"
+prefix: ''
 
 messages:
-  no-permission: "&c你没有权限执行此命令！\n&7需要权限：{permission}"
-  player-only: "&c此命令只能由玩家执行！"
-  config-reloaded: "&a配置已重载。"
-  version: "&fEssentialsC v{version}"
-  paper-version: "&7当前运行于 Paper {version}"
-  unknown-subcommand: "&c未知子命令：{command}"
-  help-usage: "&7使用 &f/essc help &7查看可用命令。"
-  module-disabled: "&c该功能模块当前已关闭，请联系管理员。"
-  blocks-menu-empty: "&c你当前没有可用的便捷菜单项目。"
+  no-permission: '<#FF3300>错误:</#FF3300> <#FF7E5E>你没有权限执行此命令.</#FF7E5E> <gray>需要权限: {permission}</gray>'
+  player-only: '<#FF3300>错误:</#FF3300> <#FF7E5E>此命令只能由玩家执行.</#FF7E5E>'
+  config-reloaded: '<#00FB9A>配置已重载.</#00FB9A>'
+  version: '<#00FB9A>EssentialsC v{version}</#00FB9A>'
+  paper-version: '<gray>当前运行于 Paper {version}</gray>'
+  unknown-subcommand: '<#FF3300>错误:</#FF3300> <#FF7E5E>未知子命令: {command}</#FF7E5E>'
+  help-usage: '<gray>使用 <white>/essc help</white> 查看可用命令.</gray>'
+  module-disabled: '<#FF3300>错误:</#FF3300> <#FF7E5E>该功能模块当前已关闭.</#FF7E5E>'
+  blocks-menu-empty: '<#FF3300>错误:</#FF3300> <#FF7E5E>你当前没有可用的便捷菜单项目.</#FF7E5E>'
 
-  hat-success: "&a你已将 {item} 戴在头上！"
-  hat-failed: "&c无法将该物品戴在头上！"
-  hat-no-item: "&c你需要手持一个物品！"
-  suicide-message: "&e{player} 自杀了！"
-  fly-enabled: "&a飞行模式已开启！"
-  fly-disabled: "&c飞行模式已关闭！"
-  nightvision-enabled: "&a夜视已开启！"
-  nightvision-disabled: "&c夜视已关闭！"
-  nightvision-usage: "&c用法：/nightvision [on|off|toggle]"
-  glow-enabled: "&a发光已开启！"
-  glow-disabled: "&c发光已关闭！"
-  glow-usage: "&c用法：/glow [on|off|toggle]"
-  vanish-enabled: "&a你已进入隐身模式！"
-  vanish-disabled: "&c你已退出隐身模式！"
-  seen-usage: "&c用法：/seen <玩家>"
-  seen-usage-console: "&c用法：/seen <玩家>"
-  player-not-found: "&c未找到玩家：{player}"
-  no-permission-others: "&c你没有权限影响其他玩家！"
+  hat-success: '<#00FB9A>你已将 <bold>{item}</bold> 戴在头上.</#00FB9A>'
+  hat-failed: '<#FF3300>错误:</#FF3300> <#FF7E5E>无法将该物品戴在头上.</#FF7E5E>'
+  hat-no-item: '<#FF3300>错误:</#FF3300> <#FF7E5E>你需要手持一个物品.</#FF7E5E>'
+  suicide-message: '<#FF7E5E>{player} 自杀了.</#FF7E5E>'
+  fly-enabled: '<#00FB9A>飞行模式已开启.</#00FB9A>'
+  fly-disabled: '<#FF7E5E>飞行模式已关闭.</#FF7E5E>'
+  nightvision-enabled: '<#00FB9A>夜视已开启.</#00FB9A>'
+  nightvision-disabled: '<#FF7E5E>夜视已关闭.</#FF7E5E>'
+  nightvision-usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /nightvision [on|off|toggle]</#FF7E5E>'
+  glow-enabled: '<#00FB9A>发光已开启.</#00FB9A>'
+  glow-disabled: '<#FF7E5E>发光已关闭.</#FF7E5E>'
+  glow-usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /glow [on|off|toggle]</#FF7E5E>'
+  vanish-enabled: '<#00FB9A>你已进入隐身模式.</#00FB9A>'
+  vanish-disabled: '<#FF7E5E>你已退出隐身模式.</#FF7E5E>'
+  seen-usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /seen [玩家]</#FF7E5E>'
+  seen-usage-console: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /seen [玩家]</#FF7E5E>'
+  player-not-found: '<#FF3300>错误:</#FF3300> <#FF7E5E>没有找到玩家 {player}.</#FF7E5E>'
+  no-permission-others: '<#FF3300>错误:</#FF3300> <#FF7E5E>你没有权限影响其他玩家.</#FF7E5E>'
 
-  anvil-opened: "&a已打开铁砧！"
-  enchantingtable-opened: "&a已打开附魔台！"
-  heal-self: "&a你的生命值和饥饿值已恢复！"
-  heal-other: "&a你已治疗玩家 {player}！"
-  heal-by-other: "&a管理员 {admin} 治疗了你！"
-  feed-self: "&a你的饥饿值已恢复！"
-  feed-other: "&a你已喂饱玩家 {player}！"
-  feed-by-other: "&a管理员 {admin} 喂饱了你！"
-  repair-hand-success: "&a手中物品已修复！"
-  repair-all-success: "&a已修复 {count} 个物品！"
-  repair-not-damaged: "&c该物品没有损坏！"
-  repair-no-item-in-hand: "&c你手中没有物品！"
-  repair-no-items: "&c背包中没有可修复的物品！"
-  no-permission-repair-all: "&c你没有权限修复全部物品！"
+  anvil-opened: '<#00FB9A>已打开铁砧.</#00FB9A>'
+  enchantingtable-opened: '<#00FB9A>已打开附魔台.</#00FB9A>'
+  heal-self: '<#00FB9A>你的生命值和饥饿值已恢复.</#00FB9A>'
+  heal-other: '<#00FB9A>你已治疗玩家 <bold>{player}</bold>.</#00FB9A>'
+  heal-by-other: '<#00FB9A>管理员 <bold>{admin}</bold> 治疗了你.</#00FB9A>'
+  feed-self: '<#00FB9A>你的饥饿值已恢复.</#00FB9A>'
+  feed-other: '<#00FB9A>你已喂饱玩家 <bold>{player}</bold>.</#00FB9A>'
+  feed-by-other: '<#00FB9A>管理员 <bold>{admin}</bold> 喂饱了你.</#00FB9A>'
+  repair-hand-success: '<#00FB9A>手中物品已修复.</#00FB9A>'
+  repair-all-success: '<#00FB9A>已修复 <bold>{count}</bold> 个物品.</#00FB9A>'
+  repair-not-damaged: '<#FF3300>错误:</#FF3300> <#FF7E5E>该物品没有损坏.</#FF7E5E>'
+  repair-no-item-in-hand: '<#FF3300>错误:</#FF3300> <#FF7E5E>你手中没有物品.</#FF7E5E>'
+  repair-no-items: '<#FF3300>错误:</#FF3300> <#FF7E5E>背包中没有可修复的物品.</#FF7E5E>'
+  no-permission-repair-all: '<#FF3300>错误:</#FF3300> <#FF7E5E>你没有权限修复全部物品.</#FF7E5E>'
 
-  mobdrop-save-failed: "&c保存配置失败：{error}"
-  mobdrop-toggled: "&a末影人掉落已切换为 {status}&a。"
-  shulkerbox-nested: "&c不能将潜影盒放入另一个潜影盒。"
-  shulkerbox-unstack-first: "&c请先将潜影盒拆分为单个后再快捷打开。"
-  jei-sync-fabric: "&6JEI-FIX&8(&bFabric&8): &e正在同步配方..."
-  jei-sync-neoforge: "&6JEI-FIX&8(&bNeoForge&8): &e正在同步配方..."
+  mobdrop-save-failed: '<#FF3300>错误:</#FF3300> <#FF7E5E>保存配置失败: {error}</#FF7E5E>'
+  mobdrop-toggled: '<#00FB9A>末影人掉落已切换为 {status}.</#00FB9A>'
+  shulkerbox-nested: '<#FF3300>错误:</#FF3300> <#FF7E5E>不能将潜影盒放入另一个潜影盒.</#FF7E5E>'
+  shulkerbox-unstack-first: '<#FF3300>错误:</#FF3300> <#FF7E5E>请先将潜影盒拆分为单个后再快捷打开.</#FF7E5E>'
+  jei-sync-fabric: '<#00FB9A>正在为 <bold>Fabric</bold> 客户端同步配方…</#00FB9A>'
+  jei-sync-neoforge: '<#00FB9A>正在为 <bold>NeoForge</bold> 客户端同步配方…</#00FB9A>'
 
 help:
-  title: "&6========== &eEssentialsC 帮助 &6=========="
-  version: "&7插件版本：&f{version}"
-  section-blocks: "&6功能方块命令："
-  section-other: "&6其他命令："
-  footer: "&7每个命令都需要对应权限。"
+  title: '<#00FB9A><bold>EssentialsC</bold></#00FB9A> <gray>命令帮助</gray>'
+  version: '<gray>插件版本: <white>{version}</white></gray>'
+  section-blocks: '<#00FB9A>功能方块命令</#00FB9A>'
+  section-other: '<#00FB9A>其他命令</#00FB9A>'
+  footer: '<gray>每个命令都需要对应权限.</gray>'
 
   commands:
-    workbench: "  &f/workbench &7- 打开工作台"
-    anvil: "  &f/anvil &7- 打开铁砧"
-    enchantingtable: "  &f/enchantingtable &7- 打开附魔台"
-    cartographytable: "  &f/cartographytable &7- 打开制图台"
-    grindstone: "  &f/grindstone &7- 打开砂轮"
-    loom: "  &f/loom &7- 打开织布机"
-    smithingtable: "  &f/smithingtable &7- 打开锻造台"
-    stonecutter: "  &f/stonecutter &7- 打开切石机"
-    enderchest: "  &f/enderchest &7- 打开末影箱"
-    blocks: "  &f/blocks &7- 打开便捷菜单"
-    hat: "  &f/hat &7- 将手持物品戴在头上"
-    suicide: "  &f/suicide &7- 自杀"
-    fly: "  &f/fly &7- 切换飞行模式"
-    nightvision: "  &f/nightvision &7- 切换夜视"
-    glow: "  &f/glow &7- 切换发光"
-    heal: "  &f/heal &7- 恢复生命值和饥饿值"
-    vanish: "  &f/vanish &7- 切换隐身模式"
-    seen: "  &f/seen &7- 查看玩家信息"
-    feed: "  &f/feed &7- 恢复饥饿值"
-    repair: "  &f/repair &7- 修复手中或全部物品"
-    admin: "  &f/essc admin &7- 切换管理模式"
-    tpsbar: "  &f/tpsbar [玩家] &7- 切换 TPS 状态栏"
-    maintenance: "  &f/maintenance <on|off|status|reload> &7- 管理维护模式"
+    workbench: '<white>/workbench</white> <gray>- 打开工作台</gray>'
+    anvil: '<white>/anvil</white> <gray>- 打开铁砧</gray>'
+    enchantingtable: '<white>/enchantingtable</white> <gray>- 打开附魔台</gray>'
+    cartographytable: '<white>/cartographytable</white> <gray>- 打开制图台</gray>'
+    grindstone: '<white>/grindstone</white> <gray>- 打开砂轮</gray>'
+    loom: '<white>/loom</white> <gray>- 打开织布机</gray>'
+    smithingtable: '<white>/smithingtable</white> <gray>- 打开锻造台</gray>'
+    stonecutter: '<white>/stonecutter</white> <gray>- 打开切石机</gray>'
+    enderchest: '<white>/enderchest</white> <gray>- 打开末影箱</gray>'
+    blocks: '<white>/blocks</white> <gray>- 打开便捷菜单</gray>'
+    hat: '<white>/hat</white> <gray>- 将手持物品戴在头上</gray>'
+    suicide: '<white>/suicide</white> <gray>- 自杀</gray>'
+    fly: '<white>/fly</white> <gray>- 切换飞行模式</gray>'
+    nightvision: '<white>/nightvision</white> <gray>- 切换夜视</gray>'
+    glow: '<white>/glow</white> <gray>- 切换发光</gray>'
+    heal: '<white>/heal</white> <gray>- 恢复生命值和饥饿值</gray>'
+    vanish: '<white>/vanish</white> <gray>- 切换隐身模式</gray>'
+    seen: '<white>/seen</white> <gray>- 查看玩家信息</gray>'
+    feed: '<white>/feed</white> <gray>- 恢复饥饿值</gray>'
+    repair: '<white>/repair</white> <gray>- 修复手中或全部物品</gray>'
+    tpa: '<white>/tpa [玩家]</white> <gray>- 请求传送到玩家身边</gray>'
+    tpahere: '<white>/tpahere [玩家]</white> <gray>- 请求玩家传送到你身边</gray>'
+    tpaall: '<white>/tpaall</white> <gray>- 向所有玩家发送传送到你身边的请求</gray>'
+    tpaccept: '<white>/tpaccept [玩家]</white> <gray>- 接受传送请求</gray>'
+    tpdeny: '<white>/tpdeny [玩家]</white> <gray>- 拒绝传送请求</gray>'
+    tpignore: '<white>/tpignore</white> <gray>- 切换是否忽略传送请求</gray>'
+    skin: '<white>/essc skin [status|refresh] [玩家]</white> <gray>- 查看或刷新皮肤桥接状态</gray>'
+    admin: '<white>/essc admin</white> <gray>- 切换管理模式</gray>'
+    tpsbar: '<white>/tpsbar [玩家]</white> <gray>- 切换 TPS 状态栏</gray>'
+    maintenance: '<white>/maintenance [on|off|status|reload|add|remove|list]</white> <gray>- 管理维护模式</gray>'
+
+tpa:
+  messages:
+    usage-tpa: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /tpa [玩家]</#FF7E5E>'
+    usage-tpahere: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /tpahere [玩家]</#FF7E5E>'
+    usage-tpaall: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /tpaall</#FF7E5E>'
+    usage-tpaccept: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /tpaccept [玩家]</#FF7E5E>'
+    usage-tpdeny: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /tpdeny [玩家]</#FF7E5E>'
+    self: '<#FF3300>错误:</#FF3300> <#FF7E5E>不能向自己发送传送请求</#FF7E5E>'
+    sent-tpa: '<#00FB9A>已发送传送请求,请求传送到</#00FB9A> <bold><#00FB9A>{target}</#00FB9A></bold>'
+    sent-tpahere: '<#00FB9A>已发送传送请求,请求</#00FB9A> <bold><#00FB9A>{target}</#00FB9A></bold> <#00FB9A>传送到你的位置</#00FB9A>'
+    ignoring-requests: '<#FF3300>错误:</#FF3300> <#FF7E5E>你已忽略传送请求</#FF7E5E> <#FF7E5E><click:run_command:/tpignore><hover:show_text:"<#FF7E5E>点击恢复接收传送请求</#FF7E5E>">[恢复接收]</hover></click></#FF7E5E>'
+    send-cooldown: '<#FF3300>错误:</#FF3300> <#FF7E5E>你需要等待 {seconds}s 才能再次进行此操作</#FF7E5E>'
+    accept-cooldown: '<#FF3300>错误:</#FF3300> <#FF7E5E>你需要等待 {seconds}s 才能再次进行此操作</#FF7E5E>'
+    received-tpa: '<bold><#00FB9A>{requester}</#00FB9A></bold> <#00FB9A>请求传送到你的位置</#00FB9A>'
+    received-tpahere: '<bold><#00FB9A>{requester}</#00FB9A></bold> <#00FB9A>请求你传送到他的位置</#00FB9A>'
+    response-buttons: '<gray>选项:</gray> <#00FB9A><click:run_command:''/tpaccept {requester}''><hover:show_text:''<#00FB9A>接受传送请求\n<dark_gray>点击接受 {requester} 的请求</dark_gray></#00FB9A>''>[✔ 接受]</hover></click></#00FB9A>   <#FF3300><click:run_command:''/tpdeny {requester}''><hover:show_text:''<#FF3300>拒绝传送请求\n<dark_gray>点击拒绝 {requester} 的请求</dark_gray></#FF3300>''>[❌ 拒绝]</hover></click></#FF3300>'
+    no-request: '<#FF3300>错误:</#FF3300> <#FF7E5E>你没有待处理的传送请求</#FF7E5E>'
+    invalid-request: '<#FF3300>错误:</#FF3300> <#FF7E5E>目前没有来自 {requester} 的传送请求</#FF7E5E>'
+    accepted-target: '<#00FB9A>已接受 {requester} 的传送请求</#00FB9A>'
+    accepted-sender: '<#00FB9A>{target} 接受了你的传送请求</#00FB9A>'
+    denied-target: '<#FF7E5E>已拒绝 {requester} 的传送请求</#FF7E5E>'
+    denied-sender: '<#FF7E5E>{target} 拒绝了你的传送请求</#FF7E5E>'
+    expired: '<#FF3300>错误:</#FF3300> <#FF7E5E>传送请求已过期</#FF7E5E>'
+    player-offline: '<#FF3300>错误:</#FF3300> <#FF7E5E>你待处理的传送请求目标玩家不在线</#FF7E5E>'
+    target-offline: '<#FF3300>错误:</#FF3300> <#FF7E5E>没有找到目标玩家</#FF7E5E>'
+    already-warming-up: '<#FF3300>错误:</#FF3300> <#FF7E5E>相关玩家已有一个正在预热的传送</#FF7E5E>'
+    warmup-start: '<#00FB9A>你将在</#00FB9A> <bold><#00FB9A>{seconds}</#00FB9A></bold> <#00FB9A>秒后被传送,请不要移动…</#00FB9A>'
+    warmup-status: '<#00FB9A>将在</#00FB9A> <bold><#00FB9A>{seconds}</#00FB9A></bold><#00FB9A>秒后传送…</#00FB9A>'
+    warmup-processing: '<#00FB9A>传送中…</#00FB9A>'
+    warmup-cancelled-move: '<#FF7E5E>传送取消: 你移动了!</#FF7E5E>'
+    warmup-cancelled-damage: '<#FF7E5E>传送取消: 你受到了伤害!</#FF7E5E>'
+    warmup-cancelled-actionbar: '<#FF7E5E>传送取消!</#FF7E5E>'
+    warmup-stand-still: '<#FF3300>错误:</#FF3300> <#FF7E5E>在传送时你不能移动!</#FF7E5E>'
+    teleport-complete: '<#00FB9A>传送完成!</#00FB9A>'
+    teleport-failed: '<#FF3300>错误:</#FF3300> <#FF7E5E>无法完成传送,请稍后重试</#FF7E5E>'
+    ignore-enabled: '<#00FB9A>你已</#00FB9A> <bold><#00FB9A>忽略</#00FB9A></bold> <#00FB9A>传送请求</#00FB9A>'
+    ignore-disabled: '<#00FB9A>你已</#00FB9A> <bold><#00FB9A>恢复接收</#00FB9A></bold> <#00FB9A>传送请求</#00FB9A>'
+    ignore-notification: '<gray>你当前正在忽略传送请求.</gray>'
+    tpaall-sent: '<#00FB9A>你已向所有玩家发送传送请求,请求他们传送到你的位置</#00FB9A>'
+    tpaall-no-targets: '<#FF3300>错误:</#FF3300> <#FF7E5E>当前没有其他在线玩家.</#FF7E5E>'
+
+skin-bridge:
+  notifications:
+    detecting: '<#00FB9A>正在检测你的皮肤来源…</#00FB9A>'
+    synced: '<#00FB9A>已通过 <bold>{provider}</bold> 同步皮肤.</#00FB9A>'
+    not-external: '<gray>未匹配外置皮肤站,已保留当前皮肤.</gray>'
+    failed: '<#FF3300>错误:</#FF3300> <#FF7E5E>皮肤检测或同步失败,请稍后重试.</#FF7E5E>'
+  messages:
+    usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /essc skin [status|refresh] [玩家]</#FF7E5E>'
+    feature-disabled: '<#FF3300>错误:</#FF3300> <#FF7E5E>SkinBridge 在 skin-bridge.yml 中未启用.</#FF7E5E>'
+    dependency-missing: '<#FF3300>错误:</#FF3300> <#FF7E5E>未在 skin-bridge.yml 中配置有效的 MineSkin API Key.</#FF7E5E>'
+    no-providers: '<#FF3300>错误:</#FF3300> <#FF7E5E>没有启用有效的 SkinBridge Provider.</#FF7E5E>'
+    status-external: '<#00FB9A>{player} 已识别为外置皮肤站玩家.</#00FB9A> <gray>Provider: <white>{provider}</white></gray>'
+    status-not-external: '<gray>{player} 未匹配任何已配置的外置皮肤站.</gray>'
+    status-pending: '<#FFC43B>{player} 的皮肤站来源正在检测中.</#FFC43B>'
+    status-unknown: '<gray>{player} 尚未进行 SkinBridge 检测.</gray>'
+    refresh-queued: '<#00FB9A>已开始重新检测并刷新 {player} 的皮肤.</#00FB9A>'
+    refresh-cached: '<gray>{player} 正在使用有效的皮肤缓存.</gray>'
+    refresh-running: '<#FFC43B>{player} 的皮肤检测任务仍在运行.</#FFC43B>'
 
 blocks-menu:
-  title: "&6&lEssentialsC &8- &e&l便捷菜单"
+  title: '<#00FB9A><bold>便捷菜单</bold></#00FB9A>'
   items:
     workbench:
-      name: "&e工作台"
+      name: '<#00FB9A>工作台</#00FB9A>'
       lore:
-        - "&7/workbench"
-        - "&7打开工作台"
+        - '<gray>/workbench</gray>'
+        - '<gray>打开工作台</gray>'
     enderchest:
-      name: "&e末影箱"
+      name: '<#00FB9A>末影箱</#00FB9A>'
       lore:
-        - "&7/enderchest"
-        - "&7打开末影箱"
+        - '<gray>/enderchest</gray>'
+        - '<gray>打开末影箱</gray>'
     anvil:
-      name: "&e铁砧"
+      name: '<#00FB9A>铁砧</#00FB9A>'
       lore:
-        - "&7/anvil"
-        - "&7打开铁砧"
+        - '<gray>/anvil</gray>'
+        - '<gray>打开铁砧</gray>'
     grindstone:
-      name: "&e砂轮"
+      name: '<#00FB9A>砂轮</#00FB9A>'
       lore:
-        - "&7/grindstone"
-        - "&7打开砂轮"
+        - '<gray>/grindstone</gray>'
+        - '<gray>打开砂轮</gray>'
     smithingtable:
-      name: "&e锻造台"
+      name: '<#00FB9A>锻造台</#00FB9A>'
       lore:
-        - "&7/smithingtable"
-        - "&7打开锻造台"
+        - '<gray>/smithingtable</gray>'
+        - '<gray>打开锻造台</gray>'
     stonecutter:
-      name: "&e切石机"
+      name: '<#00FB9A>切石机</#00FB9A>'
       lore:
-        - "&7/stonecutter"
-        - "&7打开切石机"
+        - '<gray>/stonecutter</gray>'
+        - '<gray>打开切石机</gray>'
     loom:
-      name: "&e织布机"
+      name: '<#00FB9A>织布机</#00FB9A>'
       lore:
-        - "&7/loom"
-        - "&7打开织布机"
+        - '<gray>/loom</gray>'
+        - '<gray>打开织布机</gray>'
     cartographytable:
-      name: "&e制图台"
+      name: '<#00FB9A>制图台</#00FB9A>'
       lore:
-        - "&7/cartographytable"
-        - "&7打开制图台"
+        - '<gray>/cartographytable</gray>'
+        - '<gray>打开制图台</gray>'
     nightvision:
-      name: "&b夜视开关"
+      name: '<#00FB9A>夜视开关</#00FB9A>'
       lore:
-        - "&7/nightvision"
-        - "&7切换夜视效果"
+        - '<gray>/nightvision</gray>'
+        - '<gray>切换夜视效果</gray>'
     glow:
-      name: "&e发光开关"
+      name: '<#00FB9A>发光开关</#00FB9A>'
       lore:
-        - "&7/glow"
-        - "&7切换自身发光效果"
+        - '<gray>/glow</gray>'
+        - '<gray>切换自身发光效果</gray>'
 
 admin-mode:
-  actionbar: "&c&l管理模式"
+  actionbar: '<#FF7E5E><bold>管理模式</bold></#FF7E5E>'
   messages:
-    enabled: "&a管理模式已开启，普通背包已保存。"
-    disabled: "&c管理模式已关闭，普通背包已恢复。"
-    crash-restored: "&e上一次管理模式会话已安全恢复。"
+    enabled: '<#00FB9A>管理模式已开启,普通背包已保存.</#00FB9A>'
+    disabled: '<#FF7E5E>管理模式已关闭,普通背包已恢复.</#FF7E5E>'
+    crash-restored: '<#FFC43B>上一次管理模式会话已安全恢复.</#FFC43B>'
 
 tpsbar:
-  title-format: "&eTPS&7: {tps_1m} &8| &eMSPT&7: {mspt} &8| &ePing&7: {ping}"
+  title-format: '<#00FB9A>TPS</#00FB9A><gray>: {tps_1m} | </gray><#00FB9A>MSPT</#00FB9A><gray>: {mspt} | </gray><#00FB9A>Ping</#00FB9A><gray>: {ping}</gray>'
   messages:
-    enabled-self: "&a已开启 TPSBar。"
-    disabled-self: "&c已关闭 TPSBar。"
-    enabled-other: "&a已为 {player} 开启 TPSBar。"
-    disabled-other: "&c已为 {player} 关闭 TPSBar。"
-    usage: "&c用法：/tpsbar [玩家]"
-    player-not-found: "&c未找到玩家：{player}"
-    no-targets: "&c没有匹配到可切换的玩家。"
-    native-detected: "&7检测到服务端已内置 /tpsbar，已跳过插件实现。"
-    plugin-enabled: "&7未检测到服务端内置 /tpsbar，已启用插件实现。"
-    plugin-forced-but-native-exists: "&e配置要求启用插件版 TPSBar，但服务端已存在原生 /tpsbar，已跳过插件实现以避免冲突。"
-    mode-changed-reload: "&eTPSBar 模式已更新，但命令注册状态需要重启服务器后才会完全生效。"
+    enabled-self: '<#00FB9A>已开启 TPSBar.</#00FB9A>'
+    disabled-self: '<#FF7E5E>已关闭 TPSBar.</#FF7E5E>'
+    enabled-other: '<#00FB9A>已为 {player} 开启 TPSBar.</#00FB9A>'
+    disabled-other: '<#FF7E5E>已为 {player} 关闭 TPSBar.</#FF7E5E>'
+    usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /tpsbar [玩家]</#FF7E5E>'
+    player-not-found: '<#FF3300>错误:</#FF3300> <#FF7E5E>没有找到玩家 {player}.</#FF7E5E>'
+    no-targets: '<#FF3300>错误:</#FF3300> <#FF7E5E>没有匹配到可切换的玩家.</#FF7E5E>'
+    native-detected: '<gray>检测到服务端已内置 /tpsbar,已跳过插件实现.</gray>'
+    plugin-enabled: '<gray>未检测到服务端内置 /tpsbar,已启用插件实现.</gray>'
+    plugin-forced-but-native-exists: '<#FFC43B>配置要求启用插件版 TPSBar,但服务端已存在原生 /tpsbar,已跳过插件实现以避免冲突.</#FFC43B>'
+    mode-changed-reload: '<#FFC43B>TPSBar 模式已更新,但命令注册状态需要重启服务器后才会完全生效.</#FFC43B>'
 
 mobdrops-menu:
-  title: "&6&l生物掉落控制"
+  title: '<#00FB9A><bold>生物掉落控制</bold></#00FB9A>'
   status:
-    enabled: "&a开启"
-    disabled: "&c关闭"
+    enabled: '<#00FB9A>开启</#00FB9A>'
+    disabled: '<#FF7E5E>关闭</#FF7E5E>'
   enderman:
-    name: "&d末影人掉落"
-    status: "&7当前状态：{status}"
-    toggle: "&e点击切换"
+    name: '<#00FB9A>末影人掉落</#00FB9A>'
+    status: '<gray>当前状态: {status}</gray>'
+    toggle: '<gray>点击切换</gray>'
 
 maintenance:
   status:
-    enabled: "&c开启"
-    disabled: "&a关闭"
+    enabled: '<#FF7E5E>开启</#FF7E5E>'
+    disabled: '<#00FB9A>关闭</#00FB9A>'
   messages:
-    enabled: "&a维护模式已开启。"
-    disabled: "&c维护模式已关闭。"
-    reloaded: "&a维护模式配置已重载。"
-    status: "&7维护模式当前状态：{status}"
-    usage: "&c用法：/maintenance <on|off|status|reload>"
+    enabled: '<#00FB9A>维护模式已开启.</#00FB9A>'
+    disabled: '<#FF7E5E>维护模式已关闭.</#FF7E5E>'
+    reloaded: '<#00FB9A>维护模式配置已重载.</#00FB9A>'
+    status: '<gray>维护模式当前状态: {status} | 白名单: <white>{whitelist_count}</white></gray>'
+    usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /maintenance [on|off|status|reload|add|remove|list]</#FF7E5E>'
+    add-usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /maintenance add [玩家|UUID]</#FF7E5E>'
+    remove-usage: '<#FF3300>错误:</#FF3300> <#FF7E5E>用法: /maintenance remove [玩家|UUID]</#FF7E5E>'
+    whitelist-added: '<#00FB9A>已将 {player} 加入维护白名单.</#00FB9A>'
+    whitelist-removed: '<#00FB9A>已将 {player} 移出维护白名单.</#00FB9A>'
+    whitelist-exists: '<#FFC43B>{player} 已在维护白名单中.</#FFC43B>'
+    whitelist-missing: '<#FF3300>错误:</#FF3300> <#FF7E5E>{player} 不在维护白名单中.</#FF7E5E>'
+    whitelist-empty: '<gray>维护白名单为空.</gray>'
+    whitelist-list: '<gray>维护白名单 ({count}): <white>{entries}</white></gray>'
+    login-blocked: '<#FFC43B>{player} 被维护模式拦截.</#FFC43B> <gray>UUID: {uuid} | IP: {address}</gray>'

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

@@ -1,9 +1,10 @@
 # EssentialsC 模块配置
 #
 # modules.yml 用于控制功能模块是否在运行时加载。
-# config.yml 仍然用于控制已启用模块内部的具体行为。
+# 各功能的详细设置位于 config.yml 及对应的独立功能配置文件。
 #
-# 将模块设置为 false 后，建议重启服务器，以完全注销对应命令和监听器。
+# 修改模块开关后可使用 /essc reload 刷新运行期服务和监听器。
+# 直连命令的完整热增删仍建议通过重启服务器完成。
 
 config-version: 1
 
@@ -12,7 +13,7 @@ modules:
     # 工作台、铁砧等便捷方块命令、/essc blocks 菜单和潜影盒快捷打开。
     enabled: true
   player:
-    # 玩家常用命令：飞行、夜视、发光、治疗、喂食、修复、帽子、自杀、隐身和查询玩家。
+    # 玩家常用命令：飞行、夜视、发光、治疗、喂食、修复、帽子、自杀、隐身、查询玩家和 TPA。
     enabled: true
   admin-mode:
     # /essc admin 管理模式，以及独立背包和状态管理。
@@ -29,3 +30,6 @@ modules:
   maintenance:
     # 维护模式。开启维护后可替换 MOTD，并阻止无绕过权限的玩家进入。
     enabled: true
+  skin-bridge:
+    # 查询外置 Yggdrasil profile，并通过 MineSkin 与 Paper Profile API 同步皮肤。
+    enabled: false

src/main/resources/paper-plugin.yml

@@ -77,6 +77,30 @@ permissions:
   essentialsc.command.repair.all:
     description: 允许使用 /repair all
     default: op
+  essentialsc.command.tpa:
+    description: 允许发送 /tpa 请求
+    default: true
+  essentialsc.command.tpahere:
+    description: 允许发送 /tpahere 请求
+    default: true
+  essentialsc.command.tpaall:
+    description: 允许向所有玩家发送 /tpahere 请求
+    default: op
+  essentialsc.command.tpaccept:
+    description: 允许接受 TPA 请求
+    default: true
+  essentialsc.command.tpdeny:
+    description: 允许拒绝 TPA 请求
+    default: true
+  essentialsc.command.tpignore:
+    description: 允许切换是否忽略 TPA 请求
+    default: true
+  essentialsc.tpa.bypass-warmup:
+    description: 允许绕过 TPA 传送预热
+    default: op
+  essentialsc.tpa.bypass-cooldown:
+    description: 允许绕过 TPA 冷却
+    default: op
   essentialsc.command.admin:
     description: 允许使用 /essc admin
     default: op
@@ -95,9 +119,15 @@ permissions:
   essentialsc.command.maintenance:
     description: 允许管理维护模式
     default: op
+  essentialsc.command.skin:
+    description: 允许管理 SkinBridge 状态与刷新
+    default: op
   essentialsc.maintenance.bypass:
     description: 允许在维护模式下进入服务器
     default: op
+  essentialsc.maintenance.notify:
+    description: 允许接收维护模式拦截通知
+    default: op
   essentialsc.shulkerbox.open:
     description: 允许通过 Shift+右键快捷打开潜影盒
     default: op
@@ -130,12 +160,22 @@ permissions:
       essentialsc.command.feed.others: true
       essentialsc.command.repair: true
       essentialsc.command.repair.all: true
+      essentialsc.command.tpa: true
+      essentialsc.command.tpahere: true
+      essentialsc.command.tpaall: true
+      essentialsc.command.tpaccept: true
+      essentialsc.command.tpdeny: true
+      essentialsc.command.tpignore: true
+      essentialsc.tpa.bypass-warmup: true
+      essentialsc.tpa.bypass-cooldown: true
       essentialsc.command.admin: true
       essentialsc.command.help: true
       essentialsc.command.reload: true
       essentialsc.command.tpsbar: true
       essentialsc.command.tpsbar.others: true
       essentialsc.command.maintenance: true
+      essentialsc.command.skin: true
       essentialsc.maintenance.bypass: true
+      essentialsc.maintenance.notify: true
       essentialsc.shulkerbox.open: true
       essentialsc.mobdrops.enderman: true

src/main/resources/skin-bridge.yml

@@ -0,0 +1,64 @@
+# ============================================================================
+# EssentialsC - SkinBridge 配置
+# ============================================================================
+# 模块总开关位于 modules.yml：modules.skin-bridge.enabled
+# 本文件控制 SkinBridge 内部行为。修改后使用 /essc reload 重载。
+
+config-version: 1
+
+# ----------------------------------------------------------------------------
+# 基础设置
+# ----------------------------------------------------------------------------
+
+# 是否启用外置皮肤站检测与皮肤同步。
+enabled: false
+
+# 是否在玩家加入时发送检测与同步结果提示。
+send-player-message: true
+
+# 玩家加入后延迟多少 tick 开始检测，避免登录资料尚未稳定。
+join-delay-ticks: 20
+
+# 玩家登录来源与生成皮肤的内存缓存时间，单位为分钟。
+cache-minutes: 120
+
+# 查询皮肤站 Yggdrasil Profile 的超时时间，单位为秒。
+profile-request-timeout-seconds: 5
+
+# ----------------------------------------------------------------------------
+# MineSkin v2
+# ----------------------------------------------------------------------------
+
+mineskin:
+  # API 地址，一般不需要修改。
+  endpoint: "https://api.mineskin.org"
+
+  # MineSkin API Key。只应填写在服务器运行目录，禁止提交到公开仓库。
+  api-key: ""
+
+  # 生成结果可见性：public / unlisted / private
+  visibility: "unlisted"
+
+  # 等待 MineSkin 队列完成的最长时间，单位为秒。
+  request-timeout-seconds: 30
+
+# ----------------------------------------------------------------------------
+# 外置皮肤站 Provider
+# ----------------------------------------------------------------------------
+# 每个一级子节点代表一个皮肤站，节点名称可自由修改，并显示在日志与
+# /essc skin status 中。建议只使用小写英文、数字和连字符，不要使用点号。
+#
+# 可用占位符：
+#   {uuid}        无连字符 UUID
+#   {uuid-dashed} 标准带连字符 UUID
+
+providers:
+  littleskin:
+    enabled: false
+    priority: 10
+    profile-url: "https://littleskin.cn/api/yggdrasil/sessionserver/session/minecraft/profile/{uuid}?unsigned=false"
+
+  my-blessing-skin:
+    enabled: false
+    priority: 20
+    profile-url: "https://skin.example.com/api/yggdrasil/sessionserver/session/minecraft/profile/{uuid}?unsigned=false"

versions/v1_21_11/build.gradle

@@ -0,0 +1,27 @@
+plugins {
+    id 'java-library'
+    id 'io.papermc.paperweight.userdev'
+}
+
+repositories {
+    mavenCentral()
+    maven {
+        name = 'papermc'
+        url = uri('https://repo.papermc.io/repository/maven-public/')
+    }
+}
+
+dependencies {
+    api project(':compat-api')
+    paperweight.paperDevBundle('1.21.11-R0.1-SNAPSHOT')
+}
+
+java {
+    toolchain.languageVersion.set(JavaLanguageVersion.of(21))
+}
+
+paperweight.reobfArtifactConfiguration = io.papermc.paperweight.userdev.ReobfArtifactConfiguration.getMOJANG_PRODUCTION()
+
+tasks.withType(JavaCompile).configureEach {
+    options.encoding = 'UTF-8'
+}

versions/v1_21_11/src/main/java/cn/infstar/essentialsC/v1_21_11/jei/JeiRecipeSyncAdapterImpl.java

@@ -0,0 +1,239 @@
+package cn.infstar.essentialsC.v1_21_11.jei;
+
+import cn.infstar.essentialsC.compat.jei.JeiRecipeSyncAdapter;
+import io.netty.buffer.Unpooled;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.protocol.common.ClientboundCustomPayloadPacket;
+import net.minecraft.network.protocol.common.custom.DiscardedPayload;
+import net.minecraft.resources.Identifier;
+import net.minecraft.server.MinecraftServer;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.world.item.crafting.RecipeHolder;
+import net.minecraft.world.item.crafting.RecipeMap;
+import net.minecraft.world.item.crafting.RecipeSerializer;
+import org.bukkit.craftbukkit.entity.CraftPlayer;
+import org.bukkit.entity.Player;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.logging.Logger;
+
+public final class JeiRecipeSyncAdapterImpl implements JeiRecipeSyncAdapter {
+
+    @Override
+    @SuppressWarnings({"unchecked", "deprecation"})
+    public void sendFabricRecipeSync(Player player, Logger logger, boolean debug) {
+        ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
+        MinecraftServer server = serverPlayer.level().getServer();
+        if (server == null) {
+            if (debug) {
+                logger.warning("服务端实例为 null");
+            }
+            return;
+        }
+
+        RecipeMap recipeMap = server.getRecipeManager().recipes;
+        if (debug) {
+            logger.info("开始构建 Fabric 配方数据");
+        }
+
+        var list = new ArrayList<FabricRecipeEntry>();
+        var seen = new HashSet<RecipeSerializer<?>>();
+
+        for (RecipeSerializer<?> serializer : BuiltInRegistries.RECIPE_SERIALIZER) {
+            if (!seen.add(serializer)) {
+                continue;
+            }
+
+            List<RecipeHolder<?>> recipes = new ArrayList<>();
+            for (RecipeHolder<?> holder : recipeMap.values()) {
+                if (holder.value().getSerializer() == serializer) {
+                    recipes.add(holder);
+                }
+            }
+
+            if (!recipes.isEmpty()) {
+                RecipeSerializer<?> entrySerializer = recipes.get(0).value().getSerializer();
+                list.add(new FabricRecipeEntry(entrySerializer, recipes));
+            }
+        }
+
+        var payload = new FabricRecipeSyncPayload(list);
+        if (debug) {
+            logger.info("Fabric 配方条目数: " + list.size());
+        }
+
+        RegistryFriendlyByteBuf buffer = new RegistryFriendlyByteBuf(Unpooled.buffer(), server.registryAccess());
+        getFabricCodec().encode(buffer, payload);
+
+        byte[] bytes = new byte[buffer.writerIndex()];
+        buffer.getBytes(0, bytes);
+
+        Identifier id = Identifier.fromNamespaceAndPath("fabric", "recipe_sync");
+        DiscardedPayload discardedPayload = new DiscardedPayload(id, bytes);
+        serverPlayer.connection.send(new ClientboundCustomPayloadPacket(discardedPayload));
+
+        if (debug) {
+            logger.info("已发送 Fabric 配方同步 [" + id + "], 大小: " + bytes.length + " bytes");
+        }
+    }
+
+    @Override
+    @SuppressWarnings({"unchecked", "deprecation"})
+    public void sendNeoForgeRecipeSync(Player player, Logger logger, boolean debug) {
+        ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
+        MinecraftServer server = serverPlayer.level().getServer();
+        if (server == null) {
+            if (debug) {
+                logger.warning("服务端实例为 null");
+            }
+            return;
+        }
+
+        RecipeMap recipeMap = server.getRecipeManager().recipes;
+        if (debug) {
+            logger.info("开始构建 NeoForge 配方数据");
+        }
+
+        java.util.List<net.minecraft.world.item.crafting.RecipeType<?>> allRecipeTypes =
+            BuiltInRegistries.RECIPE_TYPE.stream().toList();
+        if (debug) {
+            logger.info("NeoForge 配方类型数: " + allRecipeTypes.size());
+        }
+
+        var payload = createNeoForgePayload(allRecipeTypes, recipeMap);
+        RegistryFriendlyByteBuf buffer = new RegistryFriendlyByteBuf(Unpooled.buffer(), server.registryAccess());
+        getNeoForgeStreamCodec().encode(buffer, payload);
+
+        byte[] bytes = new byte[buffer.writerIndex()];
+        buffer.getBytes(0, bytes);
+
+        Identifier id = Identifier.fromNamespaceAndPath("neoforge", "recipe_content");
+        DiscardedPayload discardedPayload = new DiscardedPayload(id, bytes);
+        serverPlayer.connection.send(new ClientboundCustomPayloadPacket(discardedPayload));
+        serverPlayer.connection.send(new net.minecraft.network.protocol.common.ClientboundUpdateTagsPacket(
+            net.minecraft.tags.TagNetworkSerialization.serializeTagsToNetwork(server.registries())
+        ));
+
+        if (debug) {
+            logger.info("已发送 NeoForge 配方同步 [" + id + "], 大小: " + bytes.length + " bytes");
+        }
+    }
+
+    @SuppressWarnings({"unchecked", "deprecation"})
+    private net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, FabricRecipeSyncPayload> getFabricCodec() {
+        return FabricRecipeEntry.CODEC.apply(net.minecraft.network.codec.ByteBufCodecs.list())
+            .map(FabricRecipeSyncPayload::new, FabricRecipeSyncPayload::entries);
+    }
+
+    private NeoForgeRecipeSyncPayload createNeoForgePayload(
+        java.util.List<net.minecraft.world.item.crafting.RecipeType<?>> recipeTypes,
+        RecipeMap recipeMap
+    ) {
+        var recipeTypeSet = new java.util.HashSet<>(recipeTypes);
+        if (recipeTypeSet.isEmpty()) {
+            return new NeoForgeRecipeSyncPayload(recipeTypeSet, java.util.List.of());
+        }
+
+        var recipeSubset = recipeMap.values().stream()
+            .filter(h -> recipeTypeSet.contains(h.value().getType()))
+            .toList();
+        return new NeoForgeRecipeSyncPayload(recipeTypeSet, recipeSubset);
+    }
+
+    @SuppressWarnings({"unchecked", "deprecation"})
+    private net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, NeoForgeRecipeSyncPayload> getNeoForgeStreamCodec() {
+        return net.minecraft.network.codec.StreamCodec.composite(
+            net.minecraft.network.codec.ByteBufCodecs.registry(net.minecraft.core.registries.Registries.RECIPE_TYPE)
+                .apply(net.minecraft.network.codec.ByteBufCodecs.collection(java.util.HashSet::new)),
+            NeoForgeRecipeSyncPayload::recipeTypes,
+            RecipeHolder.STREAM_CODEC.apply(net.minecraft.network.codec.ByteBufCodecs.list()),
+            NeoForgeRecipeSyncPayload::recipes,
+            NeoForgeRecipeSyncPayload::new
+        );
+    }
+
+    @SuppressWarnings("deprecation")
+    private static class FabricRecipeEntry {
+        final Object serializer;
+        final List<RecipeHolder<?>> recipes;
+
+        FabricRecipeEntry(Object serializer, List<RecipeHolder<?>> recipes) {
+            this.serializer = serializer;
+            this.recipes = recipes;
+        }
+
+        static final net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, FabricRecipeEntry> CODEC =
+            net.minecraft.network.codec.StreamCodec.ofMember(
+                FabricRecipeEntry::write,
+                FabricRecipeEntry::read
+            );
+
+        @SuppressWarnings("unchecked")
+        private static FabricRecipeEntry read(RegistryFriendlyByteBuf buf) {
+            Identifier recipeSerializerId = buf.readIdentifier();
+            RecipeSerializer<?> recipeSerializer = BuiltInRegistries.RECIPE_SERIALIZER.getValue(recipeSerializerId);
+
+            if (recipeSerializer == null) {
+                throw new RuntimeException("Tried syncing unsupported packet serializer '" + recipeSerializerId + "'!");
+            }
+
+            int count = buf.readVarInt();
+            var list = new ArrayList<RecipeHolder<?>>();
+            for (int i = 0; i < count; i++) {
+                net.minecraft.resources.ResourceKey<net.minecraft.world.item.crafting.Recipe<?>> id =
+                    buf.readResourceKey(net.minecraft.core.registries.Registries.RECIPE);
+
+                try {
+                    var streamCodecMethod = recipeSerializer.getClass().getMethod("streamCodec");
+                    var streamCodec = streamCodecMethod.invoke(recipeSerializer);
+                    net.minecraft.world.item.crafting.Recipe<?> recipe =
+                        ((net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, net.minecraft.world.item.crafting.Recipe<?>>) streamCodec)
+                            .decode(buf);
+                    list.add(new RecipeHolder<>(id, recipe));
+                } catch (Exception e) {
+                    throw new RuntimeException("Failed to decode recipe: " + e.getMessage(), e);
+                }
+            }
+
+            return new FabricRecipeEntry(recipeSerializer, list);
+        }
+
+        private void write(RegistryFriendlyByteBuf buf) {
+            try {
+                var getKeyMethod = BuiltInRegistries.RECIPE_SERIALIZER.getClass().getMethod("getKey", Object.class);
+                Identifier identifier = (Identifier) getKeyMethod.invoke(BuiltInRegistries.RECIPE_SERIALIZER, this.serializer);
+                buf.writeIdentifier(identifier);
+            } catch (Exception e) {
+                throw new RuntimeException("Failed to get serializer key: " + e.getMessage(), e);
+            }
+
+            buf.writeVarInt(this.recipes.size());
+
+            try {
+                var streamCodecMethod = this.serializer.getClass().getMethod("streamCodec");
+                @SuppressWarnings("unchecked")
+                var codec = (net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, net.minecraft.world.item.crafting.Recipe<?>>)
+                    streamCodecMethod.invoke(this.serializer);
+
+                for (RecipeHolder<?> recipe : this.recipes) {
+                    buf.writeResourceKey(recipe.id());
+                    codec.encode(buf, recipe.value());
+                }
+            } catch (Exception e) {
+                throw new RuntimeException("Failed to encode recipe: " + e.getMessage(), e);
+            }
+        }
+    }
+
+    private record FabricRecipeSyncPayload(List<FabricRecipeEntry> entries) {
+    }
+
+    private record NeoForgeRecipeSyncPayload(
+        java.util.Set<net.minecraft.world.item.crafting.RecipeType<?>> recipeTypes,
+        java.util.List<RecipeHolder<?>> recipes
+    ) {
+    }
+}

versions/v26_1_2/build.gradle

@@ -0,0 +1,27 @@
+plugins {
+    id 'java-library'
+    id 'io.papermc.paperweight.userdev'
+}
+
+repositories {
+    mavenCentral()
+    maven {
+        name = 'papermc'
+        url = uri('https://repo.papermc.io/repository/maven-public/')
+    }
+}
+
+dependencies {
+    api project(':compat-api')
+    paperweight.paperDevBundle('26.1.2.build.72-stable')
+}
+
+java {
+    toolchain.languageVersion.set(JavaLanguageVersion.of(25))
+}
+
+paperweight.reobfArtifactConfiguration = io.papermc.paperweight.userdev.ReobfArtifactConfiguration.getMOJANG_PRODUCTION()
+
+tasks.withType(JavaCompile).configureEach {
+    options.encoding = 'UTF-8'
+}

versions/v26_1_2/src/main/java/cn/infstar/essentialsC/v26_1_2/jei/JeiRecipeSyncAdapterImpl.java

@@ -0,0 +1,240 @@
+package cn.infstar.essentialsC.v26_1_2.jei;
+
+import cn.infstar.essentialsC.compat.jei.JeiRecipeSyncAdapter;
+import io.netty.buffer.Unpooled;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.protocol.common.ClientboundCustomPayloadPacket;
+import net.minecraft.network.protocol.common.custom.DiscardedPayload;
+import net.minecraft.resources.Identifier;
+import net.minecraft.server.MinecraftServer;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.world.item.crafting.RecipeHolder;
+import net.minecraft.world.item.crafting.RecipeMap;
+import net.minecraft.world.item.crafting.RecipeSerializer;
+import org.bukkit.craftbukkit.entity.CraftPlayer;
+import org.bukkit.entity.Player;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.logging.Logger;
+
+public final class JeiRecipeSyncAdapterImpl implements JeiRecipeSyncAdapter {
+
+    @Override
+    @SuppressWarnings({"unchecked", "deprecation"})
+    public void sendFabricRecipeSync(Player player, Logger logger, boolean debug) {
+        ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
+        MinecraftServer server = serverPlayer.level().getServer();
+        if (server == null) {
+            if (debug) {
+                logger.warning("服务端实例为 null");
+            }
+            return;
+        }
+
+        RecipeMap recipeMap = server.getRecipeManager().recipes;
+        if (debug) {
+            logger.info("开始构建 Fabric 配方数据");
+        }
+
+        var list = new ArrayList<FabricRecipeEntry>();
+        var seen = new HashSet<RecipeSerializer<?>>();
+
+        for (RecipeSerializer<?> serializer : BuiltInRegistries.RECIPE_SERIALIZER) {
+            if (!seen.add(serializer)) {
+                continue;
+            }
+
+            List<RecipeHolder<?>> recipes = new ArrayList<>();
+            for (RecipeHolder<?> holder : recipeMap.values()) {
+                if (holder.value().getSerializer() == serializer) {
+                    recipes.add(holder);
+                }
+            }
+
+            if (!recipes.isEmpty()) {
+                RecipeSerializer<?> entrySerializer = recipes.get(0).value().getSerializer();
+                list.add(new FabricRecipeEntry(entrySerializer, recipes));
+            }
+        }
+
+        var payload = new FabricRecipeSyncPayload(list);
+        if (debug) {
+            logger.info("Fabric 配方条目数: " + list.size());
+        }
+
+        RegistryFriendlyByteBuf buffer = new RegistryFriendlyByteBuf(Unpooled.buffer(), server.registryAccess());
+        getFabricCodec().encode(buffer, payload);
+
+        byte[] bytes = new byte[buffer.writerIndex()];
+        buffer.getBytes(0, bytes);
+
+        Identifier id = Identifier.fromNamespaceAndPath("fabric", "recipe_sync");
+        DiscardedPayload discardedPayload = new DiscardedPayload(id, bytes);
+        serverPlayer.connection.send(new ClientboundCustomPayloadPacket(discardedPayload));
+
+        if (debug) {
+            logger.info("已发送 Fabric 配方同步 [" + id + "], 大小: " + bytes.length + " bytes");
+        }
+    }
+
+    @Override
+    @SuppressWarnings({"unchecked", "deprecation"})
+    public void sendNeoForgeRecipeSync(Player player, Logger logger, boolean debug) {
+        ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
+        MinecraftServer server = serverPlayer.level().getServer();
+        if (server == null) {
+            if (debug) {
+                logger.warning("服务端实例为 null");
+            }
+            return;
+        }
+
+        RecipeMap recipeMap = server.getRecipeManager().recipes;
+        if (debug) {
+            logger.info("开始构建 NeoForge 配方数据");
+        }
+
+        java.util.List<net.minecraft.world.item.crafting.RecipeType<?>> allRecipeTypes =
+            BuiltInRegistries.RECIPE_TYPE.stream().toList();
+        if (debug) {
+            logger.info("NeoForge 配方类型数: " + allRecipeTypes.size());
+        }
+
+        var payload = createNeoForgePayload(allRecipeTypes, recipeMap);
+        RegistryFriendlyByteBuf buffer = new RegistryFriendlyByteBuf(Unpooled.buffer(), server.registryAccess());
+        getNeoForgeStreamCodec().encode(buffer, payload);
+
+        byte[] bytes = new byte[buffer.writerIndex()];
+        buffer.getBytes(0, bytes);
+
+        Identifier id = Identifier.fromNamespaceAndPath("neoforge", "recipe_content");
+        DiscardedPayload discardedPayload = new DiscardedPayload(id, bytes);
+        serverPlayer.connection.send(new ClientboundCustomPayloadPacket(discardedPayload));
+        serverPlayer.connection.send(new net.minecraft.network.protocol.common.ClientboundUpdateTagsPacket(
+            net.minecraft.tags.TagNetworkSerialization.serializeTagsToNetwork(server.registries())
+        ));
+
+        if (debug) {
+            logger.info("已发送 NeoForge 配方同步 [" + id + "], 大小: " + bytes.length + " bytes");
+        }
+    }
+
+    @SuppressWarnings({"unchecked", "deprecation"})
+    private net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, FabricRecipeSyncPayload> getFabricCodec() {
+        return FabricRecipeEntry.CODEC.apply(net.minecraft.network.codec.ByteBufCodecs.list())
+            .map(FabricRecipeSyncPayload::new, FabricRecipeSyncPayload::entries);
+    }
+
+    private NeoForgeRecipeSyncPayload createNeoForgePayload(
+        java.util.List<net.minecraft.world.item.crafting.RecipeType<?>> recipeTypes,
+        RecipeMap recipeMap
+    ) {
+        var recipeTypeSet = new java.util.HashSet<>(recipeTypes);
+        if (recipeTypeSet.isEmpty()) {
+            return new NeoForgeRecipeSyncPayload(recipeTypeSet, java.util.List.of());
+        }
+
+        var recipeSubset = recipeMap.values().stream()
+            .filter(h -> recipeTypeSet.contains(h.value().getType()))
+            .toList();
+        return new NeoForgeRecipeSyncPayload(recipeTypeSet, recipeSubset);
+    }
+
+    @SuppressWarnings({"unchecked", "deprecation"})
+    private net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, NeoForgeRecipeSyncPayload> getNeoForgeStreamCodec() {
+        return net.minecraft.network.codec.StreamCodec.composite(
+            net.minecraft.network.codec.ByteBufCodecs.registry(net.minecraft.core.registries.Registries.RECIPE_TYPE)
+                .apply(net.minecraft.network.codec.ByteBufCodecs.collection(java.util.HashSet::new)),
+            NeoForgeRecipeSyncPayload::recipeTypes,
+            RecipeHolder.STREAM_CODEC.apply(net.minecraft.network.codec.ByteBufCodecs.list()),
+            NeoForgeRecipeSyncPayload::recipes,
+            NeoForgeRecipeSyncPayload::new
+        );
+    }
+
+    @SuppressWarnings("deprecation")
+    private static class FabricRecipeEntry {
+        final Object serializer;
+        final List<RecipeHolder<?>> recipes;
+
+        FabricRecipeEntry(Object serializer, List<RecipeHolder<?>> recipes) {
+            this.serializer = serializer;
+            this.recipes = recipes;
+        }
+
+        static final net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, FabricRecipeEntry> CODEC =
+            net.minecraft.network.codec.StreamCodec.ofMember(
+                FabricRecipeEntry::write,
+                FabricRecipeEntry::read
+            );
+
+        @SuppressWarnings("unchecked")
+        private static FabricRecipeEntry read(RegistryFriendlyByteBuf buf) {
+            Identifier recipeSerializerId = buf.readIdentifier();
+            RecipeSerializer<?> recipeSerializer = BuiltInRegistries.RECIPE_SERIALIZER.getValue(recipeSerializerId);
+
+            if (recipeSerializer == null) {
+                throw new RuntimeException("Tried syncing unsupported packet serializer '" + recipeSerializerId + "'!");
+            }
+
+            int count = buf.readVarInt();
+            var list = new ArrayList<RecipeHolder<?>>();
+            for (int i = 0; i < count; i++) {
+                net.minecraft.resources.ResourceKey<net.minecraft.world.item.crafting.Recipe<?>> id =
+                    buf.readResourceKey(net.minecraft.core.registries.Registries.RECIPE);
+
+                try {
+                    var streamCodecMethod = recipeSerializer.getClass().getMethod("streamCodec");
+                    var streamCodec = streamCodecMethod.invoke(recipeSerializer);
+                    net.minecraft.world.item.crafting.Recipe<?> recipe =
+                        ((net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, net.minecraft.world.item.crafting.Recipe<?>>) streamCodec)
+                            .decode(buf);
+                    list.add(new RecipeHolder<>(id, recipe));
+                } catch (Exception e) {
+                    throw new RuntimeException("Failed to decode recipe: " + e.getMessage(), e);
+                }
+            }
+
+            return new FabricRecipeEntry(recipeSerializer, list);
+        }
+
+        private void write(RegistryFriendlyByteBuf buf) {
+            try {
+                var getKeyMethod = BuiltInRegistries.RECIPE_SERIALIZER.getClass().getMethod("getKey", Object.class);
+                Identifier identifier = (Identifier) getKeyMethod.invoke(BuiltInRegistries.RECIPE_SERIALIZER, this.serializer);
+                buf.writeIdentifier(identifier);
+            } catch (Exception e) {
+                throw new RuntimeException("Failed to get serializer key: " + e.getMessage(), e);
+            }
+
+            buf.writeVarInt(this.recipes.size());
+
+            try {
+                var streamCodecMethod = this.serializer.getClass().getMethod("streamCodec");
+                @SuppressWarnings("unchecked")
+                var codec = (net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, net.minecraft.world.item.crafting.Recipe<?>>)
+                    streamCodecMethod.invoke(this.serializer);
+
+                for (RecipeHolder<?> recipe : this.recipes) {
+                    buf.writeResourceKey(recipe.id());
+                    codec.encode(buf, recipe.value());
+                }
+            } catch (Exception e) {
+                throw new RuntimeException("Failed to encode recipe: " + e.getMessage(), e);
+            }
+        }
+    }
+
+    private record FabricRecipeSyncPayload(List<FabricRecipeEntry> entries) {
+    }
+
+    private record NeoForgeRecipeSyncPayload(
+        java.util.Set<net.minecraft.world.item.crafting.RecipeType<?>> recipeTypes,
+        java.util.List<RecipeHolder<?>> recipes
+    ) {
+    }
+}
+

versions/v26_2/build.gradle

@@ -0,0 +1,27 @@
+plugins {
+    id 'java-library'
+    id 'io.papermc.paperweight.userdev'
+}
+
+repositories {
+    mavenCentral()
+    maven {
+        name = 'papermc'
+        url = uri('https://repo.papermc.io/repository/maven-public/')
+    }
+}
+
+dependencies {
+    api project(':compat-api')
+    paperweight.paperDevBundle('26.2.build.31-alpha')
+}
+
+java {
+    toolchain.languageVersion.set(JavaLanguageVersion.of(25))
+}
+
+paperweight.reobfArtifactConfiguration = io.papermc.paperweight.userdev.ReobfArtifactConfiguration.getMOJANG_PRODUCTION()
+
+tasks.withType(JavaCompile).configureEach {
+    options.encoding = 'UTF-8'
+}

versions/v26_2/src/main/java/cn/infstar/essentialsC/v26_2/jei/JeiRecipeSyncAdapterImpl.java

@@ -0,0 +1,240 @@
+package cn.infstar.essentialsC.v26_2.jei;
+
+import cn.infstar.essentialsC.compat.jei.JeiRecipeSyncAdapter;
+import io.netty.buffer.Unpooled;
+import net.minecraft.core.registries.BuiltInRegistries;
+import net.minecraft.network.RegistryFriendlyByteBuf;
+import net.minecraft.network.protocol.common.ClientboundCustomPayloadPacket;
+import net.minecraft.network.protocol.common.custom.DiscardedPayload;
+import net.minecraft.resources.Identifier;
+import net.minecraft.server.MinecraftServer;
+import net.minecraft.server.level.ServerPlayer;
+import net.minecraft.world.item.crafting.RecipeHolder;
+import net.minecraft.world.item.crafting.RecipeMap;
+import net.minecraft.world.item.crafting.RecipeSerializer;
+import org.bukkit.craftbukkit.entity.CraftPlayer;
+import org.bukkit.entity.Player;
+
+import java.util.ArrayList;
+import java.util.HashSet;
+import java.util.List;
+import java.util.logging.Logger;
+
+public final class JeiRecipeSyncAdapterImpl implements JeiRecipeSyncAdapter {
+
+    @Override
+    @SuppressWarnings({"unchecked", "deprecation"})
+    public void sendFabricRecipeSync(Player player, Logger logger, boolean debug) {
+        ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
+        MinecraftServer server = serverPlayer.level().getServer();
+        if (server == null) {
+            if (debug) {
+                logger.warning("服务端实例为 null");
+            }
+            return;
+        }
+
+        RecipeMap recipeMap = server.getRecipeManager().recipes;
+        if (debug) {
+            logger.info("开始构建 Fabric 配方数据");
+        }
+
+        var list = new ArrayList<FabricRecipeEntry>();
+        var seen = new HashSet<RecipeSerializer<?>>();
+
+        for (RecipeSerializer<?> serializer : BuiltInRegistries.RECIPE_SERIALIZER) {
+            if (!seen.add(serializer)) {
+                continue;
+            }
+
+            List<RecipeHolder<?>> recipes = new ArrayList<>();
+            for (RecipeHolder<?> holder : recipeMap.values()) {
+                if (holder.value().getSerializer() == serializer) {
+                    recipes.add(holder);
+                }
+            }
+
+            if (!recipes.isEmpty()) {
+                RecipeSerializer<?> entrySerializer = recipes.get(0).value().getSerializer();
+                list.add(new FabricRecipeEntry(entrySerializer, recipes));
+            }
+        }
+
+        var payload = new FabricRecipeSyncPayload(list);
+        if (debug) {
+            logger.info("Fabric 配方条目数: " + list.size());
+        }
+
+        RegistryFriendlyByteBuf buffer = new RegistryFriendlyByteBuf(Unpooled.buffer(), server.registryAccess());
+        getFabricCodec().encode(buffer, payload);
+
+        byte[] bytes = new byte[buffer.writerIndex()];
+        buffer.getBytes(0, bytes);
+
+        Identifier id = Identifier.fromNamespaceAndPath("fabric", "recipe_sync");
+        DiscardedPayload discardedPayload = new DiscardedPayload(id, bytes);
+        serverPlayer.connection.send(new ClientboundCustomPayloadPacket(discardedPayload));
+
+        if (debug) {
+            logger.info("已发送 Fabric 配方同步 [" + id + "], 大小: " + bytes.length + " bytes");
+        }
+    }
+
+    @Override
+    @SuppressWarnings({"unchecked", "deprecation"})
+    public void sendNeoForgeRecipeSync(Player player, Logger logger, boolean debug) {
+        ServerPlayer serverPlayer = ((CraftPlayer) player).getHandle();
+        MinecraftServer server = serverPlayer.level().getServer();
+        if (server == null) {
+            if (debug) {
+                logger.warning("服务端实例为 null");
+            }
+            return;
+        }
+
+        RecipeMap recipeMap = server.getRecipeManager().recipes;
+        if (debug) {
+            logger.info("开始构建 NeoForge 配方数据");
+        }
+
+        java.util.List<net.minecraft.world.item.crafting.RecipeType<?>> allRecipeTypes =
+            BuiltInRegistries.RECIPE_TYPE.stream().toList();
+        if (debug) {
+            logger.info("NeoForge 配方类型数: " + allRecipeTypes.size());
+        }
+
+        var payload = createNeoForgePayload(allRecipeTypes, recipeMap);
+        RegistryFriendlyByteBuf buffer = new RegistryFriendlyByteBuf(Unpooled.buffer(), server.registryAccess());
+        getNeoForgeStreamCodec().encode(buffer, payload);
+
+        byte[] bytes = new byte[buffer.writerIndex()];
+        buffer.getBytes(0, bytes);
+
+        Identifier id = Identifier.fromNamespaceAndPath("neoforge", "recipe_content");
+        DiscardedPayload discardedPayload = new DiscardedPayload(id, bytes);
+        serverPlayer.connection.send(new ClientboundCustomPayloadPacket(discardedPayload));
+        serverPlayer.connection.send(new net.minecraft.network.protocol.common.ClientboundUpdateTagsPacket(
+            net.minecraft.tags.TagNetworkSerialization.serializeTagsToNetwork(server.registries())
+        ));
+
+        if (debug) {
+            logger.info("已发送 NeoForge 配方同步 [" + id + "], 大小: " + bytes.length + " bytes");
+        }
+    }
+
+    @SuppressWarnings({"unchecked", "deprecation"})
+    private net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, FabricRecipeSyncPayload> getFabricCodec() {
+        return FabricRecipeEntry.CODEC.apply(net.minecraft.network.codec.ByteBufCodecs.list())
+            .map(FabricRecipeSyncPayload::new, FabricRecipeSyncPayload::entries);
+    }
+
+    private NeoForgeRecipeSyncPayload createNeoForgePayload(
+        java.util.List<net.minecraft.world.item.crafting.RecipeType<?>> recipeTypes,
+        RecipeMap recipeMap
+    ) {
+        var recipeTypeSet = new java.util.HashSet<>(recipeTypes);
+        if (recipeTypeSet.isEmpty()) {
+            return new NeoForgeRecipeSyncPayload(recipeTypeSet, java.util.List.of());
+        }
+
+        var recipeSubset = recipeMap.values().stream()
+            .filter(h -> recipeTypeSet.contains(h.value().getType()))
+            .toList();
+        return new NeoForgeRecipeSyncPayload(recipeTypeSet, recipeSubset);
+    }
+
+    @SuppressWarnings({"unchecked", "deprecation"})
+    private net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, NeoForgeRecipeSyncPayload> getNeoForgeStreamCodec() {
+        return net.minecraft.network.codec.StreamCodec.composite(
+            net.minecraft.network.codec.ByteBufCodecs.registry(net.minecraft.core.registries.Registries.RECIPE_TYPE)
+                .apply(net.minecraft.network.codec.ByteBufCodecs.collection(java.util.HashSet::new)),
+            NeoForgeRecipeSyncPayload::recipeTypes,
+            RecipeHolder.STREAM_CODEC.apply(net.minecraft.network.codec.ByteBufCodecs.list()),
+            NeoForgeRecipeSyncPayload::recipes,
+            NeoForgeRecipeSyncPayload::new
+        );
+    }
+
+    @SuppressWarnings("deprecation")
+    private static class FabricRecipeEntry {
+        final Object serializer;
+        final List<RecipeHolder<?>> recipes;
+
+        FabricRecipeEntry(Object serializer, List<RecipeHolder<?>> recipes) {
+            this.serializer = serializer;
+            this.recipes = recipes;
+        }
+
+        static final net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, FabricRecipeEntry> CODEC =
+            net.minecraft.network.codec.StreamCodec.ofMember(
+                FabricRecipeEntry::write,
+                FabricRecipeEntry::read
+            );
+
+        @SuppressWarnings("unchecked")
+        private static FabricRecipeEntry read(RegistryFriendlyByteBuf buf) {
+            Identifier recipeSerializerId = buf.readIdentifier();
+            RecipeSerializer<?> recipeSerializer = BuiltInRegistries.RECIPE_SERIALIZER.getValue(recipeSerializerId);
+
+            if (recipeSerializer == null) {
+                throw new RuntimeException("Tried syncing unsupported packet serializer '" + recipeSerializerId + "'!");
+            }
+
+            int count = buf.readVarInt();
+            var list = new ArrayList<RecipeHolder<?>>();
+            for (int i = 0; i < count; i++) {
+                net.minecraft.resources.ResourceKey<net.minecraft.world.item.crafting.Recipe<?>> id =
+                    buf.readResourceKey(net.minecraft.core.registries.Registries.RECIPE);
+
+                try {
+                    var streamCodecMethod = recipeSerializer.getClass().getMethod("streamCodec");
+                    var streamCodec = streamCodecMethod.invoke(recipeSerializer);
+                    net.minecraft.world.item.crafting.Recipe<?> recipe =
+                        ((net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, net.minecraft.world.item.crafting.Recipe<?>>) streamCodec)
+                            .decode(buf);
+                    list.add(new RecipeHolder<>(id, recipe));
+                } catch (Exception e) {
+                    throw new RuntimeException("Failed to decode recipe: " + e.getMessage(), e);
+                }
+            }
+
+            return new FabricRecipeEntry(recipeSerializer, list);
+        }
+
+        private void write(RegistryFriendlyByteBuf buf) {
+            try {
+                var getKeyMethod = BuiltInRegistries.RECIPE_SERIALIZER.getClass().getMethod("getKey", Object.class);
+                Identifier identifier = (Identifier) getKeyMethod.invoke(BuiltInRegistries.RECIPE_SERIALIZER, this.serializer);
+                buf.writeIdentifier(identifier);
+            } catch (Exception e) {
+                throw new RuntimeException("Failed to get serializer key: " + e.getMessage(), e);
+            }
+
+            buf.writeVarInt(this.recipes.size());
+
+            try {
+                var streamCodecMethod = this.serializer.getClass().getMethod("streamCodec");
+                @SuppressWarnings("unchecked")
+                var codec = (net.minecraft.network.codec.StreamCodec<RegistryFriendlyByteBuf, net.minecraft.world.item.crafting.Recipe<?>>)
+                    streamCodecMethod.invoke(this.serializer);
+
+                for (RecipeHolder<?> recipe : this.recipes) {
+                    buf.writeResourceKey(recipe.id());
+                    codec.encode(buf, recipe.value());
+                }
+            } catch (Exception e) {
+                throw new RuntimeException("Failed to encode recipe: " + e.getMessage(), e);
+            }
+        }
+    }
+
+    private record FabricRecipeSyncPayload(List<FabricRecipeEntry> entries) {
+    }
+
+    private record NeoForgeRecipeSyncPayload(
+        java.util.Set<net.minecraft.world.item.crafting.RecipeType<?>> recipeTypes,
+        java.util.List<RecipeHolder<?>> recipes
+    ) {
+    }
+}
+