added singularity guidebook entry (#13860)

2023-02-06 21:10:07 +08:00
parent 718d54a48a
commit e3b4f53ae7
13 changed files with 165 additions and 5 deletions
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/PA/control_box.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/PA/control_box.yml
@@ -36,7 +36,10 @@
    - type: Wires
      BoardName: "Mk2 Particle Accelerator"
      LayoutId: ParticleAccelerator
-
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
+      
+      
 # Unfinished

 - type: entity
@@ -55,3 +58,5 @@
      graph: ParticleAcceleratorControlBox
      node: start
      defaultTarget: completed
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/PA/emitter.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/PA/emitter.yml
@@ -22,6 +22,9 @@
    - type: Construction
      graph: ParticleAcceleratorEmitterLeft
      node: completed
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
+

 - type: entity
  parent: ParticleAcceleratorBase
@@ -47,7 +50,9 @@
    - type: Construction
      graph: ParticleAcceleratorEmitterCenter
      node: completed
-
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
+      
 - type: entity
  parent: ParticleAcceleratorBase
  id: ParticleAcceleratorEmitterRight
@@ -72,7 +77,9 @@
    - type: Construction
      graph: ParticleAcceleratorEmitterRight
      node: completed
-
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
+      
 # Unfinished

 - type: entity
@@ -91,6 +98,8 @@
      graph: ParticleAcceleratorEmitterLeft
      node: start
      defaultTarget: completed
+    - type: GuideHelp
+      guides: [ Singularity, Power ]

 - type: entity
  parent: ParticleAcceleratorBase
@@ -108,6 +117,8 @@
      graph: ParticleAcceleratorEmitterCenter
      node: start
      defaultTarget: completed
+    - type: GuideHelp
+      guides: [ Singularity, Power ]

 - type: entity
  parent: ParticleAcceleratorBase
@@ -125,3 +136,5 @@
      graph: ParticleAcceleratorEmitterRight
      node: start
      defaultTarget: completed
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/PA/end_cap.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/PA/end_cap.yml
@@ -11,6 +11,8 @@
    - type: Construction
      graph: ParticleAcceleratorEndCap
      node: completed
+    - type: GuideHelp
+      guides: [ Singularity, Power ]

 # Unfinished

@@ -30,3 +32,5 @@
      graph: ParticleAcceleratorEndCap
      node: start
      defaultTarget: completed
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/PA/fuel_chamber.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/PA/fuel_chamber.yml
@@ -21,7 +21,9 @@
    - type: Construction
      graph: ParticleAcceleratorFuelChamber
      node: completed
-
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
+      
 # Unfinished

 - type: entity
@@ -40,3 +42,5 @@
      graph: ParticleAcceleratorFuelChamber
      node: start
      defaultTarget: completed
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/PA/particles.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/PA/particles.yml
@@ -41,3 +41,5 @@
            Level1: {state: particle1}
            Level2: {state: particle2}
            Level3: {state: particle3}
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/PA/power_box.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/PA/power_box.yml
@@ -29,6 +29,8 @@
    - type: Construction
      graph: ParticleAcceleratorPowerBox
      node: completed
+    - type: GuideHelp
+      guides: [ Singularity, Power ]

 - type: entity
  parent: ParticleAcceleratorBase
@@ -46,3 +48,5 @@
      graph: ParticleAcceleratorPowerBox
      node: start
      defaultTarget: completed
+    - type: GuideHelp
+      guides: [ Singularity, Power ]
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/Singularity/collector.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/Singularity/collector.yml
@@ -54,3 +54,5 @@
  - type: PowerNetworkBattery
    maxSupply: 1000000000
    supplyRampTolerance: 1000000000
+  - type: GuideHelp
+    guides: [ Singularity, Power ]
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/Singularity/containment.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/Singularity/containment.yml
@@ -64,6 +64,9 @@
        connectedLight:
          True: { visible: true }
          False: { visible: false }
+  - type: GuideHelp
+    guides: [ Singularity, Power ]
+

 - type: entity
  id: ContainmentField
@@ -95,3 +98,7 @@
    state: field
  - type: ContainmentField
    throwForce: 50
+  - type: GuideHelp
+    guides: [ Singularity, Power ]
+
+
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/Singularity/emitter.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/Singularity/emitter.yml
@@ -81,3 +81,5 @@
    access: [[ "Engineering" ]]
  - type: Machine
    board: EmitterCircuitboard
+  - type: GuideHelp
+    guides: [ Singularity, Power ]
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/Singularity/generator.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/Singularity/generator.yml
@@ -31,3 +31,6 @@
    noRot: true
  - type: Anchorable
  - type: Pullable
+  - type: GuideHelp
+    guides: [ Singularity, Power ]
+  
--- a/Resources/Prototypes/Entities/Structures/Power/Generation/Singularity/singularity.yml
+++ b/Resources/Prototypes/Entities/Structures/Power/Generation/Singularity/singularity.yml
@@ -47,3 +47,5 @@
  - type: Appearance
    visuals:
    - type: SingularityVisualizer
+  - type: GuideHelp
+    guides: [ Singularity, Power ]
--- a/Resources/Prototypes/Guidebook/engineering.yml
+++ b/Resources/Prototypes/Guidebook/engineering.yml
@@ -36,8 +36,14 @@
  text: "/Server Info/Guidebook/Power.xml"
  children:
  - AME
-
+  - Singularity
+  
 - type: guideEntry
  id: AME
  name: guide-entry-ame
  text: "/Server Info/Guidebook/AME.xml"
+  
+- type: guideEntry
+  id: Singularity
+  name: Singularity
+  text: "/Server Info/Guidebook/Singularity.xml"
--- a/Info/Guidebook/Singularity.xml
+++ b/Info/Guidebook/Singularity.xml
@@ -0,0 +1,106 @@
+<Document>
+# Gravitational Singularity Engine
+
+The Gravitational Singularity Engine can yield infinite power, with no fueling required. It can also destroy the whole station with equal ease. It uses a Particle Accelerator to fire high energy particles at a Singularity Generator to form a singularity. The singularity then pulses radiation which is absorbed by Radiation Collectors.
+
+## Setting it up
+
+The Gravitational Singularity Engine requires 4 subsystems to work properly:
+
+## Gravitational singularity generator
+<Box>
+<GuideEntityEmbed Entity="SingularityGenerator"/>
+</Box>
+The generator should be anchored at the center of the containment area since this is where the singularity will appear at.
+
+## Containment field generators and emitters
+<Box>
+<GuideEntityEmbed Entity="Emitter"/>
+<GuideEntityEmbed Entity="ContainmentFieldGenerator"/>
+<GuideEntityEmbed Entity="ContainmentField"/>
+</Box>
+The emitters connect to MV cables and fire lasers as long as they have power and are turned on.
+Fire emitters at containment field generators to activate them.
+If two containment field generators are active, in range and in the same cardinal axis, a containment field will appear.
+The containment field will repell the singularity, keeping it from escaping, and yield a little bit of power every time anything bounces off of them. 
+Emitter lasers and containment field can cause damage, avoid touching them when active.
+
+## Radition collectors
+<Box>
+<GuideEntityEmbed Entity="RadiationCollector"/>
+</Box>
+They connect to HV cables and generate power from nearby radiation sources when turned on.
+
+## Particle accelerator
+
+<Box>
+<GuideEntityEmbed Entity="ParticleAcceleratorEndCap"/>
+</Box>
+
+<Box>
+<GuideEntityEmbed Entity="ParticleAcceleratorControlBox" Caption="PA computer"/>
+<GuideEntityEmbed Entity="ParticleAcceleratorFuelChamber"/>
+<GuideEntityEmbed Entity="CableHV"/>
+</Box>
+
+<Box>
+<GuideEntityEmbed Entity="ParticleAcceleratorPowerBox"/>
+</Box>
+
+<Box>
+<GuideEntityEmbed Entity="ParticleAcceleratorEmitterLeft" Caption="Emitter L"/>
+<GuideEntityEmbed Entity="ParticleAcceleratorEmitterCenter" Caption="Emitter C"/>
+<GuideEntityEmbed Entity="ParticleAcceleratorEmitterRight" Caption="Emitter R"/>
+</Box>
+
+The Particle Accelerator (PA) is a multi-tile structure that launches acclerated particles from its emitters. Its emitters should always face the gravitational singularity generator.
+Some stations already have an unfinished PA. To complete, first ensure there is HV cable beneath the PA power box, anchor all parts, then add LV cable to each part.
+<Box>
+<GuideEntityEmbed Entity="CableApcStack"/>
+</Box>
+Then use a screwdriver to screw back the panels.
+Scan parts using the PA control computer to check if it's operational. If it shows up as incomplete, examine for what's missing.
+<Box>
+<GuideEntityEmbed Entity="ParticleAcceleratorControlBox"/>
+</Box>
+
+## Turing on the Gravitational Singularity Engine
+
+[color=#a4885c]Do not[/color] turn the PA on unless all other subsystems are working properly.
+
+Turn power on using the PA control computer. Set strength to an appropiate level.
+The higher the output stength is set on PA control computer, the bigger the singularity will be.
+
+The PA will now draw power from the power net and start firing particles at the Gravitational singularity generator. 
+
+<Box>
+<GuideEntityEmbed Entity="ParticlesProjectile" Caption=""/>
+<GuideEntityEmbed Entity="ParticlesProjectile"/>
+<GuideEntityEmbed Entity="ParticlesProjectile" Caption=""/>
+</Box>
+
+A singularity will soon appear at the position of the Gravitational singularity generator.
+<Box>
+<GuideEntityEmbed Entity="Singularity"/>
+</Box>
+
+If no particle is hitting the singularity generator, the singularity will start to slowly decay until it disappear.
+
+## Safety
+Singularity emits radiation around it, so always keep a distance. Consider getting radiation shielding gear beforehand. Seek medical attention if experiencing health issues.
+
+<Box>
+<GuideEntityEmbed Entity="ClothingOuterHardsuitEngineering"/>
+</Box>
+
+<Box>
+<GuideEntityEmbed Entity="ClosetRadiationSuit"/>
+<GuideEntityEmbed Entity="ClothingOuterSuitRad"/>
+<GuideEntityEmbed Entity="GeigerCounter"/>
+</Box>
+
+A singularity might move around, but the containment field will repel it.
+If a singularity escapes its containment field, often referred to as a "singuloose," it will attract and then consume everything in its way.
+
+In such circumstances, there is little to be done other than running in the opposite direction.
+</Document>