Examine Groups (#12400)

* new version

* testy2

* working version

* new GroupExamineSystem

* restructure

* restructure again

* update icon

* adding group examine to prototypes

* change examine group title to a localized string

Co-authored-by: CommieFlowers <rasmus.cedergren@hotmail.com>

Content.Shared/Examine/GroupExamineComponent.cs

@@ -0,0 +1,103 @@
+using Robust.Shared.Serialization;
+using Robust.Shared.Utility;
+
+namespace Content.Shared.Examine
+{
+    /// <summary>
+    ///     This component groups examine messages together
+    /// </summary>
+    [RegisterComponent]
+    public sealed class GroupExamineComponent : Component
+    {
+        /// <summary>
+        ///     A list of ExamineGroups.
+        /// </summary>
+        [DataField("group")]
+        public List<ExamineGroup> ExamineGroups = new()
+        {
+            new ExamineGroup()
+            {
+                Components = new()
+                {
+                    "Armor",
+                    "ClothingSpeedModifier",
+                },
+            },
+        };
+    }
+
+    [DataDefinition]
+    public sealed class ExamineGroup
+    {
+        /// <summary>
+        ///     The title of the Examine Group, the .
+        /// </summary>
+        [DataField("title")]
+        [ViewVariables(VVAccess.ReadWrite)]
+        public string? Title;
+
+        /// <summary>
+        ///     A list of ExamineEntries, containing which component it belongs to, which priority it has, and what FormattedMessage it holds.
+        /// </summary>
+        [DataField("entries")]
+        public List<ExamineEntry> Entries = new();
+
+        /// <summary>
+        ///     A list of all components this ExamineGroup encompasses.
+        /// </summary>
+        [DataField("components")]
+        public List<string> Components = new();
+
+        /// <summary>
+        ///     The icon path for the Examine Group.
+        /// </summary>
+        [DataField("icon")]
+        public string Icon = "/Textures/Interface/examine-star.png";
+
+        /// <summary>
+        ///     The text shown in the context verb menu.
+        /// </summary>
+        [DataField("contextText")]
+        public string ContextText = string.Empty;
+
+        /// <summary>
+        ///     Details shown when hovering over the button.
+        /// </summary>
+        [DataField("hoverMessage")]
+        public string HoverMessage = string.Empty;
+    }
+
+    /// <summary>
+    ///     An entry used when showing examine details
+    /// </summary>
+    [Serializable, NetSerializable]
+    public sealed class ExamineEntry
+    {
+        /// <summary>
+        ///     Which component does this entry relate to?
+        /// </summary>
+        [DataField("component")]
+        public string ComponentName = string.Empty;
+
+        /// <summary>
+        ///     What priority has this entry - entries are sorted high to low.
+        /// </summary>
+        [DataField("priority")]
+        public float Priority = 0f;
+
+        /// <summary>
+        ///     The FormattedMessage of this entry.
+        /// </summary>
+        [DataField("message")]
+        public FormattedMessage Message = new();
+
+        /// <param name="componentName">Should be set to _componentFactory.GetComponentName(component.GetType()) to properly function.</param>
+        public ExamineEntry(string componentName, float priority, FormattedMessage message)
+        {
+            ComponentName = componentName;
+            Priority = priority;
+            Message = message;
+        }
+    }
+
+}