PlayerEnterArenaEvent

PlayerEnterArenaEvent fires after KOTL detects an eligible area transition but before the player is added to the game.

Technical Overview

Package: dev.despical.kotl.api.events.player
Parent Class: PlayerEvent
Cancellable: Yes

Methods

Method	Return Type	Description
`getPlayer()`	`Player`	Player attempting to enter.
`getUser()`	`User`	KOTL user for the player.
`getGame()`	`Game`	Target game.
`getArena()`	`Arena`	Target arena.
`isCancelled()`	`boolean`	Whether entry is blocked.
`setCancelled(boolean)`	`void`	Blocks or restores the entry attempt.

Common Uses

Arena-specific permissions
Maintenance locks
Party or queue requirements
External cooldowns
Entry logging

Example

import dev.despical.kotl.api.events.player.PlayerEnterArenaEvent;
import org.bukkit.event.EventHandler;

@EventHandler
public void onArenaEntry(PlayerEnterArenaEvent event) {
    String permission = "server.kotl." + event.getArena().getId();

    if (!event.getPlayer().hasPermission(permission)) {
        event.setCancelled(true);
        event.getPlayer().sendMessage("You cannot enter this arena.");
    }
}