Improve hands & pulling (#4389)

Content.Shared/Interaction/BeforeInteract.cs

@@ -0,0 +1,53 @@
+using JetBrains.Annotations;
+using Robust.Shared.GameObjects;
+using Robust.Shared.Map;
+
+namespace Content.Shared.Interaction
+{
+    /// <summary>
+    ///     Raised directed on the used object when clicking on another object before an interaction is handled.
+    /// </summary>
+    [PublicAPI]
+    public class BeforeInteractEvent : HandledEntityEventArgs
+    {
+        /// <summary>
+        ///     Entity that triggered the interaction.
+        /// </summary>
+        public IEntity User { get; }
+
+        /// <summary>
+        ///     Entity that the user used to interact.
+        /// </summary>
+        public IEntity Used { get; }
+
+        /// <summary>
+        ///     Entity that was interacted on. This can be null if the attack did not click on an entity.
+        /// </summary>
+        public IEntity? Target { get; }
+
+        /// <summary>
+        ///     Location that the user clicked outside of their interaction range.
+        /// </summary>
+        public EntityCoordinates ClickLocation { get; }
+
+        /// <summary>
+        /// Is the click location close enough to reach by the player? This does not check for obstructions, just that the target is within
+        /// reach radius around the user.
+        /// </summary>
+        public bool CanReach { get; }
+
+        public BeforeInteractEvent(
+            IEntity user,
+            IEntity used,
+            IEntity? target,
+            EntityCoordinates clickLocation,
+            bool canReach)
+        {
+            User = user;
+            Used = used;
+            Target = target;
+            ClickLocation = clickLocation;
+            CanReach = canReach;
+        }
+    }
+}

Content.Shared/Interaction/IDropped.cs

@@ -0,0 +1,59 @@
+using System;
+using JetBrains.Annotations;
+using Robust.Shared.Analyzers;
+using Robust.Shared.GameObjects;
+
+namespace Content.Shared.Interaction
+{
+    /// <summary>
+    ///     This interface gives components behavior when they're dropped by a mob.
+    /// </summary>
+    [RequiresExplicitImplementation]
+    public interface IDropped
+    {
+        [Obsolete("Use DroppedMessage instead")]
+        void Dropped(DroppedEventArgs eventArgs);
+    }
+
+    public class DroppedEventArgs : EventArgs
+    {
+        public DroppedEventArgs(IEntity user, bool intentional)
+        {
+            User = user;
+            Intentional = intentional;
+        }
+
+        public IEntity User { get; }
+
+        public bool Intentional { get; }
+    }
+
+    /// <summary>
+    ///     Raised when an entity is dropped
+    /// </summary>
+    [PublicAPI]
+    public class DroppedEvent : HandledEntityEventArgs
+    {
+        /// <summary>
+        ///     Entity that dropped the item.
+        /// </summary>
+        public IEntity User { get; }
+
+        /// <summary>
+        ///     Item that was dropped.
+        /// </summary>
+        public IEntity Dropped { get; }
+
+        /// <summary>
+        ///     If the item was dropped intentionally.
+        /// </summary>
+        public bool Intentional { get; }
+
+        public DroppedEvent(IEntity user, IEntity dropped, bool intentional)
+        {
+            User = user;
+            Dropped = dropped;
+            Intentional = intentional;
+        }
+    }
+}