Implanters and Subdermal Implants (#11840)

Co-authored-by: metalgearsloth <31366439+metalgearsloth@users.noreply.github.com>
Co-authored-by: metalgearsloth <comedian_vs_clown@hotmail.com>

Content.Shared/Implants/Components/ImplantedComponent.cs

@@ -0,0 +1,13 @@
+using Robust.Shared.Containers;
+
+namespace Content.Shared.Implants.Components;
+
+/// <summary>
+/// Added to an entity via the <see cref="SharedImplanterSystem"/> on implant
+/// Used in instances where mob info needs to be passed to the implant such as MobState triggers
+/// </summary>
+[RegisterComponent]
+public sealed class ImplantedComponent : Component
+{
+    public Container ImplantContainer = default!;
+}

Content.Shared/Implants/Components/ImplanterComponent.cs

@@ -0,0 +1,107 @@
+using System.Threading;
+using Content.Shared.Containers.ItemSlots;
+using Robust.Shared.GameStates;
+using Robust.Shared.Prototypes;
+using Robust.Shared.Serialization;
+using Robust.Shared.Serialization.TypeSerializers.Implementations.Custom.Prototype;
+
+namespace Content.Shared.Implants.Components;
+/// <summary>
+/// Implanters are used to implant or extract implants from an entity
+/// Some can be single use (implant only) or some can draw out an implant
+/// </summary>
+//TODO: Rework drawing to work with implant cases when surgery is in
+[RegisterComponent, NetworkedComponent]
+public sealed class ImplanterComponent : Component
+{
+    public const string ImplanterSlotId = "implanter_slot";
+    public const string ImplantSlotId = "implant";
+
+    /// <summary>
+    /// Used for implanters that start with specific implants
+    /// </summary>
+    [ViewVariables]
+    [DataField("implant", customTypeSerializer: typeof(PrototypeIdSerializer<EntityPrototype>))]
+    public string? Implant;
+
+    /// <summary>
+    /// The time it takes to implant someone else
+    /// </summary>
+    [ViewVariables(VVAccess.ReadWrite)]
+    [DataField("implantTime")]
+    public float ImplantTime = 5f;
+
+    //TODO: Remove when surgery is a thing
+    /// <summary>
+    /// The time it takes to extract an implant from someone
+    /// It's excessively long to deter from implant checking any antag
+    /// </summary>
+    [ViewVariables(VVAccess.ReadWrite)]
+    [DataField("drawTime")]
+    public float DrawTime = 300f;
+
+    /// <summary>
+    /// Good for single-use injectors
+    /// </summary>
+    [ViewVariables]
+    [DataField("implantOnly")]
+    public bool ImplantOnly = false;
+
+    /// <summary>
+    /// The current mode of the implanter
+    /// Mode is changed automatically depending if it implants or draws
+    /// </summary>
+    [ViewVariables]
+    [DataField("currentMode")]
+    public ImplanterToggleMode CurrentMode;
+
+    /// <summary>
+    /// The name and description of the implant to show on the implanter
+    /// </summary>
+    [ViewVariables]
+    [DataField("implantData")]
+    public (string, string) ImplantData;
+
+    /// <summary>
+    /// The <see cref="ItemSlot"/> for this implanter
+    /// </summary>
+    [ViewVariables]
+    [DataField("implanterSlot")]
+    public ItemSlot ImplanterSlot = new();
+
+    public bool UiUpdateNeeded;
+
+    public CancellationTokenSource? CancelToken;
+}
+
+[Serializable, NetSerializable]
+public sealed class ImplanterComponentState : ComponentState
+{
+    public ImplanterToggleMode CurrentMode;
+    public bool ImplantOnly;
+
+    public ImplanterComponentState(ImplanterToggleMode currentMode, bool implantOnly)
+    {
+        CurrentMode = currentMode;
+        ImplantOnly = implantOnly;
+    }
+}
+
+[Serializable, NetSerializable]
+public enum ImplanterToggleMode : byte
+{
+    Inject,
+    Draw
+}
+
+[Serializable, NetSerializable]
+public enum ImplanterVisuals : byte
+{
+    Full
+}
+
+[Serializable, NetSerializable]
+public enum ImplanterImplantOnlyVisuals : byte
+{
+    ImplantOnly
+}

Content.Shared/Implants/Components/SubdermalImplantComponent.cs

@@ -0,0 +1,53 @@
+using Content.Shared.Actions;
+
+namespace Content.Shared.Implants.Components;
+
+/// <summary>
+/// Subdermal implants get stored in a container on an entity and grant the entity special actions
+/// The actions can be activated via an action, a passive ability (ie tracking), or a reactive ability (ie on death) or some sort of combination
+/// They're added and removed with implanters
+/// </summary>
+[RegisterComponent]
+public sealed class SubdermalImplantComponent : Component
+{
+    /// <summary>
+    /// Used where you want the implant to grant the owner an instant action.
+    /// </summary>
+    [ViewVariables(VVAccess.ReadWrite)]
+    [DataField("implantAction")]
+    public string? ImplantAction;
+
+    /// <summary>
+    /// The entity this implant is inside
+    /// </summary>
+    [ViewVariables]
+    public EntityUid? ImplantedEntity;
+
+    /// <summary>
+    /// Should this implant be removeable?
+    /// </summary>
+    [ViewVariables(VVAccess.ReadWrite)]
+    [DataField("permanent")]
+    public bool Permanent = false;
+}
+
+/// <summary>
+/// Used for opening the storage implant via action.
+/// </summary>
+public sealed class OpenStorageImplantEvent : InstantActionEvent
+{
+
+}
+
+public sealed class UseFreedomImplantEvent : InstantActionEvent
+{
+
+}
+
+/// <summary>
+/// Used for triggering trigger events on the implant via action
+/// </summary>
+public sealed class ActivateImplantEvent : InstantActionEvent
+{
+
+}

Content.Shared/Implants/Components/TriggerImplantActionComponent.cs

@@ -0,0 +1,9 @@
+namespace Content.Shared.Implants.Components;
+/// <summary>
+/// Triggers implants when the action is pressed
+/// </summary>
+[RegisterComponent]
+public sealed class TriggerImplantActionComponent : Component
+{
+
+}