From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001 From: Owen1212055 <23108066+Owen1212055@users.noreply.github.com> Date: Sun, 5 Sep 2021 00:36:05 -0400 Subject: [PATCH] More Teleport API diff --git a/src/main/java/io/papermc/paper/entity/LookAnchor.java b/src/main/java/io/papermc/paper/entity/LookAnchor.java new file mode 100644 index 0000000000000000000000000000000000000000..7713a5b7e06da185685f18e79eae2c972e588696 --- /dev/null +++ b/src/main/java/io/papermc/paper/entity/LookAnchor.java @@ -0,0 +1,25 @@ +package io.papermc.paper.entity; + +import org.bukkit.Location; +import org.bukkit.entity.Entity; +import org.bukkit.entity.LivingEntity; + +/** + * Represents what part of the entity should be used when determining where to face a location/entity. + * + * @see org.bukkit.entity.Player#lookAt(Location, LookAnchor) + * @see org.bukkit.entity.Player#lookAt(Entity, LookAnchor, LookAnchor) + */ +@org.jetbrains.annotations.ApiStatus.Experimental +public enum LookAnchor { + /** + * Represents the entity's feet. + * @see LivingEntity#getLocation() + */ + FEET, + /** + * Represents the entity's eyes. + * @see LivingEntity#getEyeLocation() + */ + EYES; +} diff --git a/src/main/java/io/papermc/paper/entity/RelativeTeleportFlag.java b/src/main/java/io/papermc/paper/entity/RelativeTeleportFlag.java new file mode 100644 index 0000000000000000000000000000000000000000..0426ee8bd71142b6f933a479c0f2e5ef6043147d --- /dev/null +++ b/src/main/java/io/papermc/paper/entity/RelativeTeleportFlag.java @@ -0,0 +1,34 @@ +package io.papermc.paper.entity; + +import org.bukkit.Location; +import org.bukkit.event.player.PlayerTeleportEvent; + +/** + * Represents coordinates in a teleportation that should be handled relatively. + * + * @see org.bukkit.entity.Player#teleport(Location, PlayerTeleportEvent.TeleportCause, boolean, boolean, RelativeTeleportFlag...) + */ +@org.jetbrains.annotations.ApiStatus.Experimental +public enum RelativeTeleportFlag { + /** + * Represents the player's X coordinate + */ + X, + /** + * Represents the player's Y coordinate + */ + Y, + /** + * Represents the player's Z coordinate + */ + Z, + /** + * Represents the player's yaw + */ + YAW, + /** + * Represents the player's pitch + */ + PITCH; + +} diff --git a/src/main/java/org/bukkit/entity/Entity.java b/src/main/java/org/bukkit/entity/Entity.java index b878509ff536f2d728c800a0ae6cd36802570b31..9bfe62185acb2a208268a2db3aa81dad9e0eed5e 100644 --- a/src/main/java/org/bukkit/entity/Entity.java +++ b/src/main/java/org/bukkit/entity/Entity.java @@ -122,10 +122,77 @@ public interface Entity extends Metadatable, CommandSender, Nameable, Persistent * * @param yaw the yaw * @param pitch the pitch - * @throws UnsupportedOperationException if used for players */ public void setRotation(float yaw, float pitch); + // Paper start - Teleport API + /** + * Teleports this entity to the given location. + *

+ * Note: Teleporting to a different world with ignorePassengers to true while the entity has entities riding it + * will cause this teleportation to return false and not occur. + * + * @param location New location to teleport this entity to + * @param ignorePassengers If all passengers should not be required to be removed prior to teleportation + * @return true if the teleport was successful + */ + @org.jetbrains.annotations.ApiStatus.Experimental + default boolean teleport(@NotNull Location location, boolean ignorePassengers) { + return this.teleport(location, TeleportCause.PLUGIN, ignorePassengers); + } + + /** + * Teleports this entity to the given location. + *

+ * Note: Teleporting to a different world with ignorePassengers to true while the entity has entities riding it + * will cause this teleportation to return false and not occur. + * + * @param location New location to teleport this entity to + * @param cause The cause of this teleportation + * @param ignorePassengers If all passengers should not be required to be removed prior to teleportation + * @return true if the teleport was successful + */ + @org.jetbrains.annotations.ApiStatus.Experimental + default boolean teleport(@NotNull Location location, @NotNull TeleportCause cause, boolean ignorePassengers) { + return this.teleport(location, cause, ignorePassengers, true); + } + + /** + * Teleports this entity to the given location. + *

+ * Note: Teleporting to a different world with ignorePassengers to true while the entity has entities riding it + * will cause this teleportation to return false and not occur. + * Note: Teleporting to a different world with dismount to false while this entity is riding another entity will + * cause this teleportation to return false and not occur. + * + * @param location New location to teleport this entity to + * @param ignorePassengers If all passengers should not be required to be removed prior to teleportation + * @param dismount If the entity should be dismounted if they are riding another entity + * @return true if the teleport was successful + */ + @org.jetbrains.annotations.ApiStatus.Experimental + default boolean teleport(@NotNull Location location, boolean ignorePassengers, boolean dismount) { + return this.teleport(location, TeleportCause.PLUGIN, ignorePassengers, dismount); + } + + /** + * Teleports this entity to the given location. + *

+ * Note: Teleporting to a different world with ignorePassengers to true while the entity has entities riding it + * will cause this teleportation to return false and not occur. + * Note: Teleporting to a different world with dismount to false while this entity is riding another entity will + * cause this teleportation to return false and not occur. + * + * @param location New location to teleport this entity to + * @param cause The cause of this teleportation + * @param ignorePassengers If all passengers should not be required to be removed prior to teleportation + * @param dismount If the entity should be dismounted if they are riding another entity + * @return true if the teleport was successful + */ + @org.jetbrains.annotations.ApiStatus.Experimental + boolean teleport(@NotNull Location location, @NotNull TeleportCause cause, boolean ignorePassengers, boolean dismount); + // Paper end - Teleport API + /** * Teleports this entity to the given location. If this entity is riding a * vehicle, it will be dismounted prior to teleportation. diff --git a/src/main/java/org/bukkit/entity/Player.java b/src/main/java/org/bukkit/entity/Player.java index 17ad43c24dc2e18f5cde0ac0bfae1de9fe415964..6fbdcf6e5df2e613db022d38fc1e170578ef5e8a 100644 --- a/src/main/java/org/bukkit/entity/Player.java +++ b/src/main/java/org/bukkit/entity/Player.java @@ -2757,6 +2757,71 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM String getClientBrandName(); // Paper end + // Paper start - Teleport API + /** + * Sets the player's rotation. + * + * @param yaw the yaw + * @param pitch the pitch + */ + @org.jetbrains.annotations.ApiStatus.Experimental + void setRotation(float yaw, float pitch); + + /** + * Teleports this entity to the given location. + *

+ * Note: Teleporting to a different world with ignorePassengers to true while the entity has entities riding it + * will cause this teleportation to return false and not occur. + * Note: Teleporting to a different world with dismount to false while this entity is riding another entity will + * cause this teleportation to return false and not occur. + * + *

+ * Relative teleportation flags are only used client side, and cause the player to not lose velocity in that + * specific coordinate. The location of the teleportation will not change. + * + * @param location New location to teleport this entity to + * @param cause The cause of this teleportation + * @param ignorePassengers If all passengers should not be required to be removed prior to teleportation + * @param dismount If the entity should be dismounted if they are riding another entity + * @param teleportFlags Coordinates of the location that the client should handle as relative teleportation + * @return true if the teleport was successful + */ + @org.jetbrains.annotations.ApiStatus.Experimental + boolean teleport(@NotNull Location location, @NotNull org.bukkit.event.player.PlayerTeleportEvent.TeleportCause cause, boolean ignorePassengers, boolean dismount, @NotNull io.papermc.paper.entity.RelativeTeleportFlag @NotNull... teleportFlags); + + /** + * Causes the player to look towards the given position. + * + * @param x x coordinate + * @param y y coordinate + * @param z z coordinate + * @param playerAnchor What part of the player should face the given position + */ + @org.jetbrains.annotations.ApiStatus.Experimental + void lookAt(double x, double y, double z, @NotNull io.papermc.paper.entity.LookAnchor playerAnchor); + + /** + * Causes the player to look towards the given location. + * + * @param location Location to look at + * @param playerAnchor What part of player should face the location + */ + @org.jetbrains.annotations.ApiStatus.Experimental + default void lookAt(@NotNull Location location, @NotNull io.papermc.paper.entity.LookAnchor playerAnchor) { + this.lookAt(location.getX(), location.getY(), location.getZ(), playerAnchor); + } + + /** + * Causes the player to look towards the given entity. + * + * @param entity Entity to look at + * @param playerAnchor What part of the player should face the entity + * @param entityAnchor What part of the entity the player should face + */ + @org.jetbrains.annotations.ApiStatus.Experimental + void lookAt(@NotNull org.bukkit.entity.Entity entity, @NotNull io.papermc.paper.entity.LookAnchor playerAnchor, @NotNull io.papermc.paper.entity.LookAnchor entityAnchor); + // Paper end - Teleport API + @NotNull @Override Spigot spigot(); diff --git a/src/main/java/org/bukkit/event/player/PlayerTeleportEvent.java b/src/main/java/org/bukkit/event/player/PlayerTeleportEvent.java index 113e620ce38bb8ff97cf24e309af59b717774b36..149725da2468cf2e8cf3877f78b4a9b749ec1e51 100644 --- a/src/main/java/org/bukkit/event/player/PlayerTeleportEvent.java +++ b/src/main/java/org/bukkit/event/player/PlayerTeleportEvent.java @@ -13,8 +13,14 @@ public class PlayerTeleportEvent extends PlayerMoveEvent { private static final HandlerList handlers = new HandlerList(); private TeleportCause cause = TeleportCause.UNKNOWN; + // Paper start - Teleport API + private boolean dismounted = true; + private final java.util.Set teleportFlagSet; + // Paper end + public PlayerTeleportEvent(@NotNull final Player player, @NotNull final Location from, @Nullable final Location to) { super(player, from, to); + teleportFlagSet = java.util.Collections.emptySet(); // Paper - Teleport API } public PlayerTeleportEvent(@NotNull final Player player, @NotNull final Location from, @Nullable final Location to, @NotNull final TeleportCause cause) { @@ -23,6 +29,17 @@ public class PlayerTeleportEvent extends PlayerMoveEvent { this.cause = cause; } + // Paper start - Teleport API + @org.jetbrains.annotations.ApiStatus.Experimental + public PlayerTeleportEvent(@NotNull final Player player, @NotNull final Location from, @Nullable final Location to, @NotNull final TeleportCause cause, boolean dismounted, @NotNull java.util.Set teleportFlagSet) { + super(player, from, to); + + this.dismounted = dismounted; + this.teleportFlagSet = teleportFlagSet; + this.cause = cause; + } + // Paper end + /** * Gets the cause of this teleportation event * @@ -84,6 +101,30 @@ public class PlayerTeleportEvent extends PlayerMoveEvent { UNKNOWN; } + // Paper start - Teleport API + /** + * Gets if the player will be dismounted in this teleportation. + * + * @return dismounted or not + */ + @org.jetbrains.annotations.ApiStatus.Experimental + public boolean willDismountPlayer() { + return this.dismounted; + } + + /** + * Returns the relative teleportation flags used in this teleportation. + * This determines which axis the player will not lose their velocity in. + * + * @return an immutable set of relative teleportation flags + */ + @org.jetbrains.annotations.ApiStatus.Experimental + @NotNull + public java.util.Set getRelativeTeleportationFlags() { + return this.teleportFlagSet; + } + // Paper end + @NotNull @Override public HandlerList getHandlers() {