[LIB] ArmorEquipEvent - 盔甲装备事件库

简介

这是一个简单的 Bukkit 插件，用于在玩家装备和卸下盔甲时触发一个自定义事件。开发者可以将其作为依赖库集成到自己的插件中，或者直接使用其核心事件类。

💡功能与说明

• 插件核心事件为 ArmorEquipEvent。
• 不支持生物（Mobs）的盔甲装备与卸下事件。
• 未在 Cauldron 服务端上进行测试，且暂无支持计划。
• 暂无支持 Sponge API 的计划。

🎮使用方法

作为依赖集成

你可以通过以下两种方式之一使用此插件

• 在你的 plugin.yml 中将此插件声明为依赖，并将其添加到服务器的 plugins 文件夹中。
• 直接从 GitHub 页面获取所需的方法和事件类，并将其整合到你自己的插件代码中（请确保正确注册事件）。

GitHub 项目地址：这里。

在代码中检测事件

检测装备盔甲

要检测玩家是否装备了一件盔甲，可以使用以下代码

if (e.getNewArmorPiece() != null && e.getNewArmorPiece().getType() != Material.AIR) {
    // 处理装备逻辑
}

检测卸下盔甲

要检测玩家是否卸下了一件盔甲，可以对上述代码稍作修改：

if (e.getOldArmorPiece() != null && e.getOldArmorPiece().getType() != Material.AIR) {
    // 处理卸下逻辑
}

注意：物品栏中的 ItemStack 可能为 null 或 Material.AIR 类型，因此在检查时两者都需要考虑。

获取装备方式

你可以通过 event.getMethod() 来获取玩家装备盔甲的具体方式。该方法返回一个 EquipMethod 枚举，共有以下八种可能的情况：

• SHIFT_CLICK：按住 Shift 键并左键或右键点击。
• DRAG：按住 Shift 键，将物品拖拽到盔甲栏后释放左键。
• PICK_DROP：拾取物品后，将其放入盔甲栏或物品栏。
• HOTBAR：从下方的 9 个快捷栏中右键点击一件盔甲。
• HOTBAR_SWAP：将鼠标悬停在盔甲栏上时，按下数字键 1-9 来装备/卸下对应快捷栏的盔甲。
• DISPENSER：处于发射器范围内，当发射器射出一件盔甲时自动装备。
• BROKE：当一件盔甲耐久耗尽而损坏时（如果事件被取消，耐久度会设为 0，意味着再受一次攻击就会真正损坏）。
• DEATH：当玩家死亡时。