Portals & hand teleporter (#13266)

* basic system with portals & linked ents

* hand tele sprites, no impl

* hand tele and teleportation works

* fancy it up

* oog

* special case projectiles

* predict portal-to-portal teleportation

* this stuff

* check nullspace

* sloth

* give to rd instead

* i guess this can probably happen

* docs

Content.Shared/Teleportation/Components/HandTeleporterComponent.cs

@@ -0,0 +1,36 @@
+using Content.Shared.Audio;
+using Robust.Shared.Audio;
+using Robust.Shared.GameStates;
+using Robust.Shared.Prototypes;
+using Robust.Shared.Serialization.TypeSerializers.Implementations.Custom.Prototype;
+
+namespace Content.Shared.Teleportation.Components;
+
+/// <summary>
+///     Creates portals. If two are created, both are linked together--otherwise the first teleports randomly.
+///     Using it with both portals active deactivates both.
+/// </summary>
+[RegisterComponent, NetworkedComponent]
+public sealed class HandTeleporterComponent : Component
+{
+    [ViewVariables, DataField("firstPortal")]
+    public EntityUid? FirstPortal = null;
+
+    [ViewVariables, DataField("secondPortal")]
+    public EntityUid? SecondPortal = null;
+
+    [DataField("firstPortalPrototype", customTypeSerializer:typeof(PrototypeIdSerializer<EntityPrototype>))]
+    public string FirstPortalPrototype = "PortalRed";
+
+    [DataField("secondPortalPrototype", customTypeSerializer:typeof(PrototypeIdSerializer<EntityPrototype>))]
+    public string SecondPortalPrototype = "PortalBlue";
+
+    [DataField("newPortalSound")]
+    public SoundSpecifier NewPortalSound = new SoundPathSpecifier("/Audio/Machines/high_tech_confirm.ogg")
+    {
+        Params = AudioParams.Default.WithVolume(-2f)
+    };
+
+    [DataField("clearPortalsSound")]
+    public SoundSpecifier ClearPortalsSound = new SoundPathSpecifier("/Audio/Machines/button.ogg");
+}