Multiple items in loadouts (#33193)

* loadouts update

* Update loadout_groups.yml

* darts to candles

* Update Resources/Prototypes/Loadouts/dummy_entities.yml

---------

Co-authored-by: slarticodefast <161409025+slarticodefast@users.noreply.github.com>

Content.Client/Lobby/UI/Loadouts/LoadoutContainer.xaml.cs

@@ -36,19 +36,20 @@ public sealed partial class LoadoutContainer : BoxContainer
 
         if (_protoManager.TryIndex(proto, out var loadProto))
         {
-            var ent = _entManager.System<LoadoutSystem>().GetFirstOrNull(loadProto);
+            var ent = loadProto.DummyEntity ?? _entManager.System<LoadoutSystem>().GetFirstOrNull(loadProto);
+
+            if (ent == null)
+                return;
 
-            if (ent != null)
-            {
             _entity = _entManager.SpawnEntity(ent, MapCoordinates.Nullspace);
             Sprite.SetEntity(_entity);
 
             var spriteTooltip = new Tooltip();
             spriteTooltip.SetMessage(FormattedMessage.FromUnformatted(_entManager.GetComponent<MetaDataComponent>(_entity.Value).EntityDescription));
+
             TooltipSupplier = _ => spriteTooltip;
         }
     }
-    }
 
     protected override void Dispose(bool disposing)
     {

Content.Shared/Clothing/LoadoutSystem.cs

@@ -90,6 +90,9 @@ public sealed class LoadoutSystem : EntitySystem
 
     public string GetName(LoadoutPrototype loadout)
     {
+        if (loadout.DummyEntity is not null && _protoMan.TryIndex<EntityPrototype>(loadout.DummyEntity, out var proto))
+            return proto.Name;
+
         if (_protoMan.TryIndex(loadout.StartingGear, out var gear))
         {
             return GetName(gear);

Content.Shared/Preferences/Loadouts/LoadoutPrototype.cs

@@ -17,6 +17,12 @@ public sealed partial class LoadoutPrototype : IPrototype, IEquipmentLoadout
      * You can either use an existing StartingGearPrototype or specify it inline to avoid bloating yaml.
      */
 
+    /// <summary>
+    /// An entity whose sprite, name and description is used for display in the interface. If null, tries to get the proto of the item from gear (if it is a single item).
+    /// </summary>
+    [DataField]
+    public EntProtoId? DummyEntity;
+
     [DataField]
     public ProtoId<StartingGearPrototype>? StartingGear;
 

Resources/Prototypes/Loadouts/Miscellaneous/trinkets.yml

@@ -28,7 +28,7 @@
     back:
     - ClothingNeckHeadphones
 
-# Plushies
+# Toys
 - type: loadout
   id: PlushieLizard
   storage:
@@ -41,6 +41,15 @@
     back:
     - PlushieSpaceLizard
 
+- type: loadout
+  id: ThreeCandles
+  dummyEntity: LoadoutDummyCandles
+  storage:
+    back:
+    - CandleRed
+    - CandleBlue
+    - CandleGreenSmall
+
 # Smokeables
 - type: loadout
   id: Lighter

Resources/Prototypes/Loadouts/dummy_entities.yml

@@ -0,0 +1,9 @@
+- type: entity
+  id: LoadoutDummyCandles
+  categories: [ HideSpawnMenu ]
+  name: three candles
+  description: A set of three colorful candles for secret rituals!
+  components:
+  - type: Sprite
+    sprite: Objects/Misc/candles.rsi
+    state: loadout

Resources/Prototypes/Loadouts/loadout_groups.yml

@@ -10,6 +10,7 @@
   - Headphones
   - PlushieLizard
   - PlushieSpaceLizard
+  - ThreeCandles
   - Lighter
   - CigPackGreen
   - CigPackRed

Resources/Textures/Objects/Misc/candles.rsi/meta.json

@@ -10,6 +10,9 @@
     {
       "name": "stand-small"
     },
+    {
+      "name": "loadout"
+    },
     {
       "name": "stand-big"
     },