Add WarmUpCancelled Event & Expose TPType (#6351)

<!--

EssentialsX feature submission guide
====================================

NOTE: Failure to fill out this template properly may result in your PR
being
      delayed or ignored without warning.

NOTE: Don't type between any arrows in the template, as this text will
be
hidden. This includes this header block and any other explanation text
      blocks.

Want to discuss your PR before submitting it? Join the EssentialsX
Development
server: https://discord.gg/CUN7qVb


EssentialsX is GPL
------------------

By contributing to EssentialsX, you agree to license your code under the
GNU General Public License version 3, which can be found at the link
below:
https://github.com/EssentialsX/Essentials/blob/2.x/LICENSE


Instructions
------------

If you are submitting a new feature, please follow the following steps:

1.  Fill out the template in full.
This includes providing screenshots and a link to the original feature
      request. If there isn't an existing feature request, we strongly
      recommend opening a new feature request BEFORE opening your PR to
implement it, as this allows us to review whether we're likely to accept
      your feature in advance, and also allows us to discuss possible
      implementations for the feature. If there is no associated feature
      request, your PR may be delayed or rejected without warning.
      
      You can open a new feature request by following this link:
      https://github.com/EssentialsX/Essentials/issues/new/choose

2. If you are fixing a performance issue, please use the "Bug fix" PR
template
instead. The "bug fix" template is better suited to performance issues.

3.  Include a demonstration.
If you are adding commands, please provide screenshots and/or a video
demonstration of the feature. Similarly, if you are adding a new API,
      please include a link to example code that takes advantage of your
proposed API. This will aid us in reviewing PRs and speed up the process
      significantly.

-->

### Information

<!--
Replace #nnnn with the number of the original issue. If this PR
implements
features from multiple issues, you should repeat the phrase "closes
#nnnn"
    for each issue. 
-->

### Details

**Proposed feature:**  
This PR add a new event when a warmpup teleport is cancelled, and it
also expose the tpType


**Environments tested:**    

<!-- Type the OS you have used below. -->
OS: Debian 12

<!-- Type the JDK version (from java -version) you have used below. -->
Java version: OpenJDK Runtime Environment Corretto-8.422.05.1 (build
1.8.0_422-b05)

<!--
Put an "x" inside the boxes for the server software you have tested this
bug fix on. If this feature does not apply to a server, strike through
the server software using ~~strikethrough~~. If you have tested on other
    environments, add a new line with relevant details.
-->
- [x] Most recent Paper version (1.21.8, git-Paper-60-main@29c8822)
- [ ] CraftBukkit/Spigot/Paper 1.12.2
- [x] Paper 1.8.8

---------

Co-authored-by: Josh Roy <[email protected]>

Author: Koora7334

Essentials/src/main/java/com/earth2me/essentials/AsyncTeleport.java

@@ -457,6 +457,10 @@ public void back(final CompletableFuture<Boolean> future) {
         nowAsync(teleportOwner, new LocationTarget(teleportOwner.getLastLocation()), TeleportCause.COMMAND, future);
     }
 
+    public TeleportType getTpType() {
+        return this.tpType;
+    }
+
     public void setTpType(final TeleportType tpType) {
         this.tpType = tpType;
     }

Essentials/src/main/java/com/earth2me/essentials/AsyncTimedTeleport.java

@@ -1,12 +1,15 @@
 package com.earth2me.essentials;
 
-import net.ess3.api.IEssentials;
-import net.ess3.api.IUser;
+import java.util.UUID;
+import java.util.concurrent.CompletableFuture;
+
 import org.bukkit.Location;
 import org.bukkit.event.player.PlayerTeleportEvent.TeleportCause;
 
-import java.util.UUID;
-import java.util.concurrent.CompletableFuture;
+import net.ess3.api.IEssentials;
+import net.ess3.api.IUser;
+import net.essentialsx.api.v2.events.TeleportWarmupCancelledEvent;
+import net.essentialsx.api.v2.events.TeleportWarmupCancelledEvent.CancelReason;
 
 public class AsyncTimedTeleport implements Runnable {
     private static final double MOVE_CONSTANT = 0.3;
@@ -149,6 +152,14 @@ void cancelTimer(final boolean notifyUser) {
         }
         try {
             ess.getServer().getScheduler().cancelTask(timer_task);
+
+            final IUser teleportUser = ess.getUser(this.timer_teleportee);
+            if (teleportUser != null && teleportUser.getBase() != null) {
+                final TeleportWarmupCancelledEvent.CancelReason cancelReason = teleportUser.getBase().isOnline() ? CancelReason.MOVE : CancelReason.LEAVE;
+                final TeleportWarmupCancelledEvent event = new TeleportWarmupCancelledEvent(teleportUser.getBase(), this.teleport.getTpType(), cancelReason, notifyUser);
+                ess.getServer().getPluginManager().callEvent(event);
+            }
+
             if (notifyUser) {
                 teleportOwner.sendTl("pendingTeleportCancelled");
                 if (timer_teleportee != null && !timer_teleportee.equals(teleportOwner.getBase().getUniqueId())) {

Essentials/src/main/java/net/essentialsx/api/v2/events/TeleportWarmupCancelledEvent.java

@@ -0,0 +1,77 @@
+package net.essentialsx.api.v2.events;
+
+import org.bukkit.entity.Player;
+import org.bukkit.event.Event;
+import org.bukkit.event.HandlerList;
+import com.earth2me.essentials.AsyncTeleport.TeleportType;
+
+/**
+ * Called when a player's teleport warmup is cancelled.
+ */
+public class TeleportWarmupCancelledEvent extends Event {
+
+    private static final HandlerList handlers = new HandlerList();
+
+    private final Player player;
+    private final TeleportType teleportType;
+    private final CancelReason cancelReason;
+    private final boolean notifyUser;
+
+    public TeleportWarmupCancelledEvent(final Player player, final TeleportType teleportType, CancelReason cancelReason, final boolean notifyUser) {
+        this.player = player;
+        this.teleportType = teleportType;
+        this.cancelReason = cancelReason;
+        this.notifyUser = notifyUser;
+    }
+
+    public static HandlerList getHandlerList() {
+        return handlers;
+    }
+
+    @Override
+    public HandlerList getHandlers() {
+        return handlers;
+    }
+
+    /**
+     * @return the player whose teleport was canceled.
+     */
+    public Player getPlayer() {
+        return this.player;
+    }
+
+    /**
+     * @return the type of teleport that was canceled.
+     */
+    public TeleportType getTeleportType() {
+        return this.teleportType;
+    }
+
+    /**
+     * @return the reason the teleport was cancelled.
+     */
+    public CancelReason getCancelReason() {
+        return this.cancelReason;
+    }
+
+    /**
+     * @return true if the player was notified that the teleport was canceled, otherwise false.
+     */
+    public boolean isPlayerNotified() {
+        return this.notifyUser;
+    }
+
+    /**
+     * Indicates the reason why the teleportation was cancelled.
+     */
+    public enum CancelReason {
+        /**
+         * Indicates that the cancellation occurred because the player disconnected
+         */
+        LEAVE,
+        /**
+         * Indicates that the cancellation occurred because the player moved
+         */
+        MOVE,
+    }
+}