Spectator-Teleport Implementation (#1825)

Author: xXjojaXx

MinecraftClient/ChatBot.cs

@@ -1338,6 +1338,24 @@ protected bool SelectTrade(int selectedSlot)
         {
             return Handler.SelectTrade(selectedSlot);
         }
+
+        /// <summary>
+        /// Teleport to player in spectator mode
+        /// </summary>
+        /// <param name="entity">player to teleport to</param>
+        protected bool SpectatorTeleport(Entity entity)
+        {
+            return Handler.Spectate(entity);
+        }
+
+        /// <summary>
+        /// Teleport to player/entity in spectator mode
+        /// </summary>
+        /// <param name="uuid">uuid of entity to teleport to</param>
+        protected bool SpectatorTeleport(Guid UUID)
+        {
+            return Handler.SpectateByUUID(UUID);
+        }
 
         /// <summary>
         /// Update command block

MinecraftClient/McClient.cs

@@ -1695,6 +1695,41 @@ public bool UpdateCommandBlock(Location location, string command, CommandBlockMo
         {
             return InvokeOnMainThread(() => handler.UpdateCommandBlock(location, command, mode, flags));
         }
+
+        /// <summary>
+        /// Teleport to player in spectator mode
+        /// </summary>
+        /// <param name="entity">Player to teleport to</param>
+        /// Teleporting to other entityies is NOT implemented yet
+        public bool Spectate(Entity entity)
+        {
+            if(entity.Type == EntityType.Player)
+            {
+                return SpectateByUUID(entity.UUID);
+            }
+            else
+            {
+                return false;
+            }
+        }
+
+        /// <summary>
+        /// Teleport to player/entity in spectator mode
+        /// </summary>
+        /// <param name="UUID">UUID of player/entity to teleport to</param>
+        public bool SpectateByUUID(Guid UUID)
+        {
+            if(GetGamemode() == 3)
+            {
+                if(InvokeRequired)
+                    return InvokeOnMainThread(() => SpectateByUUID(UUID));
+                return handler.SendSpectate(UUID);
+            }
+            else
+            {
+                return false;
+            }
+        }
         #endregion
 
         #region Event handlers: An event occurs on the Server

MinecraftClient/Protocol/Handlers/DataTypes.cs

@@ -1047,6 +1047,16 @@ public byte GetBlockFace(Direction direction)
             }
         }
 
+        /// <summary>
+        /// Get a byte array from the given uuid
+        /// </summary>
+        /// <param name="uuid">UUID of Player/Entity</param>
+        /// <returns>UUID representation</returns>
+        public byte[] GetUUID(Guid UUID)
+        {
+            return UUID.ToBigEndianBytes();
+        }
+
         /// <summary>
         /// Easily append several byte arrays
         /// </summary>

MinecraftClient/Protocol/Handlers/Protocol16.cs

@@ -860,5 +860,10 @@ public bool SelectTrade(int selectedSlot)
         {
             return false; //MC 1.13+
         }
+
+        public bool SendSpectate(Guid UUID)
+        {
+            return false; //Currently not implemented
+        }
     }
 }

MinecraftClient/Protocol/Handlers/Protocol18.cs

@@ -2057,5 +2057,19 @@ public bool SelectTrade(int selectedSlot)
             }
             else { return false; }
         }
+
+        public bool SendSpectate(Guid UUID)
+        {
+            try
+            {
+                List<byte> packet = new List<byte>();
+                packet.AddRange(dataTypes.GetUUID(UUID));
+                SendPacket(PacketTypesOut.Spectate, packet);
+                return true;
+            }
+            catch (SocketException) { return false; }
+            catch (System.IO.IOException) { return false; }
+            catch (ObjectDisposedException) { return false; }
+        }
     }
 }

MinecraftClient/Protocol/IMinecraftCom.cs

@@ -236,6 +236,12 @@ public interface IMinecraftCom : IDisposable, IAutoComplete
         /// <param name="selectedSlot">The slot of the trade, starts at 0.</param>
         bool SelectTrade(int selectedSlot);
 
+        /// <summary>
+        /// Spectate a player/entity
+        /// </summary>
+        /// <param name="uuid">The uuid of the player/entity to spectate/teleport to.</param>
+        bool SendSpectate(Guid uuid);
+
         /// <summary>
         /// Get net read thread (main thread) ID
         /// </summary>