diff options
Diffstat (limited to 'patches/api/0069-Add-PlayerJumpEvent.patch')
-rw-r--r-- | patches/api/0069-Add-PlayerJumpEvent.patch | 118 |
1 files changed, 118 insertions, 0 deletions
diff --git a/patches/api/0069-Add-PlayerJumpEvent.patch b/patches/api/0069-Add-PlayerJumpEvent.patch new file mode 100644 index 0000000000..fef1ccd347 --- /dev/null +++ b/patches/api/0069-Add-PlayerJumpEvent.patch @@ -0,0 +1,118 @@ +From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001 +From: Zach Brown <[email protected]> +Date: Thu, 28 Sep 2017 17:21:32 -0400 +Subject: [PATCH] Add PlayerJumpEvent + + +diff --git a/src/main/java/com/destroystokyo/paper/event/player/PlayerJumpEvent.java b/src/main/java/com/destroystokyo/paper/event/player/PlayerJumpEvent.java +new file mode 100644 +index 0000000000000000000000000000000000000000..8c2fd2c1120d634052f9bc345365272ad3a67b6f +--- /dev/null ++++ b/src/main/java/com/destroystokyo/paper/event/player/PlayerJumpEvent.java +@@ -0,0 +1,106 @@ ++package com.destroystokyo.paper.event.player; ++ ++import com.google.common.base.Preconditions; ++import org.bukkit.Location; ++import org.bukkit.entity.Player; ++import org.bukkit.event.Cancellable; ++import org.bukkit.event.HandlerList; ++import org.bukkit.event.player.PlayerEvent; ++import org.bukkit.event.player.PlayerMoveEvent; ++import org.jetbrains.annotations.ApiStatus; ++import org.jetbrains.annotations.NotNull; ++ ++/** ++ * Called when the server detects the player is jumping. ++ * <p> ++ * Added to avoid the overhead and special case logic that many plugins use ++ * when checking for jumps via {@link PlayerMoveEvent}, this event is fired whenever ++ * the server detects that the player is jumping. ++ */ ++public class PlayerJumpEvent extends PlayerEvent implements Cancellable { ++ ++ private static final HandlerList HANDLER_LIST = new HandlerList(); ++ ++ @NotNull private final Location to; ++ @NotNull private Location from; ++ ++ private boolean cancelled; ++ ++ @ApiStatus.Internal ++ public PlayerJumpEvent(@NotNull final Player player, @NotNull final Location from, @NotNull final Location to) { ++ super(player); ++ this.from = from; ++ this.to = to; ++ } ++ ++ /** ++ * {@inheritDoc} ++ * <p> ++ * If a jump event is cancelled, the player will be moved or ++ * teleported back to the Location as defined by {@link #getFrom()}. This will not ++ * fire an event ++ * ++ * @return {@code true} if this event is cancelled ++ */ ++ public boolean isCancelled() { ++ return this.cancelled; ++ } ++ ++ /** ++ * {@inheritDoc} ++ * <p> ++ * If a jump event is cancelled, the player will be moved or ++ * teleported back to the Location as defined by {@link #getFrom()}. This will not ++ * fire an event ++ * ++ * @param cancel {@code true} if you wish to cancel this event ++ */ ++ public void setCancelled(boolean cancel) { ++ this.cancelled = cancel; ++ } ++ ++ /** ++ * Gets the location this player jumped from ++ * ++ * @return Location the player jumped from ++ */ ++ @NotNull ++ public Location getFrom() { ++ return this.from; ++ } ++ ++ /** ++ * Sets the location to mark as where the player jumped from ++ * ++ * @param from New location to mark as the players previous location ++ */ ++ public void setFrom(@NotNull Location from) { ++ Preconditions.checkArgument(from != null, "Cannot use null from location!"); ++ Preconditions.checkArgument(from.getWorld() != null, "Cannot use from location with null world!"); ++ this.from = from; ++ } ++ ++ /** ++ * Gets the location this player jumped to ++ * <p> ++ * This information is based on what the client sends, it typically ++ * has little relation to the arc of the jump at any given point. ++ * ++ * @return Location the player jumped to ++ */ ++ @NotNull ++ public Location getTo() { ++ return this.to.clone(); ++ } ++ ++ @NotNull ++ @Override ++ public HandlerList getHandlers() { ++ return HANDLER_LIST; ++ } ++ ++ @NotNull ++ public static HandlerList getHandlerList() { ++ return HANDLER_LIST; ++ } ++} |