联动

依赖关系

物品库为可选功能，鱼类/宝藏/饵料/鱼竿的 item.source 按需依赖对应插件：

EventBus 事件

Fishing 模块通过 publishedTopics() 声明并发布以下 EventBus 事件主题，其他模块（如 BattlePass、QuestGPS、OnlineRewards 等）可通过 EventBusCapability 订阅：

EventPacket Signal

Fishing 同时通过 SignalDispatchable 分发信号，供 EventPacket 规则引擎匹配：

Capability 注册

Fishing 模块注册了以下 Capability，供宿主或其他模块调用：

FishingAccess

面向外部插件的钓鱼操作接口（所有方法请在 Bukkit 主线程调用）：

DatabaseMigratable

// 其他模块可通过 getCapability 查找
DatabaseMigratable migratable = getCapability(DatabaseMigratable.class);
if (migratable != null) {
    MigrationResult result = migratable.migrateDatabase(targetDescriptor, false);
}

PlayerDataPurgeable

PlayerDataPurgeable purgeable = getCapability(PlayerDataPurgeable.class);
if (purgeable != null) {
    int deleted = purgeable.purgePlayerData(playerUuid);
}

跨服同步

Fishing 支持跨服同步捕获记录。启用方式：

1. 宿主 config.yml 的 cross-server 节配置 Redis 或 Proxy 后端
2. 模块 config.yml 的 cross-server.enabled 设为 true

启用后，钓鱼成功时通过跨服通道发布消息，格式为：

CATCH:<uuid>:<fishId>:<fishName>:<rarity>:<size>:<perfect>:<timestamp>

其他服务器收到消息后持久化到本地数据库，清除该玩家的内存缓存。

数据库表结构

Fishing 模块使用以下数据库表（表名前缀默认为 axs_fishing_，共享模式下无前缀）：

axs_fishing_season（赛季数据）

主键：(uuid, season_id)。赛季数据按 season_id 隔离，赛季结束时重置。

axs_fishing_permanent（永久数据）

永久数据跨赛季保留，不随赛季重置。

axs_fishing_collection（图鉴条目）

主键：(uuid, fish_id)。图鉴数据跨赛季保留。

axs_fishing_bait_queue（饵料队列）

axs_fishing_catch_records（捕获记录）

用于主界面最近捕获记录流展示和跨服同步。

axs_fishing_pending_rewards（旧版待发放奖励）

新版本已迁移到宿主统一 PendingRewardService。模块启动时会自动迁移旧表数据。

与其他模块联动

Fishing 通过 getCapability 获取其他模块的能力实现联动：

里程碑称号

称号授予依赖 TitleGrantable 能力，需 Title 模块已加载。同时首次捕获传说鱼会发送邮件预设 legendary_first_catch（依赖 MailDispatchable）。

物品发放链

钓鱼获得的鱼物品、宝藏、额外掉落通过 RewardDispatcher → ItemRewardDispatcher 统一发放，支持背包满 → 仓库 → 邮件 → Pending → 掉落兜底链。

跨模块物品识别

钓鱼产物物品通过 PDC 标签标记，可供其他模块识别：