Guidebook Updates for the Amateur Spessman (#28603)

* Created NewPlayer.xml

* Created NewPlayer.yml and added it to guides.ftl

* shifted some controls from Space Station 14 to New? Start here!, as well as made a character creation xml to be written later

* switched some stuff between the New? entry and the Space Station 14 entry

* Made everything so nice!!!!!!!!!!!!!!

* fixed formatting inconsistencies

* added a How to use this guidebook section

* build correction and guidebook clarification for other servers

* wrote character creation ig probs fo shizzle

* added new terms to the glossary and alphabetized it

* meh this seems important enough to add

* okay no more shitsec bad idea

* I HATED Roleplaying.xml ANYWAY!!!

* I REALLY REALLY HATED IT ACTUALLYLLL

* Moved Controls and Radio into newplayer.yml, making meta.yml and radio.yml obsolete

* Separated the character creation bits that are just cosmetic from the ones that matter

* also put all the related new player xml files in their own folder

* expanded Radio.xml, kinda fixed survival.xml

* removed the line that mighta maybe sorta possibly could encourage self antag

* thought about this randomly but ICK OCK

* talking is no longer a key part of this game

* moves stuff around, a lot of stuff. basically moves everything but the jobs themselves around

* ah probably should make sure this works first also me when i lie on the internet

* don't be such a grammar nukie

Co-authored-by: Tayrtahn <[email protected]>

* okay nevermind that's justified

Co-authored-by: Tayrtahn <[email protected]>

* prepare. it is coming. the great reorganization...

* yesyes that's all well and goo- THE REORG IS COMING. THE REORG IS COMING. WAKE UP.

* rename that real quick

* step one begins. first, consolidate existing service entries into their own yaml. this makes botany.yml obsolete.

* update shiftandcrew.yml to only have departments as children also fuck it alphabetization

* consolidated salvage into cargo

* made a new entry for command

* gave salvage a home and service an existence

* made some XML files to be filled out later

* quick rename...

* took some stuff from Intro.txt and i think Gameplay.txt and put it in NewPlayer.xml

* The Great Writing about Departments (25XX, black and white)

* added a bunch of links everywhere

* biochemical is no longer a thing

* service formatinaaaaaaa

* shiny...,,,,,,,,, colo(u)rz..,,,,,,,,,,,,,

* let's get that fixed

* second time i made a typo there as well

* we hate fun around here

* grammar?!???/

* various fixes and more linkings

* oops

* wewlad lol!!

---------

Co-authored-by: Tayrtahn <[email protected]>
Co-authored-by: AJCM <[email protected]>

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

@@ -20,3 +20,5 @@ guide-entry-alert-levels = Alert Levels
 guide-entry-justice = Justice
 
 guide-entry-glimmer-creatures = Glimmer Creatures
+
+guide-entry-trade-station = Trade Station

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

@@ -1,10 +1,10 @@
 guidebook-window-title = Guidebook
 guidebook-placeholder-text = Select an entry.
-guidebook-placeholder-text-2 = If you're new, select the topmost entry to get started.
+guidebook-placeholder-text-2 = If you're new, head over to "New? Start here!"
 guidebook-filter-placeholder-text = Filter items
 
 guidebook-parser-error = Parser Error
 guidebook-error-message = Error Message
 
 guidebook-monkey-unspin = Unspin Monkey
-guidebook-monkey-disco = Disco Monkey
+guidebook-monkey-disco = Disco Monkey

Resources/Prototypes/DeltaV/Guidebook/logistics.yml

@@ -0,0 +1,4 @@
+- type: guideEntry
+  id: TradeStation
+  name: guide-entry-trade-station
+  text: "/ServerInfo/Guidebook/DeltaV/Logistics/TradeStation.xml"

Resources/Prototypes/Guidebook/cargo.yml

@@ -4,8 +4,15 @@
   text: "/ServerInfo/Guidebook/Cargo/Cargo.xml"
   children:
   - CargoBounties
+  - Salvage
+  - TradeStation # DeltaV
 
 - type: guideEntry
   id: CargoBounties
   name: guide-entry-cargo-bounties
   text: "/ServerInfo/Guidebook/Cargo/CargoBounties.xml"
+
+- type: guideEntry
+  id: Salvage
+  name: guide-entry-salvage
+  text: "/ServerInfo/Guidebook/Cargo/Salvage.xml"

Resources/Prototypes/Guidebook/command.yml

@@ -0,0 +1,4 @@
+- type: guideEntry
+  id: Command
+  name: guide-entry-command
+  text: "/ServerInfo/Guidebook/Command.xml"

Resources/Prototypes/Guidebook/newplayer.yml

@@ -0,0 +1,32 @@
+- type: guideEntry
+  id: NewPlayer
+  name: guide-entry-newplayer
+  text: "/ServerInfo/Guidebook/NewPlayer/NewPlayer.xml"
+  children:
+  - Controls
+  - CharacterCreation
+
+- type: guideEntry
+  id: Controls
+  name: guide-entry-controls
+  text: "/ServerInfo/Guidebook/NewPlayer/Controls/Controls.xml"
+  children:
+  - Radio
+
+- type: guideEntry
+  id: Radio
+  name: guide-entry-radio
+  text: "/ServerInfo/Guidebook/NewPlayer/Controls/Radio.xml" 
+
+- type: guideEntry
+  id: CharacterCreation
+  name: guide-entry-charactercreation
+  text: "/ServerInfo/Guidebook/NewPlayer/CharacterCreation.xml"
+  children:
+  - YourFirstCharacter
+  - Species 
+
+- type: guideEntry
+  id: YourFirstCharacter
+  name: guide-entry-yourfirstcharacter
+  text: "/ServerInfo/Guidebook/NewPlayer/YourFirstCharacter.xml"

Resources/Prototypes/Guidebook/references.yml

@@ -0,0 +1,26 @@
+- type: guideEntry
+  id: References
+  name: guide-entry-references
+  text: "/ServerInfo/Guidebook/References.xml"
+  children:
+  - Chemicals
+  - Drinks
+  - FoodRecipes
+  - Writing
+
+- type: guideEntry
+  id: Drinks
+  name: guide-entry-drinks
+  text: "/ServerInfo/Guidebook/ReferenceTables/Drinks.xml"
+
+- type: guideEntry
+  id: FoodRecipes
+  name: guide-entry-foodrecipes
+  text: "/ServerInfo/Guidebook/Service/FoodRecipes.xml"
+
+- type: guideEntry
+  id: Writing
+  name: guide-entry-writing
+  text: "/ServerInfo/Guidebook/Writing.xml"
+
+

Resources/Prototypes/Guidebook/service.yml

@@ -0,0 +1,31 @@
+- type: guideEntry
+  id: Service
+  name: guide-entry-service
+  text: "/ServerInfo/Guidebook/Service/Service.xml"
+  filterEnabled: True
+  children:
+  - Bartender
+  - Botany
+  - Chef
+  - Janitorial
+
+- type: guideEntry
+  id: Bartender
+  name: guide-entry-bartender
+  text: "/ServerInfo/Guidebook/Service/Bartender.xml"
+  filterEnabled: True
+
+- type: guideEntry
+  id: Botany
+  name: guide-entry-botany
+  text: "/ServerInfo/Guidebook/Service/Botany.xml"
+
+- type: guideEntry
+  id: Chef
+  name: guide-entry-chef
+  text: "/ServerInfo/Guidebook/Service/Chef.xml"
+
+- type: guideEntry
+  id: Janitorial
+  name: guide-entry-janitorial
+  text: "/ServerInfo/Guidebook/Service/Janitorial.xml"

Resources/Prototypes/Guidebook/shiftandcrew.yml

@@ -3,45 +3,11 @@
   name: guide-entry-jobs
   text: "/ServerInfo/Guidebook/Jobs.xml"
   children:
-  - Bartender
-  - Chef
-  - Botany
+  - Cargo
+  - Command
   - Engineering
+  - Medical
   - Science
   - Security
-  - Janitorial
-  - Cargo
-  - Salvage
-  - Medical
-  # DeltaV additions
-  - Justice
-
-- type: guideEntry
-  id: Survival
-  name: guide-entry-survival
-  text: "/ServerInfo/Guidebook/Survival.xml"
-  children: # DeltaV
-  - AlertProcedure
-
-- type: guideEntry
-  id: Janitorial
-  name: guide-entry-janitorial
-  text: "/ServerInfo/Guidebook/Service/Janitorial.xml"
-
-- type: guideEntry
-  id: Bartender
-  name: guide-entry-bartender
-  text: "/ServerInfo/Guidebook/Service/Bartender.xml"
-  filterEnabled: True
-
-- type: guideEntry
-  id: Chef
-  name: guide-entry-chef
-  text: "/ServerInfo/Guidebook/Service/Chef.xml"
-  children:
-  - FoodRecipes
-
-- type: guideEntry
-  id: FoodRecipes
-  name: guide-entry-foodrecipes
-  text: "/ServerInfo/Guidebook/Service/FoodRecipes.xml"
+  - Service
+  - Justice # DeltaV

Resources/Prototypes/Guidebook/ss14.yml → Resources/Prototypes/Guidebook/station.yml

@@ -5,18 +5,17 @@
   children:
   - Jobs
   - Survival
-  - Chemicals
   - Antagonists
-  - Species
-  - Writing
   - Glossary
 
-- type: guideEntry
-  id: Writing
-  name: guide-entry-writing
-  text: "/ServerInfo/Guidebook/Writing.xml"
-
 - type: guideEntry
   id: Glossary
   name: guide-entry-glossary
   text: "/ServerInfo/Guidebook/Glossary.xml"
+
+- type: guideEntry
+  id: Survival
+  name: guide-entry-survival
+  text: "/ServerInfo/Guidebook/Survival.xml"
+  children: # DeltaV
+  - AlertProcedure

Resources/ServerInfo/Guidebook/Cargo/Cargo.xml

@@ -1,30 +1,32 @@
 <Document>
-  # Logistics
-  The supply department, more commonly known simply as Logistics, is in charge of keeping the station stocked up on necessary resources, such as fuel and raw materials. Though, they are not restricted to simple goods, and can order a wide variety of different items from off-station. The point is, it's Logistics' job to get the rest of the station what they need.
+# Logistics
+The [color=#b18644]Logistics[/color] department is in charge of keeping the station stocked up on necessary resources, such as fuel and raw materials. Though, they are not restricted to simple goods, and can order a wide variety of different items from off-station. The point is, it's [color=#b18644]Logistics[/color]' job to get the rest of the station what they need.
 
-  ## Ordering
+## Ordering
   <Box>
     <GuideEntityEmbed Entity="ComputerCargoOrders"/>
   </Box>
-  Every transaction you make will begin at a [color=#a4885c]cargo request computer[/color], from which you can make orders for specific products. Making any order requires [color=#118C4F]spesos[/color], the currency of the station. To make an order, click the "request" button next to whatever you need, type an appropriate reason for why you're ordering it, and hit "approve" when it appears below the request list.
+Every transaction you make will begin at a [color=#a4885c]cargo request computer[/color], from which you can make orders for specific products. Making any order requires [color=#118C4F]spesos[/color], the currency of the station. To make an order, click the "request" button next to whatever you need, type an appropriate reason for why you're ordering it, and hit "approve" when it appears below the request list.
 
-  ## Piloting
-  Orders are shipped to the station via the [color=#a4885c]Trade Station[/color], and then transported with the cargo shuttle, a remotely piloted shuttle that logistics uses to transport goods back and forth from the trade station. In order to move the shuttle, you must first find the [color=#a4885c]cargo shuttle computer[/color] either on the station, or the shuttle itself.
+## Piloting
+Orders are shipped to the station via the [color=#a4885c]Trade Station[/color], and then transported with the cargo shuttle, a remotely piloted shuttle that logistics uses to transport goods back and forth from the trade station. In order to move the shuttle, you must first find the [color=#a4885c]cargo shuttle computer[/color] either on the station, or the shuttle itself.
   <Box>
     <GuideEntityEmbed Entity="ComputerCargoShuttle"/>
   </Box>
-  After clicking the computer, you should see a radar view of the shuttle. Here are the steps for piloting the shuttle back and forth:
+After clicking the computer, you should see a radar view of the shuttle. Here are the steps for piloting the shuttle back and forth:
 
-  - First, disconnect any airlocks that are connected to the dock.
-  - Then, you actually get to pilot the shuttle. The controls are fairly simple, with [color=#028ed9]"W"[/color] and [color=#028ed9]"S"[/color] being forward and backward, [color=#028ed9]"A"[/color] and [color=#028ed9]"D"[/color] being left and right, and [color=#028ed9]"Q"[/color] and [color=#028ed9]"E"[/color] being rotating left and right; and [color=#028ed9]"spacebar"[/color] being the brake and moving precicely by holding the [color=#028ed9]"spacebar"[/color] while doing other inputs.
-  - Then pilot the shuttle to the [textlink="Trade Station" link="TradeStation"].
+- First, disconnect any airlocks that are connected to the dock.
+- Then, you actually get to pilot the shuttle. The controls are fairly simple, with [color=#028ed9]"W"[/color] and [color=#028ed9]"S"[/color] being forward and backward, [color=#028ed9]"A"[/color] and [color=#028ed9]"D"[/color] being left and right, and [color=#028ed9]"Q"[/color] and [color=#028ed9]"E"[/color] being rotating left and right; and [color=#028ed9]"spacebar"[/color] being the brake and moving precicely by holding the [color=#028ed9]"spacebar"[/color] while doing other inputs.
+- Then pilot the shuttle to the [textlink="Trade Station" link="TradeStation"].
 
-  ## Selling
-  So, you want to order something, but don't have the money for it? You just need to sell something! Almost everything on the station has economic value, which an [color=#a4885c]appraisal tool[/color] can read out to you.
+## Making Money
+So, you want to order something, but don't have the money for it? You just need to sell something! Almost everything on the station has economic value, which an [color=#a4885c]appraisal tool[/color] can read out to you.
   <Box>
     <GuideEntityEmbed Entity="AppraisalTool"/>
     <GuideEntityEmbed Entity="CargoPallet"/>
   </Box>
-  After finding something worth selling, place it on the cargo shuttle, and then fly it to the [textlink="Trade Station" link="TradeStation"]. Then sell the item and collect the spesos from the terminal. You can also make even more money by completing [textlink="bounties" link="CargoBounties"] or selling valuable items from [textlink="salvage" link="Salvage"].
+After finding something worth selling, place it on the cargo shuttle, and then fly it to the [textlink="Trade Station" link="TradeStation"]. Then sell the item and collect the spesos from the terminal. You can also make even more money by completing [textlink="bounties" link="CargoBounties"] or selling valuable items from [textlink="salvage" link="Salvage"].
+
+[textlink="Still broke? Click here to learn about bounties, another source of income." link="CargoBounties"]
 
 </Document>

Resources/ServerInfo/Guidebook/Cargo/CargoBounties.xml

@@ -1,29 +1,45 @@
 <Document>
   # Cargo Bounties
-  [textlink="Logistics" link="Cargo"] can always make money selling items whenever they feel like it. However, there are ways to make even more money by being more selective about what and when you're selling. One of these ways is [color=#a4885c]bounties[/color].
+  While [textlink="Logistics" link="Cargo"] can make [color=cyan]spesos[color] selling just about anything, more spesos can be made by fulfilling [color=cyan]bounties[/color] found through the Cargo Bounty Computer.
+
+  ## Starting Bounties
 
   <Box>
     <GuideEntityEmbed Entity="ComputerCargoBounty"/>
+    <GuideEntityEmbed Entity="PaperCargoBountyManifest"/>
   </Box>
-  Every station has a fixed amount of bounties that are globally available. These can be checked at the [color=#a4885c]cargo bounty computer[/color], which shows the following information about them:
-  - What items are needed to fulfill the bounty
-  - How much money do you get for completing the bounty
-  - How much time is left before the bounty expires
 
-  Assuming that you are able to aquire all of the items for it in a time efficient and low-cost manner, you will be able to complete the bounty and get a significantly higher payout than you would be selling the items conventionally.
+  To start a bounty, open the bounty screen by interacting with the [color=cyan]Cargo Bounty Computer[/color]. The Cargo Bounty Computer maintains a list of all the current bounties and lets you either print out a label or skip it.
+
+  - Printing the label gives you a [color=cyan]Bounty Manifest[/color] listing the goods that need to be acquired. You can print out infinite Bounty Manifests, so ensure you are not repeating the same work as another Cargo Technician.
+
+  - Skipping a bounty replaces that bounty with a new one, as there can only be six active bounties at any time. Skipping has a 15-minute cooldown and voids that bounty, which may anger other Cargo Technicians working on it. However, only the Logistics Officer and Captain can skip bounties so they shouldn't be stepping on anyone's toes.
+
+  ## Fulfilling Bounties
 
-  ## Completing Bounties
   <Box>
     <GuideEntityEmbed Entity="PaperCargoBountyManifest"/>
     <GuideEntityEmbed Entity="CrateGenericSteel"/>
-    <GuideEntityEmbed Entity="CargoPallet"/>
+    <GuideEntityEmbed Entity="AppraisalTool"/>
   </Box>
-  Once you have collected the items you need for a bounty, completing it is a simple process:
-  - Place all of the items inside of the crate and [bold]close it![/bold]
-  - Get the bounties manifest label by clicking the [color=#a4885c]print label[/color] button on corresponding entry on the cargo bounty computer.
-  - Place the label on the crate containing the items.
-  - Move the crate onto the cargo shuttle.
-  - Sell it.
-
-  And there you go! After you follow these steps, the bounty should disappear from the computer and a new one will take its place.
+
+  With the [color=cyan]Bounty Manifest[/color], it is now up to you to collect the required goods. Most departments will give you what you need by asking for it with a Bounty Manifest.
+
+  Once you have collected the goods, return to the cargo bay and put the goods inside an empty [color=cyan]Crate[/color]. After everything is in the crate, close it, and then apply the Bounty Manifest to it.
+
+  To verify the completion of a bounty, use the [color=cyan]Appraisal Tool[/color] on it. It should say that it confirms that the bounty has been completed.
+
+  ## Selling Bounties
+
+  <Box>
+    <GuideEntityEmbed Entity="PaperCargoBountyManifest"/>
+    <GuideEntityEmbed Entity="CrateGenericSteel"/>
+    <GuideEntityEmbed Entity="CargoPalletSell"/>
+  </Box>
+
+  Once you have verified that you have completed the bounty, follow the same steps as selling anything else.
+
+  Just transport it to the [color=cyan]Trading Station[/color], sell it, and you are done!
+
+  When you return, there should be a new bounty to take its place.
 </Document>