Add universal pinpointer (#13854)

Co-authored-by: metalgearsloth <comedian_vs_clown@hotmail.com>

Content.Shared/Pinpointer/SharedPinpointerSystem.cs

@@ -1,7 +1,77 @@
+using Content.Shared.Administration.Logs;
+using Content.Shared.Database;
+using Content.Shared.Emag.Systems;
+using Content.Shared.Examine;
+using Content.Shared.IdentityManagement;
+using Content.Shared.Interaction;
+
 namespace Content.Shared.Pinpointer;
 
 public abstract class SharedPinpointerSystem : EntitySystem
 {
+    [Dependency] private readonly ISharedAdminLogManager _adminLogger = default!;
+
+    public override void Initialize()
+    {
+        base.Initialize();
+        SubscribeLocalEvent<PinpointerComponent, GotEmaggedEvent>(OnEmagged);
+        SubscribeLocalEvent<PinpointerComponent, AfterInteractEvent>(OnAfterInteract);
+        SubscribeLocalEvent<PinpointerComponent, ExaminedEvent>(OnExamined);
+    }
+
+    /// <summary>
+    ///     Set the target if capable
+    /// </summary>
+    private void OnAfterInteract(EntityUid uid, PinpointerComponent component, AfterInteractEvent args)
+    {
+        if (!args.CanReach || args.Target is not { } target)
+            return;
+
+        if (!component.CanRetarget || component.IsActive)
+            return;
+
+        // TODO add doafter once the freeze is lifted
+        args.Handled = true;
+        component.Target = args.Target;
+        _adminLogger.Add(LogType.Action, LogImpact.Low, $"{ToPrettyString(args.User):player} set target of {ToPrettyString(uid):pinpointer} to {ToPrettyString(component.Target.Value):target}");
+        if (component.UpdateTargetName)
+            component.TargetName = component.Target == null ? null : Identity.Name(component.Target.Value, EntityManager);
+    }
+
+    /// <summary>
+    ///     Set pinpointers target to track
+    /// </summary>
+    public void SetTarget(EntityUid uid, EntityUid? target, PinpointerComponent? pinpointer = null)
+    {
+        if (!Resolve(uid, ref pinpointer))
+            return;
+
+        if (pinpointer.Target == target)
+            return;
+
+        pinpointer.Target = target;
+        if (pinpointer.UpdateTargetName)
+            pinpointer.TargetName = target == null ? null : Identity.Name(target.Value, EntityManager);
+        if (pinpointer.IsActive)
+            UpdateDirectionToTarget(uid, pinpointer);
+    }
+
+    /// <summary>
+    ///     Update direction from pinpointer to selected target (if it was set)
+    /// </summary>
+    protected virtual void UpdateDirectionToTarget(EntityUid uid, PinpointerComponent? pinpointer = null)
+    {
+
+    }
+
+    private void OnExamined(EntityUid uid, PinpointerComponent component, ExaminedEvent args)
+    {
+        if (!args.IsInDetailsRange || component.TargetName == null)
+            return;
+
+        args.PushMarkup(Loc.GetString("examine-pinpointer-linked", ("target", component.TargetName)));
+    }
+
     /// <summary>
     ///     Manually set distance from pinpointer to target
     /// </summary>
@@ -49,4 +119,25 @@ public abstract class SharedPinpointerSystem : EntitySystem
         pinpointer.IsActive = isActive;
         Dirty(pinpointer);
     }
+
+
+    /// <summary>
+    ///     Toggle Pinpointer screen. If it has target it will start tracking it.
+    /// </summary>
+    /// <returns>True if pinpointer was activated, false otherwise</returns>
+    public bool TogglePinpointer(EntityUid uid, PinpointerComponent? pinpointer = null)
+    {
+        if (!Resolve(uid, ref pinpointer))
+            return false;
+
+        var isActive = !pinpointer.IsActive;
+        SetActive(uid, isActive, pinpointer);
+        return isActive;
+    }
+
+    private void OnEmagged(EntityUid uid, PinpointerComponent component, ref GotEmaggedEvent args)
+    {
+        args.Handled = true;
+        component.CanRetarget = true;
+    }
 }