Add Buckling (#1155)

* Create BuckleableComponent.cs

* Add strap component and keybind to buckle targeted entity

* Remove buckle keybind, turn it into a verb

* Add moving and attaching the buckled entity to the strap

* Fix reality collapsing when clicking on a buckled entity

* Add strap position to buckle a mob in the standing or down position

* Add new default strap position that makes no change to the mob's standing state

* Add Strap component to office chairs and stools

* Add Strap component to the pilot chair

* Add buckled status effect icon

* Add status effect click behaviour

* Add buckling and unbuckling sounds

* Change Buckle verb to only appear when an entity can be currently buckled

* Rotate buckled entity in the direction of the seat

* Disable entity rotation when buckled

* Fix buckle rotation on beds

* Buckling now finds the closest strap to the buckleable entity

* Fix rotation when unbuckling an entity

* Move buckle verb to StrapComponent

* Added buckled entity unbuckle verb, range and interaction checks

* Add checks for currently occupied straps

* Add unbuckling entity if its respective strap component is removed

* Add Clickable, InteractionOutline and Collidable components to bed

* Add rotation property to strap component

* Rename Buckleable to Buckle

* Add Buckle and Strap sizes to buckle multiple entities in the same strap

* Remove out of range popup message from strap verb GetData

* Move BuckledTo setter logic to its methods

* Fix Strap BuckledEntities being public

* Fix not updating status when Buckle component is removed

* Change BuckleComponent.BuckledTo to be of type StrapComponent

* Fix NRE when unbuckling

* Add buckle perspective messages

* Fix not equals comparison in strap verb

* Add added check to Strap TryAdd

* Change buckle.ogg and unbuckle.ogg from stereo to mono

* Remove -2f volume on buckle and unbuckle sounds

* Add summary to Strap TryAdd and Remove methods

* Make buckled entities unable to fall

* Fix default strap position not rotating the buckled entity

* Add downing after unbuckling an entity if it is knocked down

* Prevent an entity from buckling onto itself

Fixes stack overflow error

* Disable recursive buckling

* Add buckling onto straps by clicking them with an empty hand

* Add recursive buckle check to the trybuckle method as well

* Fix being able to click on a different strap to unbuckle from the current one

* Merge TryUnbuckle and ForceUnbuckle with a force argument

* Remove explicit unimplemented status effect clicking cases

* Add documentation to EffectBlockerSystem and ActionBlockerSystem

Content.Shared/GameObjects/EntitySystems/ActionBlockerSystem.cs

@@ -3,6 +3,10 @@ using Robust.Shared.Interfaces.GameObjects;
 
 namespace Content.Shared.GameObjects.EntitySystems
 {
+    /// <summary>
+    /// This interface gives components the ability to block certain actions from
+    /// being done by the owning entity. For effects see <see cref="IEffectBlocker"/>
+    /// </summary>
     public interface IActionBlocker
     {
         bool CanMove() => true;
@@ -27,6 +31,10 @@ namespace Content.Shared.GameObjects.EntitySystems
         bool CanChangeDirection() => true;
     }
 
+    /// <summary>
+    /// Utility methods to check if a specific entity is allowed to perform an action.
+    /// For effects see <see cref="EffectBlockerSystem"/>
+    /// </summary>
     public class ActionBlockerSystem : EntitySystem
     {
         public static bool CanMove(IEntity entity)
@@ -34,7 +42,7 @@ namespace Content.Shared.GameObjects.EntitySystems
             bool canmove = true;
             foreach(var actionblockercomponents in entity.GetAllComponents<IActionBlocker>())
             {
-                canmove &= actionblockercomponents.CanMove(); //sets var to false if false
+                canmove &= actionblockercomponents.CanMove(); // Sets var to false if false
             }
             return canmove;
         }