Player events¶
This is the complete list of player events. See the event list for how to read the table.
| Event | When it happens | Can you cancel it? |
|---|---|---|
AsyncPlayerChatEvent |
A player sends a chat message. This one runs in the background. | Yes |
AsyncPlayerPreLoginEvent |
A player is connecting, before they are fully logged in. This one runs in the background. | No |
PlayerAdvancementCriterionGrantEvent |
A player completes part of an advancement | Yes |
PlayerAdvancementDoneEvent |
A player completes an advancement | No |
PlayerAnimationEvent |
A player swings their arm | Yes |
PlayerArmorStandManipulateEvent |
A player swaps items with an armor stand | Yes |
PlayerBedEnterEvent |
A player gets into a bed | Yes |
PlayerBedLeaveEvent |
A player gets out of a bed | Yes |
PlayerBucketEmptyEvent |
A player empties a bucket | Yes |
PlayerBucketEntityEvent |
A player picks up an entity with a bucket | Yes |
PlayerBucketFillEvent |
A player fills a bucket | Yes |
PlayerBucketFishEvent |
A player catches a fish with a bucket | Yes |
PlayerChangedMainHandEvent |
A player changes which hand is their main hand | No |
PlayerChangedWorldEvent |
A player moves to a different world | No |
PlayerCommandPreprocessEvent |
A player types a command, just before it runs | Yes |
PlayerCommandSendEvent |
The server sends a player their list of available commands | No |
PlayerCustomClickEvent |
A player triggers a custom click action | No |
PlayerDropItemEvent |
A player drops an item | Yes |
PlayerEditBookEvent |
A player edits or signs a book | Yes |
PlayerEggThrowEvent |
A player throws an egg | No |
PlayerExpChangeEvent |
A player's experience points change | No |
PlayerExpCooldownChangeEvent |
A player's experience pickup cooldown changes | No |
PlayerFishEvent |
A player uses a fishing rod | Yes |
PlayerGameModeChangeEvent |
A player's game mode changes | Yes |
PlayerHarvestBlockEvent |
A player harvests a plant, like berries | Yes |
PlayerHideEntityEvent |
An entity is hidden from a player | No |
PlayerInputEvent |
A player's movement input changes | No |
PlayerInteractAtEntityEvent |
A player clicks an entity at a specific spot on it | Yes |
PlayerInteractEntityEvent |
A player right-clicks an entity | Yes |
PlayerInteractEvent |
A player clicks or uses something | Yes |
PlayerItemBreakEvent |
A player's tool or armor breaks | No |
PlayerItemConsumeEvent |
A player eats or drinks an item | Yes |
PlayerItemDamageEvent |
A player's item loses durability | Yes |
PlayerItemHeldEvent |
A player changes which hotbar slot they hold | Yes |
PlayerItemMendEvent |
A player's item is repaired by Mending | Yes |
PlayerJoinEvent |
A player joins the server | No |
PlayerKickEvent |
A player is kicked | Yes |
PlayerLevelChangeEvent |
A player's experience level changes | No |
PlayerLinksSendEvent |
The server sends a player its list of links | No |
PlayerLocaleChangeEvent |
A player changes their language | No |
PlayerLoginEvent |
A player is logging in, before they join | No |
PlayerMoveEvent |
A player moves. This happens very often. | Yes |
PlayerPortalEvent |
A player goes through a portal | Yes |
PlayerQuitEvent |
A player leaves the server | No |
PlayerRecipeBookClickEvent |
A player clicks a recipe in the recipe book | No |
PlayerRecipeBookSettingsChangeEvent |
A player changes their recipe book settings | No |
PlayerRecipeDiscoverEvent |
A player discovers a new recipe | Yes |
PlayerRegisterChannelEvent |
A player registers a plugin messaging channel | No |
PlayerResourcePackStatusEvent |
The status of a player's resource pack download changes | No |
PlayerRespawnEvent |
A player respawns | No |
PlayerRiptideEvent |
A player uses a riptide trident | No |
PlayerShearEntityEvent |
A player shears an entity | Yes |
PlayerShowEntityEvent |
An entity is shown to a player | No |
PlayerSignOpenEvent |
A player opens a sign to edit it | Yes |
PlayerSpawnChangeEvent |
A player's spawn point changes | Yes |
PlayerStatisticIncrementEvent |
One of a player's statistics goes up | Yes |
PlayerSwapHandItemsEvent |
A player swaps the items in their two hands | Yes |
PlayerTakeLecternBookEvent |
A player takes a book from a lectern | Yes |
PlayerTeleportEvent |
A player teleports | Yes |
PlayerToggleFlightEvent |
A player starts or stops flying | Yes |
PlayerToggleSneakEvent |
A player starts or stops sneaking | Yes |
PlayerToggleSprintEvent |
A player starts or stops sprinting | Yes |
PlayerUnleashEntityEvent |
A player unleashes an entity | Yes |
PlayerUnregisterChannelEvent |
A player unregisters a plugin messaging channel | No |
PlayerVelocityEvent |
A player's velocity changes | Yes |
One more player event
PlayerSpawnLocationEvent also exists, but it lives in a different package. LuaCord looks for short names in the standard Bukkit event packages, so use its full name, org.spigotmc.event.player.PlayerSpawnLocationEvent.