Adds dough to the cookbook + Functionality for listing chemical reactions as recipes. (#5354)

## Short description
<!-- What do you propose to change with your PR? -->
Adds recipes for various doughs to the guidebook. Creates the
`guidebookGroups` method which allows for any chemical reaction to be
formatted as a guidebook entry in the same style of every other food
recipe.

## Why we need to add this
<!-- What is the reason for adding these changes? Please post links to
Discussions as well as Bug Reports here. Please describe how this will
change the game balance. -->
Extremely confusing for new players, suggested a number of times on
discord (which you can find
[here](https://discord.com/channels/1272545509562777621/1445184954098258034),[
here](https://discord.com/channels/1272545509562777621/1530129438094921808),
and
[here.](https://discord.com/channels/1272545509562777621/1501260930791641138))
The cookbook previously couldn't recognize any recipes that don't use a
microwave, oven, stove, or deep fryer. This is necessary guidance for
new players and a crucial part of cooking practically any dish. This
aligns with the general philosophy of providing all necessary
information by means accessible within the game, and avoids players
having to turn to external websites or wikis to get simple recipes.

If new dough/cooking chemical reactions are added in the future this
works the same way as all the actual food recipes. Just tag the reaction
using `guidebookGroups`.

Documenting how to make things like condiments purely through chemical
reactions is something that's made possible in this PR, and should
probably be added to the guidebook but I'll save that for another day.

## Media (Video/Screenshots)
<!--
If your PR contains in-game changes you must provide screenshots/videos
of the changes.
-->
<img width="889" height="705" alt="image"
src="https://github.com/user-attachments/assets/b41a25a1-44e9-40bb-83cd-0b9d54833369"
/>
fig 1. yup that's all it does.

## Checks
<!-- check boxes for faster reviewing of your PR -->

- [x] I do not require assistance to complete the PR.
- [x] Before posting/requesting review of a PR, I have verified that the
changes work.
- [x] I have added screenshots/videos of the changes, or this PR does
not change in-game mechanics.
- [x] I affirm that my changes are licensed under the [MIT
License](https://github.com/ss14Starlight/space-station-14/blob/Starlight/LICENSE.TXT)
and grant permission for use in this repository under its conditions.

**Changelog**
<!--
If you want the players to know about changes made in this PR, specify
them using the template outside the comment. Short and informative.
-->
:cl: bynddark8, Rinary1
- add: Introduces recipes for doughs and cake batter to the in game
guidebook.
- add: Introduces a method to document chemical reactions in the
guidebook as cooking recipes.

---------

Co-authored-by: Rinary <rinary.super@gmail.com>

Author: bynddark8

Content.Client/Guidebook/Controls/GuideMicrowaveEmbed.xaml.cs

@@ -3,7 +3,9 @@
 using Content.Client.Guidebook.Richtext;
 using Content.Client.Message;
 using Content.Client.UserInterface.ControlExtensions;
+using Content.Shared.Chemistry.Reaction;
 using Content.Shared.Chemistry.Reagent;
+using Content.Shared.EntityEffects.Effects.EntitySpawning;
 using Content.Shared.Kitchen;
 using JetBrains.Annotations;
 using Robust.Client.AutoGenerated;
@@ -197,4 +199,107 @@ private void GenerateControl(FoodRecipePrototype recipe)
         GenerateCookTime(recipe);
         GenerateDeviceType(recipe);
     }
+
+    #region Starlight
+
+    public GuideMicrowaveEmbed(ReactionPrototype reaction) : this() => GenerateControl(reaction);
+
+    private void GenerateHeader(ReactionPrototype reaction)
+    {
+        if (TryGetPrimaryReactionResultEntity(reaction, out var resultEntity, out var amount))
+        {
+            RepresentedPrototype = resultEntity;
+            IconContainer.AddChild(new GuideEntityEmbed(resultEntity.ID, false, false));
+
+            var escapedResultName = FormattedMessage.EscapeText(resultEntity.Name);
+            ResultName.SetMarkup($"[bold]{escapedResultName}[/bold] x {amount}");
+            ResultDescription.SetMarkup(FormattedMessage.EscapeText(resultEntity.Description));
+            return;
+        }
+
+        ResultName.SetMarkup(FormattedMessage.EscapeText(reaction.ID));
+        ResultDescription.SetMarkup(string.Empty);
+    }
+
+    private bool TryGetPrimaryReactionResultEntity(ReactionPrototype reaction, out EntityPrototype resultEntity, out int amount)
+    {
+        foreach (var effect in reaction.Effects)
+        {
+            if (effect is not SpawnEntity spawn)
+                continue;
+
+            resultEntity = _prototype.Index<EntityPrototype>(spawn.Entity);
+            amount = Math.Max(1, spawn.Number);
+            return true;
+        }
+
+        resultEntity = default!;
+        amount = 0;
+        return false;
+    }
+
+    private void GenerateReactionIngredients(ReactionPrototype reaction)
+    {
+        foreach (var (reagentId, reactant) in reaction.Reactants.OrderByDescending(p => p.Value.Amount))
+        {
+            var reagent = _prototype.Index<ReagentPrototype>(reagentId);
+
+            var liquidColorMsg = new FormattedMessage();
+            liquidColorMsg.AddMarkupOrThrow(Loc.GetString("guidebook-microwave-reagent-color-display", ("color", reagent.SubstanceColor)));
+            liquidColorMsg.Pop();
+
+            var liquidColorLabel = new GuidebookRichPrototypeLink();
+            liquidColorLabel.SetMessage(liquidColorMsg);
+            liquidColorLabel.HorizontalAlignment = Control.HAlignment.Center;
+            liquidColorLabel.LinkedPrototype = reagent;
+            IngredientsGrid.AddChild(liquidColorLabel);
+
+            var liquidNameMsg = new FormattedMessage();
+            liquidNameMsg.AddMarkupOrThrow("[bold]");
+            liquidNameMsg.AddText(reagent.LocalizedName);
+            liquidNameMsg.AddMarkupOrThrow("[/bold]");
+            if (reactant.Catalyst)
+            {
+                liquidNameMsg.AddText(" ");
+                liquidNameMsg.AddText(Loc.GetString("guidebook-microwave-reagent-catalyst-label"));
+            }
+
+            var liquidNameLabel = new RichTextLabel();
+            liquidNameLabel.SetMessage(liquidNameMsg);
+            IngredientsGrid.AddChild(liquidNameLabel);
+
+            var liquidQuantityMsg = new FormattedMessage();
+            liquidQuantityMsg.AddMarkupOrThrow(Loc.GetString("guidebook-microwave-reagent-quantity-display", ("amount", reactant.Amount)));
+            liquidQuantityMsg.Pop();
+
+            var liquidQuantityLabel = new RichTextLabel();
+            liquidQuantityLabel.SetMessage(liquidQuantityMsg);
+            IngredientsGrid.AddChild(liquidQuantityLabel);
+        }
+    }
+
+    private void GenerateReactionCookTime()
+    {
+        var msg = new FormattedMessage();
+        msg.AddMarkupOrThrow(Loc.GetString("guidebook-microwave-cook-time", ("time", 0)));
+        msg.Pop();
+        CookTimeLabel.SetMessage(msg);
+    }
+
+    private void GenerateReactionDeviceType()
+    {
+        var msg = new FormattedMessage();
+        msg.AddMarkupOrThrow(Loc.GetString("guidebook-microwave-device-type", ("type", "Chemistry")));
+        msg.Pop();
+        DeviceTypeLabel.SetMessage(msg);
+    }
+
+    private void GenerateControl(ReactionPrototype reaction)
+    {
+        GenerateHeader(reaction);
+        GenerateReactionIngredients(reaction);
+        GenerateReactionCookTime();
+        GenerateReactionDeviceType();
+    }
+    #endregion
 }

Content.Client/Guidebook/Controls/GuideMicrowaveGroupEmbed.cs

@@ -1,6 +1,7 @@
 using System.Diagnostics.CodeAnalysis;
 using System.Linq;
 using Content.Client.Guidebook.Richtext;
+using Content.Shared.Chemistry.Reaction;
 using Content.Shared.Kitchen;
 using JetBrains.Annotations;
 using Robust.Client.UserInterface.Controls;
@@ -59,5 +60,16 @@ private void CreateEntries(string group)
             var embed = new GuideMicrowaveEmbed(recipe);
             AddChild(embed);
         }
-    }
+        //startlight start
+
+        var reactions = _prototype.EnumeratePrototypes<ReactionPrototype>()
+            .Where(r => r.InGuidebookGroup(group))
+            .OrderBy(r => r.ID);
+
+        foreach (var reaction in reactions)
+        {
+            AddChild(new GuideMicrowaveEmbed(reaction));
+        }
+        // starlight end
+}
 }

Content.Shared/_Starlight/Chemistry/Reaction/ReactionPrototype.Starlight.cs

@@ -0,0 +1,27 @@
+using Robust.Shared.Serialization;
+
+// ReSharper disable once CheckNamespace
+namespace Content.Shared.Chemistry.Reaction;
+
+public sealed partial class ReactionPrototype
+{
+    [DataField]
+    public string? GuidebookGroup;
+
+    [DataField]
+    public List<string> GuidebookGroups = [];
+
+    public bool InGuidebookGroup(string group)
+    {
+        if (string.Equals(GuidebookGroup, group, StringComparison.OrdinalIgnoreCase))
+            return true;
+
+        foreach (var guidebookGroup in GuidebookGroups)
+        {
+            if (string.Equals(guidebookGroup, group, StringComparison.OrdinalIgnoreCase))
+                return true;
+        }
+
+        return false;
+    }
+}

Resources/Locale/en-US/_Starlight/guidebook/cooking.ftl

@@ -0,0 +1 @@
+guidebook-microwave-reagent-catalyst-label = (catalyst)

Resources/Locale/en-US/_Starlight/guidebook/guides.ftl

@@ -169,6 +169,7 @@ guide-entry-terror-spiders = Terror Spiders
 guide-entry-devil = Devil
 
 guide-entry-sl-deepfried-recipes = Deep Fried
+guide-entry-sl-dough-recipes = Dough
 guide-entry-sl-ice-cream-recipes = Ice Cream Maker
 
 # Plumbing guides

Resources/Prototypes/Guidebook/references.yml

@@ -25,6 +25,7 @@
   - PizzaRecipes
   - SavoryRecipes
   - BreadRecipes
+  - DoughRecipes # Starlight-edit
   - BreakfastRecipes
   - MothRecipes
   - PastaRecipes

Resources/Prototypes/Recipes/Reactions/food.yml

@@ -30,6 +30,8 @@
 
 - type: reaction
   id: CreateDough
+  guidebookGroups: # Starlight-edit
+    - Dough
   impact: Low
   quantized: true
   conserveEnergy: false
@@ -44,6 +46,8 @@
 
 - type: reaction
   id: CreateCornmealDough
+  guidebookGroups: # Starlight-edit
+    - Dough
   impact: Low
   quantized: true
   conserveEnergy: false
@@ -60,6 +64,8 @@
 
 - type: reaction
   id: CreateTortillaDough
+  guidebookGroups: # Starlight-edit
+    - Dough
   impact: Low
   quantized: true
   conserveEnergy: false
@@ -74,6 +80,9 @@
 
 - type: reaction
   id: CreateDoughCotton
+  guidebookGroups: # Starlight-edit
+    - Dough
+    - Moth
   impact: Low
   quantized: true
   conserveEnergy: false
@@ -90,6 +99,9 @@
 
 - type: reaction
   id: CreateCakeBatter
+  guidebookGroups: # Starlight-edit
+    - Dough
+    - Cake
   impact: Low
   quantized: true
   conserveEnergy: false
@@ -123,6 +135,9 @@
 
 - type: reaction
   id: CreatePieDough
+  guidebookGroups: # Starlight-edit
+    - Dough
+    - Pie
   impact: Low
   quantized: true
   conserveEnergy: false

Resources/Prototypes/_Starlight/Guidebook/references.yml

@@ -9,3 +9,9 @@
   name: guide-entry-sl-ice-cream-recipes
   text: "/ServerInfo/_Starlight/Guidebook/Service/IceCreamMakerRecipes.xml"
   filterEnabled: True
+
+- type: guideEntry
+  id: DoughRecipes # Starlight-add
+  name: guide-entry-sl-dough-recipes
+  text: "/ServerInfo/_Starlight/Guidebook/Service/DoughRecipes.xml"
+  filterEnabled: True

Resources/Prototypes/_Starlight/Recipes/reactions.yml

@@ -1,5 +1,11 @@
 - type: reaction
   id: CreateMothBatter
+  # Starlight-start
+  guidebookGroups:
+    - Dough
+    - Moth
+    - Cake
+  # Starlight-end
   impact: Low
   quantized: true
   conserveEnergy: false

Resources/ServerInfo/Guidebook/Service/FoodRecipes.xml

@@ -41,6 +41,9 @@ This is the latest published version of NanoTrasen Central Command Kitchen de Cu
 <GuideMicrowaveGroupEmbed Group="Salad"/>
 
 <!-- Starlight start -->
+## Dough
+<GuideMicrowaveGroupEmbed Group="Dough"/>
+
 ## Deep Fried
 <GuideDeepFryerGroupEmbed Group="TP14-Deep-Fry"/>