工具类

所有工具类位于 cn.org.bukkit.craneattribute.core.utils 包下。以下是常用的工具类：

BukkitUtils

提供与 Bukkit API 交互的便捷方法：

• safeHeal(entity, amount) — 安全治疗实体，正确触发 EntityRegainHealthEvent
• createAttributeModifier(name, value) — 创建兼容多版本的属性修饰符
• getItemName(itemStack, player) — 获取物品的显示名称
• hasMainHandCooldown(player) — 检查玩家主手是否有冷却
• setMainHandCooldown(player, ticks) — 设置玩家主手冷却
• isVersionAtLeast(major, minor) — 检查服务器版本

SchedulerUtils

调度任务工具：

• sync { ... } — 在主线程执行代码
• async { ... } — 在异步线程执行代码

ListenerUtils

事件监听器注册工具：

• registerListener(name, eventClass, priority, ignoreCancelled) { event -> ... } — 注册监听器
• unregisterListener(name) — 卸载监听器

CooldownUtils

冷却时间管理工具：

• isCooldown(key, time) — 检查是否在冷却中
• setCooldown(key) — 设置冷却

完整参考

javadoc