public class ArcartXSuitePlugin extends JavaPlugin {
    static {
        // 最早时机注入保护层，确保加密类加载前 hook 已就位
        ProtectionInit.initialize(ArcartXSuitePlugin.class);
    }
 
    private SuiteCore core;
 
    @Override
    public void onEnable() {
        // 反射加载加密业务核心
        Class<?> implClass = Class.forName(
            "xuanmo.arcartxsuite.SuiteCoreImpl", true, getClassLoader());
        SuiteCore loaded = (SuiteCore) implClass.getDeclaredConstructor().newInstance();
        // 契约版本校验
        if (loaded.apiVersion() != SuiteCore.HOST_API_VERSION) {
            getLogger().severe("Suite-core 契约版本不兼容，已禁用插件。");
            getServer().getPluginManager().disablePlugin(this);
            return;
        }
        this.core = loaded;
        core.onEnable(this);
    }
}

flowchart TD
    A["ArcartXSuitePlugin.onEnable()"] --> B["反射加载 SuiteCoreImpl"]
    B --> C["SuiteCoreImpl.onEnable(host)"]
    C --> D0["初始化配置诊断引擎<br/>ConfigDiagnosticEngine"]
    C --> D1["初始化 ClientPacketGuard"]
    C --> D2["BridgeLifecycleManager.initialize()<br/>创建并初始化所有桥接"]
    C --> D3["KeybindService.initialize()<br/>注册全局按键"]
    C --> D4["CrossServerService.start()<br/>启动跨服通道"]
    C --> D5["ClientEventLifecycleManager.start()<br/>监听客户端事件"]
    C --> D6["PlaceholderResolverImpl 初始化"]
    C --> D7["StorageManagerImpl 初始化<br/>统一数据源"]
    C --> D8["SchedulerServiceImpl 初始化<br/>统一调度"]
    C --> D9["ModuleRegistry 构造<br/>接收桥接 API 接口"]
    D9 --> E["注册 Core Capability<br/>（二级密码/选区/邮件降级）"]
    E --> F["moduleRegistry.loadAll()<br/>拓扑排序加载模块"]
    F --> G["ChatSignBypassService<br/>聊天签名绕过"]
    G --> H["CloudModuleService.syncModules()<br/>云端模块异步同步"]
    H --> I["注册主命令 /arcartxsuite"]
    I --> J["全量配置诊断"]
    J --> K["异步版本检查"]
    K --> L["authlib-injector<br/>（按需启用）"]

public final class BridgeLifecycleManager {
    private final ArcartXPacketBridge packetBridge;      // UI 注册/发包
    private final ArcartXClientBridge clientBridge;     // 客户端桥接
    private final ArcartXItemStackBridge itemStackBridge;// 物品桥接
    private final ArcartXPropBridge propBridge;          // 按键/道具桥接
    private final ArcartXWorldTextureService worldTextureBridge; // 世界贴图
    private TaczCombatBridge taczCombatBridge;           // TACZ 战斗（可选）
 
    public boolean initialize(boolean taczEnabled, boolean taczDebug) {
        if (!packetBridge.initialize()) return false;  // packetBridge 失败则中止
        clientBridge.initialize();
        itemStackBridge.initialize();
        propBridge.initialize();
        worldTextureBridge.initialize();
        taczCombatBridge = TaczCombatBridge.tryInitialize(plugin, taczEnabled, taczDebug);
        return true;
    }
}

public final class ClientEventLifecycleManager implements Listener {
    @EventHandler(priority = EventPriority.MONITOR)
    public void onClientCustomPacket(ClientCustomPacketEvent event) {
        // 路由到 ModuleRegistry.routeClientPacket()
        registry.routeClientPacket(player, packetId, data);
    }
 
    @EventHandler(priority = EventPriority.MONITOR)
    public void onClientInitialized(ClientInitializedEvent.End event) {
        // 路由到 ModuleRegistry.routeClientInitialized()
        registry.routeClientInitialized(player);
    }
}

plugins/ArcartX-Suite/
├── config.yml                  宿主主配置（模块开关、货币、跨服、安全）
├── data/
│   └── <moduleId>/
│       ├── config.yml          模块配置
│       └── messages.yml        模块消息文件
├── ui/                         ArcartX UI 文件（所有模块共享）
├── modules/                    模块 jar 存放目录
├── diagnosis/                  配置诊断报告
├── backup/                     配置备份
└── secondary-password.db       二级密码 SQLite