BlunthornAPI

这是一个 API 模组，本身不添加任何内容。它目前的主要目标是简化创建 BlockBlock 模组及其附属模组的过程。

特性

此模组添加了许多事件，以及一个权限系统框架，允许开发者阻止玩家执行某些操作。

事件

BlockBreakEvent.ATTACK - 当玩家开始挖掘方块时触发
BlockBreakEvent.BEFORE - 在方块被破坏之前触发
BlockBreakEvent.AFTER - 在方块成功被破坏后触发（无法取消）
BlockPlaceEvent - 当玩家放置方块时触发
BlockUseEvent 当玩家（右键）使用方块时触发
EntityItemDropEvent - 当被击杀的实体即将掉落其战利品时触发
EntityUseEvent - 当玩家（右键）使用实体时触发
ItemUseEvent - 当玩家使用物品时触发
ObjectCraftedEvent - 当玩家在合成网格中输入有效配方时触发

权限框架

权限框架使得针对特定物品、方块、实体或其他操作锁定特定动作变得更加容易。锁定操作是基于每个玩家进行的。

该 API 添加了 3 个可供你使用的 ActionContext 类：
BlockActionContext - 用于破坏、放置和方块交互。
ItemActionContext - 用于物品使用和合成配方。
EntityActionContext - 用于与实体交互并阻止其掉落物。

这些上下文类包含了你可能需要的所有信息，以决定需要对某个操作做什么。

或者，你可以使用 Permission.isObjectLocked(context) 将其传递给 Permission 类。这将返回某个对象对于特定玩家是否被锁定。

---

有关如何使用该 API 的更全面指南，请参阅 wiki（正在建设中）。

---