桥接层 (Bridge)

AXS 在 plugin.yml 里只硬依赖 ArcartX，其他全是软依赖。软依赖意味着插件可能不存在，直接 import 会让 AXS 启动失败。所以内部使用反射桥接：

• 启动时 Class.forName(...) 试探，失败即 bridge.ready = false
• 调用时通过 MethodHandle / Method.invoke 远程调对方 API

开发者 API

1.1.0 起，模块开发者无需关心反射细节，直接使用 类型安全的桥接 API 即可。

公开桥接 API

模块通过 ModuleContext 获取以下类型安全的桥接接口（详见 API 参考）：

接口	获取方式	功能
PacketBridgeAPI	context.packetBridge()	UI 注册/打开/关闭/发包/聊天卡片
ClientBridgeAPI	context.clientBridge()	伤害飘字/服务端变量/可见玩家遍历
ItemBridgeAPI	context.itemStackBridge()	ItemStack → JSON 序列化

内部反射桥列表

类	目标插件	用途
ArcartXPacketBridge	ArcartX	UI 注册、open/close/sendPacket、聊天卡片
ArcartXClientBridge	ArcartX	sendDamageDisplay、sendServerVariable
ArcartXItemStackBridge	ArcartX	物品序列化（Mail / Warehouse）
ArcartXKeyBindBridge	ArcartX	KeyBind 注册（Map / Conversation / Prop）
ArcartXPropBridge	ArcartX	道具效果绑定（Prop 独占，@Internal，模块开发者不应直接使用）
ArcartXWaypointBridge	ArcartX	路径点（Map / QuestGPS）
AdyeshachNpcBridge	Adyeshach	附近 NPC（Conversation）

货币桥接已统一：1.1.0-beta 起，所有经济相关读写统一通过全局 CurrencyBridgeAPI（context.currencyManager()）完成，支持 Vault / PlayerPoints / Rondo / Command / PlaceholderCommand / Custom 多 provider。VaultEconomyBridge 已从内部反射桥列表中移除，模块不再直接依赖 Vault 桥。详见 桥接 API → 货币。

使用示例

PacketBridgeAPI bridge = context.packetBridge();
if (bridge != null && bridge.isAvailable()) {
    bridge.registerOrReloadUi("my_ui", uiFile);
    bridge.openUi(player, "my_ui");
    bridge.sendPacket(player, "my_ui", "update", payload);
    bridge.closeUi(player, "my_ui");
}

桥失败时的降级策略

每个 Service 在 enable() 阶段调 bridge.isAvailable()，失败则标 bridge missing，不阻止其他模块启动。