WorldGuard Region Events - WorldGuard区域事件插件

💡简介

WorldGuard Region Events 允许模组开发者在玩家进入或离开区域时触发函数。它添加了四个事件，可用于触发您的函数：RegionEnterEvent、RegionEnteredEvent、RegionLeaveEvent 和 RegionLeftEvent。它们可以像任何其他 Bukkit 事件一样使用。

🎮事件说明

RegionEnterEvent 与 RegionLeaveEvent

• 当玩家即将进入或离开区域时触发。
• 可以取消（e.setCancelled(true)），以阻止玩家进入或离开。
• 适用于实现如禁止离开监狱区域等功能。

RegionEnteredEvent 与 RegionLeftEvent

• 在玩家实际进入或离开区域后一小段时间触发。
• 无法取消。
• 主要用于检查玩家所在区域的标志（flags），或执行后续操作。

🔧使用示例

示例一：进入区域时发送消息

当玩家进入一个区域时，向其发送提示信息。

import com.mewin.WGRegionEvents.events.RegionEnterEvent;
@EventHandler
public void onRegionEnter(RegionEnterEvent e) {
    e.getPlayer().sendMessage("你刚刚进入了区域：" + e.getRegion().getId());
}

示例二：防止玩家离开监狱区域

取消玩家离开“jail”区域的事件，并发送警告。

import com.mewin.WGRegionEvents.events.RegionLeaveEvent;
@EventHandler
public void onRegionLeave(RegionLeaveEvent e) {
    if (e.getRegion().getId().equals("jail") && e.isCancellable()) {
        // 注意：如果玩家因死亡而离开区域，事件可能无法取消
        e.setCancelled(true);
        e.getPlayer().sendMessage("你不能离开监狱！");
    }
}

❓权限与依赖

权限

• 本插件本身无需任何特定权限。权限控制依赖于 WorldGuard 区域的设置以及您在事件处理中的逻辑。

依赖

• 必须安装 WorldGuard 插件。
• 需要基于 Bukkit/Spigot/Paper 服务端，并支持事件监听。

💡注意事项与支持

遇到问题？

• 如果您在使用中遇到问题，请先使用插件页面的 Discussion（讨论） 选项卡进行反馈，特别是当您认为这不是程序错误（bug）时。
• 请先通过讨论联系我，再留下评论，以便我能更好地为您提供帮助。

开发提示

• 事件用法与其他 Bukkit 事件一致，更多细节可参考 Bukkit 事件系统文档。
• 确保您的插件正确监听并注册了这些事件。