anomaly guidebook entries (#13567)

Closes https://github.com/space-wizards/space-station-14/issues/13542

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

@@ -5,9 +5,13 @@ guide-entry-fires = Fires & Space
 guide-entry-shuttle-craft = Shuttle-craft
 guide-entry-power = Power
 guide-entry-ame = Antimatter Engine (AME)
-guide-entry-science = Science
-guide-entry-machine-upgrading = Machine Upgrading
 guide-entry-controls = Controls
 guide-entry-jobs = Jobs
 guide-entry-survival = Survival
 guide-entry-ss14 = Space Station 14
+
+guide-entry-science = Science
+guide-entry-anomalous-research = Anomalous Research
+guide-entry-scanners-and-vessels = Scanners and Vessels
+guide-entry-ape = A.P.E.
+guide-entry-machine-upgrading = Machine Upgrading

Resources/Prototypes/Entities/Objects/Specific/Research/anomaly.yml

@@ -17,3 +17,6 @@
       - key: enum.AnomalyScannerUiKey.Key
         type: AnomalyScannerBoundUserInterface
   - type: AnomalyScanner
+  - type: GuideHelp
+    guides:
+    - ScannersAndVessels

Resources/Prototypes/Entities/Structures/Machines/anomaly_equipment.yml

@@ -76,6 +76,9 @@
         sound:
           path: /Audio/Effects/metalbreak.ogg
       - !type:ExplodeBehavior
+  - type: GuideHelp
+    guides:
+    - ScannersAndVessels
 
 - type: entity
   id: MachineAPE
@@ -135,6 +138,9 @@
     baseFireBurstDelayMax: 6
   - type: ApcPowerReceiver
     powerLoad: 100
+  - type: GuideHelp
+    guides:
+    - APE
   - type: Gun
     fireRate: 10 #just has to be fast enough to keep up with upgrades
     showExamineText: false
@@ -240,3 +246,6 @@
   - type: WiresVisuals
   - type: StaticPrice
     price: 5000
+  - type: GuideHelp
+    guides:
+    - AnomalousResearch

Resources/Prototypes/Entities/Structures/Specific/anomalies.yml

@@ -38,6 +38,9 @@
     damageContainer: Inorganic
     damageModifierSet: Metallic
   - type: Appearance
+  - type: GuideHelp
+    guides:
+    - AnomalousResearch
   - type: EmitSoundOnSpawn
     sound: 
       path: /Audio/Effects/teleport_arrival.ogg

Resources/Prototypes/Guidebook/science.yml

@@ -1,11 +1,30 @@
 - type: guideEntry
   id: Science
   name: guide-entry-science
-  text: "/Server Info/Guidebook/Science.xml"
+  text: "/Server Info/Guidebook/Science/Science.xml"
   children:
+  - AnomalousResearch
   - MachineUpgrading
 
+- type: guideEntry
+  id: AnomalousResearch
+  name: guide-entry-anomalous-research
+  text: "/Server Info/Guidebook/Science/AnomalousResearch.xml"
+  children:
+  - APE
+  - ScannersAndVessels
+
+- type: guideEntry
+  id: ScannersAndVessels
+  name: guide-entry-scanners-and-vessels
+  text: "/Server Info/Guidebook/Science/ScannersAndVessels.xml"
+
+- type: guideEntry
+  id: APE
+  name: guide-entry-ape
+  text: "/Server Info/Guidebook/Science/APE.xml"
+
 - type: guideEntry
   id: MachineUpgrading
   name: guide-entry-machine-upgrading
-  text: "/Server Info/Guidebook/MachineUpgrading.xml"
+  text: "/Server Info/Guidebook/Science/MachineUpgrading.xml"

Resources/Server Info/Guidebook/Science/APE.xml

@@ -0,0 +1,20 @@
+<Document>
+# A.P.E.
+
+The Anomalous Particle Emitter is a machine used to interface with anomalies. It is the primary way of manipulating the stats of an anomaly.
+
+<Box>
+<GuideEntityEmbed Entity="MachineAPE"/>
+</Box>
+
+The A.P.E. can shoot three different kinds of anomalous particles: Delta, Epsilon, and Zeta. Each particle types has certain effects:
+
+- [color=#a4885c]Danger:[/color] Increases the severity of an anomaly.
+- [color=#a4885c]Unstable:[/color] Increases the instability of an anomaly.
+- [color=#a4885c]Containment:[/color] Increases the stability at the cost of health.
+
+Which particle type corresponds to each effect is unique and can be learned by scanning the anomaly.
+
+The A.P.E. can also be locked by anyone with science access, which prevents it from being deconstructed, turned on or off, or having the particle type switched.
+
+</Document>

Resources/Server Info/Guidebook/Science/AnomalousResearch.xml

@@ -0,0 +1,41 @@
+<Document>
+# Anomalous Research
+
+Anomalous Research is a subdepartment of Science focused around the containment and manipulation of various unique anomalies.
+
+## Equipment
+<Box>
+<GuideEntityEmbed Entity="AnomalyScanner"/>
+<GuideEntityEmbed Entity="MachineAnomalyVessel"/>
+<GuideEntityEmbed Entity="MachineAPE"/>
+</Box>
+
+Scanners, vessels, and A.P.E.s are all used in the containment and observation of anomalies.
+
+<Box>
+<GuideEntityEmbed Entity="MachineAnomalyGenerator"/>
+</Box>
+
+The anomaly generator can produce a random anomaly somewhere on the station at the cost of plasma.
+
+## Anomalies
+Anomalies are static objects that appear on the station. They cannot be moved, and must be worked around, no matter their location.
+
+<Box>
+<GuideEntityEmbed Entity="AnomalyPyroclastic"/>
+</Box>
+
+Each anomaly has three main stats, two of which can be seen in anomaly scans:
+
+- [color=#a4885c]Severity:[/color] This is a numerical value corresponding to the danger of an anomaly.
+- [color=#a4885c]Stability:[/color] Shown as either decaying, stable, or growing; this is how frequently and widespread the effects will be.
+- [color=#a4885c]Health:[/color] Health is a hidden stat. It decreases when you use [color=#a4885c]containment particles[/color] on an anomaly. If you use too many, the anomaly will disappear.
+
+## Pulses and Supercritical Events
+The most dangerous effects of anomalies are seen during [color=#a4885c]pulses[/color] and [color=#a4885c]supercritical events[/color].
+
+Pulses are semi-regular bursts of anomalous effects. They're moderately dangerous, scaling with both the severity and stability of an anomaly.
+
+Supercritical events are only seen if an anomaly reaches 100% severity. If this happens, the anomaly will swell before disappearing into a catastrophic event. These should be avoided at all costs!
+
+</Document>

Resources/Server Info/Guidebook/Science/ScannersAndVessels.xml

@@ -0,0 +1,24 @@
+<Document>
+## Anomaly Scanner
+
+The Anomaly Scanner is used to gather various information on anomalies. They can be found inside of the lockers in the science department.
+
+<Box>
+<GuideEntityEmbed Entity="AnomalyScanner"/>
+</Box>
+
+Scanning an anomaly shows the severity, general stability, approximate point output, reactions with particle types, and time until the next pulse. The reaction types, specifically, can be used in conjunction with the A.P.E. to manipulate anomalies.
+
+## Anomaly Vessel
+
+The anomaly vessel is a machine that generates points from anomalies. Use the anomaly scanner on an empty vessel, and the anomaly that was last scanned will be synced with the vessel.
+
+<Box>
+<GuideEntityEmbed Entity="MachineAnomalyVessel"/>
+</Box>
+
+The amount of points a vessel generates per second is based on the severity, stability, and health of an anomaly. The higher each of these values, the higher the point output will be.
+
+Be careful: if an anomaly goes [color=#a4885c]supercritical[/color], the vessel it is linked to will explode. This may damage the station and nearby equipment.
+
+</Document>