From 95f90851ac88177aa358e65fc06deade3e0d4a41 Mon Sep 17 00:00:00 2001
From: NewSoupVi <57900059+NewSoupVi@users.noreply.github.com>
Date: Thu, 17 Nov 2022 17:35:59 +0100
Subject: [PATCH] The Witness: Update docs, credits, junk hints (#1240)

* Updated Credits & AP-game hints

* Updated docs
---
 worlds/witness/__init__.py            |  4 +++-
 worlds/witness/docs/en_The Witness.md | 10 ++++++++++
 worlds/witness/docs/setup_en.md       | 23 +++++++++++++----------
 worlds/witness/hints.py               |  7 +++++++
 4 files changed, 33 insertions(+), 11 deletions(-)

diff --git a/worlds/witness/__init__.py b/worlds/witness/__init__.py
index 4f8d0b4b..845ca3dd 100644
--- a/worlds/witness/__init__.py
+++ b/worlds/witness/__init__.py
@@ -149,7 +149,9 @@ class WitnessWorld(World):
     def fill_slot_data(self) -> dict:
         hint_amount = get_option_value(self.multiworld, self.player, "hint_amount")
 
-        credits_hint = ("This Randomizer", "is brought to you by", "NewSoupVi, Jarno, jbzdarkid, sigma144", -1)
+        credits_hint = (
+            "This Randomizer", "is brought to you by", "NewSoupVi, Jarno, jbzdarkid, sigma144, IHNN, blastron", -1
+        )
 
         audio_logs = get_audio_logs().copy()
 
diff --git a/worlds/witness/docs/en_The Witness.md b/worlds/witness/docs/en_The Witness.md
index 23543285..86ee8e93 100644
--- a/worlds/witness/docs/en_The Witness.md	
+++ b/worlds/witness/docs/en_The Witness.md	
@@ -22,6 +22,16 @@ Solving the last panel in a row of panels or an important standalone panel will
 Every puzzle symbol and many other puzzle mechanics are items.
 This includes symbols such as "Dots", "Black/White Squares", "Colored Squares", "Stars", "Symmetry", "Shapers" (coll. "Tetris Pieces"), "Erasers" and many more.
 
+Alternatively (or additionally), you can play "Door shuffle", where some doors won't open until you receive their "key".
+
+Receiving lasers as items is also a possible setting.
+
+## What else can I find in the world?
+
+By default, the audio logs scattered around the world will have 10 hints for your locations or items on them. 
+
+Example: "Shipwreck Vault contains Triangles".
+
 ## The Jungle, Orchard, Forest and Color House aren't randomized. What gives?
 
 There are limitations to what can currently be randomized in The Witness.
diff --git a/worlds/witness/docs/setup_en.md b/worlds/witness/docs/setup_en.md
index d577953c..5a328c00 100644
--- a/worlds/witness/docs/setup_en.md
+++ b/worlds/witness/docs/setup_en.md
@@ -12,23 +12,26 @@
 
 ## Joining a MultiWorld Game
 
-This Randomizer can be very "moody" if you don't do everything in the correct order.
-It is recommended to do every single one of these steps when you connect to a world.
+1. Launch The Witness
+2. Start a fresh save
+3. Launch [The Witness Archipelago Randomizer](https://github.com/Jarno458/The-Witness-Randomizer-for-Archipelago)
+4. Enter the Archipelago address, slot name and password
+5. Press "Connect"
+6. Enjoy!
+
+To continue an earlier game:
 
 1. Launch The Witness
-2. Start a fresh save (unless you have absolutely no other choice)
-3. Do not move
-4. Launch [The Witness Archipelago Randomizer](https://github.com/Jarno458/The-Witness-Randomizer-for-Archipelago)
-5. Enter the Archipelago address, slot name and password
-6. Press "Randomize"
-7. Wait for the randomization to fully finish before moving in-game
-
-That's it! Have fun!
+2. Load the save you last played this world on, if it's not the one you loaded into automatically
+3. Launch [The Witness Archipelago Randomizer](https://github.com/Jarno458/The-Witness-Randomizer-for-Archipelago)
+4. Press "Load Credentials" (or type them in manually)
+5. Press "Connect"
 
 ## Archipelago Text Client
 
 It is recommended to have Archipelago's Text Client open on the side to keep track of what items you receive and send, as The Witness has no in-game messages.
 <br/>Or use the Auto-Tracker!
+
 ## Auto-Tracking
 
 The Witness has a fully functional map tracker that supports auto-tracking.
diff --git a/worlds/witness/hints.py b/worlds/witness/hints.py
index 3ee010ea..b815ba4d 100644
--- a/worlds/witness/hints.py
+++ b/worlds/witness/hints.py
@@ -35,6 +35,13 @@ joke_hints = [
     ("Have you tried Timespinner?", "Everyone who plays it", "ends up loving it!"),
     ("Have you tried VVVVVV?", "Experience the essence of gaming", "distilled into its purest form!"),
     ("Have you tried The Witness?", "Oh. I guess you already have.", " Thanks for playing!"),
+    ("Have you tried Super Mario World?", "I don't think I need to tell you", "that it is beloved by many."),
+    ("Have you tried Overcooked 2?", "When you're done relaxing with puzzles,",
+     "use your energy to yell at your friends."),
+    ("Have you tried Zillion?", "Me neither. But it looks fun.", "So, let's try something new together?"),
+    ("Have you tried Hylics 2?", "Stop motion might just be", "the epitome of unique art styles."),
+    ("Have you tried Pokemon Red&Blue?", "A cute pet collecting game", "that fascinated an entire generation."),
+    ("Waiting to get your items?", "Try BK Sudoku!", "Make progress even while stuck."),
     ("One day I was fascinated", "by the subject of", "generation of waves by wind"),
     ("I don't like sandwiches", "Why would you think I like sandwiches?", "Have you ever seen me with a sandwich?"),
     ("Where are you right now?", "I'm at soup!", "What do you mean you're at soup?"),