shapez: Typing Cleanup + Small Docs Rewordings (#5189)

Co-authored-by: Exempt-Medic <60412657+Exempt-Medic@users.noreply.github.com>

worlds/shapez/docs/datapackage_settings_de.md

@@ -4,7 +4,7 @@
 
 Die Maximalwerte von `goal_amount` und `shapesanity_amount` sind fest eingebaute Einstellungen, die das Datenpaket des 
 Spiels beeinflussen. Sie sind in einer Datei names `options.json` innerhalb der APWorld festgelegt. Durch das Ändern 
-dieser Werte erschaffst du eine custom APWorld, die nur auf deinem PC existiert.
+dieser Werte erschaffst du eine custom Version der APWorld, die nur auf deinem PC existiert.
 
 ## Wie du die Datenpaket-Einstellungen änderst
 
@@ -18,17 +18,18 @@ ordnungsgemäß befolgt wird. Anwendung auf eigene Gefahr.
    - `max_shapesanity` kann nicht weniger als `4` sein, da dies die benötigte Mindestanzahl zum Verhindern von 
       FillErrors ist.
    - `max_shapesanity` kann auch nicht mehr als `75800` sein, da dies die maximale Anzahl an möglichen Shapesanity-Namen
-     ist. Ansonsten könnte die Generierung der Multiworld fehlschlagen.
+     ist. Das Generieren der Multiworld wird fehlschlagen, falls die `shapesanity_amount`-Option auf einen höheren Wert 
+     gesetzt wird.
    - `max_levels_and_upgrades` kann nicht weniger als `27` sein, da dies die Mindestanzahl für das `mam`-Ziel ist.
 5. Schließe die Zip-Datei und benenne sie zurück zu `shapez.apworld`.
 
 ## Warum muss ich das ganze selbst machen?
 
 Alle Spiele in Archipelago müssen eine Liste aller möglichen Locations **unabhängig der Spieler-Optionen** 
-bereitstellen. Diese Listen aller in einer Multiworld inkludierten Spiele werden in den Daten der Multiworld gespeichert
+bereitstellen. Diese Listen aller in einer Multiworld inkludierten Spiele werden in den Daten der Multiworld gespeichert 
 und an alle verbundenen Clients gesendet. Je mehr mögliche Locations, desto größer das Datenpaket. Und mit ~80000 
 möglichen Locations hatte shapez zu einem gewissen Zeitpunkt ein (von der Datenmenge her) größeres Datenpaket als alle 
-supporteten Spiele zusammen. Um also diese Datenmenge zu reduzieren wurden die ausgeschriebenen 
+Core-verifizierten Spiele zusammen. Um also diese Datenmenge zu reduzieren, wurden die ausgeschriebenen 
 Shapesanity-Locations-Namen (`Shapesanity Uncolored Circle`, `Shapesanity Blue Rectangle`, ...) durch standardisierte 
 Namen (`Shapesanity 1`, `Shapesanity 2`, ...) ersetzt. Durch das Ändern dieser Maximalwerte, und damit das Erstellen 
 einer custom APWorld, kannst du die Anzahl der möglichen Locations erhöhen, wirst aber auch gleichzeitig das Datenpaket 

worlds/shapez/docs/datapackage_settings_en.md

@@ -1,14 +1,14 @@
-# Guide to change maximum locations in shapez
+# Guide to change the maximum amount of locations in shapez
 
 ## Where do I find the settings to increase/decrease the amount of possible locations?
 
-The maximum values of the `goal_amount` and `shapesanity_amount` are hardcoded settings that affect the datapackage. 
-They are stored in a file called `options.json` inside the apworld. By changing them, you will create a custom apworld 
-on your local machine.
+The maximum values of the `goal_amount` and `shapesanity_amount` options are hardcoded settings that affect the 
+datapackage. They are stored in a file called `options.json` inside the apworld. By changing them, you will create a 
+custom version on your local machine.
 
-## How to change datapackage options
+## How to change datapackage settings
 
-This tutorial is for advanced users and can result in the software not working properly, if not read carefully. 
+This tutorial is intended for advanced users and can result in the software not working properly, if not read carefully. 
 Proceed at your own risk.
 
 1. Go to `<AP installation>/lib/worlds`.
@@ -17,17 +17,17 @@ Proceed at your own risk.
 4. Edit the values in this file to your desire and save the file.
    - `max_shapesanity` cannot be lower than `4`, as this is the minimum amount to prevent FillErrors.
    - `max_shapesanity` also cannot be higher than `75800`, as this is the maximum amount of possible shapesanity names. 
-     Else the multiworld generation might fail.
+     Multiworld generation will fail if the `shapesanity_amount` options is set to a higher value.
    - `max_levels_and_upgrades` cannot be lower than `27`, as this is the minimum amount for the `mam` goal to properly 
      work.
-5. Close the zip and rename it back to `shapez.apworld`.
+5. Close the zip file and rename it back to `shapez.apworld`.
 
 ## Why do I have to do this manually?
 
 For every game in Archipelago, there must be a list of all possible locations, **regardless of player options**. When 
-generating a multiworld, a list of all locations of all included games will be saved in the multiworld data and sent to 
-all clients. The higher the amount of possible locations, the bigger the datapackage. And having ~80000 possible 
-locations at one point made the datapackage for shapez bigger than all other supported games combined. So to reduce the 
-datapackage of shapez, the locations for shapesanity are named `Shapesanity 1`, `Shapesanity 2` etc. instead of their 
-actual names. By creating a custom apworld, you can increase the amount of possible locations, but you will also 
-increase the size of the datapackage at the same time.
+generating a multiworld, a list of all locations of all included games will be saved in the multiworld's data and sent 
+to all clients. The higher the amount of possible locations, the bigger the datapackage. And having ~80000 possible 
+locations at one point made the datapackage for shapez bigger than all other core-verified games combined. So, to reduce 
+the datapackage size of shapez, the locations for shapesanity are named `Shapesanity 1`, `Shapesanity 2` etc. instead of 
+their actual names. By creating a custom version of the apworld, you can increase the amount of possible locations, but 
+you will also increase the size of the datapackage at the same time.

worlds/shapez/docs/de_shapez.md

@@ -19,25 +19,27 @@ Zusätzlich gibt es zu diesem Spiel "Datenpaket-Einstellungen", die du nach
 
 Alle Belohnungen aus den Tutorial-Level (das Freischalten von Gebäuden und Spielmechaniken) und Verbesserungen durch
 Upgrades werden dem Itempool der Multiworld hinzugefügt. Außerdem werden, wenn so in den Spieler-Optionen festgelegt,
-die Bedingungen zum Abschließen eines Levels und zum Kaufen der Upgrades randomisiert.
+die Bedingungen zum Abschließen eines Levels und zum Kaufen der Upgrades randomisiert und die Reihenfolge der Gebäude 
+in deinen Toolbars (Haupt- und Kabelebene) gemischt.
 
 ## Was ist das Ziel von shapez in Archipelago?
 
-Da das Spiel eigentlich kein konkretes Ziel (nach dem Tutorial) hat, kann man sich zwischen (momentan) 4 verschiedenen
-Zielen entscheiden:
+Da das Spiel eigentlich kein konkretes Ziel, welches das Ende des Spiels bedeuten würde, hat, kann man sich zwischen 
+(aktuell) 4 verschiedenen Zielen entscheiden:
 1. Vanilla: Schließe Level 26 ab (eigentlich das Ende des Tutorials).
 2. MAM: Schließe ein bestimmtes Level nach Level 26 ab, das zuvor in den Spieler-Optionen festgelegt wurde. Es ist
 empfohlen, eine Maschine zu bauen, die alles automatisch herstellt ("Make-Anything-Machine", kurz MAM).
-3. Even Fasterer: Kaufe alle Upgrades bis zu einer in den Spieler-Optionen festgelegten Stufe (nach Stufe 8).
+3. Even Fasterer: Kaufe alle Upgrades bis zu einer in den Spieler-Optionen festgelegten Stufe (nach Stufe VIII (8)).
 4. Efficiency III: Liefere 256 Blaupausen-Formen pro Sekunde ins Zentrum.
 
 ## Welche Items können in den Welten anderer Spieler erscheinen?
 
-- Freischalten verschiedener Gebäude
+- Gebäude
 - Blaupausen freischalten
-- Große Upgrades (addiert 1 zum Geschwindigkeitsmultiplikator)
-- Kleine Upgrades (addiert 0.1 zum Geschwindigkeitsmultiplikator)
-- Andere ungewöhnliche Upgrades (optional)
+- Upgrades
+  - Große Upgrades (addiert 1 zum Geschwindigkeitsmultiplikator)
+  - Kleine Upgrades (addiert 0.1 zum Geschwindigkeitsmultiplikator)
+  - Andere ungewöhnliche (auch negative) Upgrades (optional)
 - Verschiedene Bündel, die bestimmte Formen enthalten
 - Fallen, die bestimmte Formen aus dem Zentrum dränieren (ja, das Wort gibt es)
 - Fallen, die zufällige Gebäude oder andere Spielmechaniken betreffen
@@ -45,7 +47,7 @@ empfohlen, eine Maschine zu bauen, die alles automatisch herstellt ("Make-Anythi
 ## Was ist eine Location / ein Check?
 
 - Level (minimum 1-25, bis zu 499 je nach Spieler-Optionen, mit zusätzlichen Checks für Level 1 und 20)
-- Upgrades (minimum Stufen II-VIII (2-8), bis zu D (500) je nach Spieler-Optionen)
+- Upgrades (minimum Stufen II-VIII (2-8), bis zu D (500), je nach Spieler-Optionen)
 - Bestimmte Formen mindestens einmal ins Zentrum liefern ("Shapesanity", bis zu 1000 zufällig gewählte Definitionen)
 - Errungenschaften (bis zu 45)
 

worlds/shapez/docs/en_shapez.md

@@ -4,9 +4,9 @@
 
 shapez is an automation game about cutting, rotating, stacking, and painting shapes, that you extract from randomly
 generated patches on an infinite canvas, and sending them to the hub to complete levels. The "tutorial", where you
-unlock a new building or game mechanic (almost) each level, lasts until level 26, where you unlock freeplay with 
-infinitely more levels, that require a new, randomly generated shape. Alongside the levels, you can unlock upgrades,
-that make your buildings work faster.
+unlock a new building or game mechanic (almost) each level, lasts until level 26, which unlocks freeplay with 
+infinitely more levels, that each require a new, randomly generated shape. Alongside the levels, you can unlock 
+upgrades, that make your buildings work faster.
 
 ## Where is the options page?
 
@@ -17,29 +17,30 @@ There are also some advanced "datapackage settings" that can be changed by follo
 
 ## What does randomization do to this game?
 
-Buildings and gameplay mechanics, that you normally unlock by completing a level, and upgrade improvements are put 
-into the item pool of the multiworld. Also, if enabled, the requirements for completing a level or buying an upgrade are
-randomized.
+Buildings and gameplay mechanics, which you normally unlock by completing a level, and upgrade improvements are put 
+into the item pool of the multiworld. You can also randomize the requirements for completing a level or buying an 
+upgrade and shuffle the order of building in your toolbars (main and wires layer).
 
 ## What is the goal of shapez in Archipelago?
 
-As the game has no actual goal where the game ends, there are (currently) 4 different goals you can choose from in the 
-player options:
+As the game has no actual goal that would represent the end of the game, there are (currently) 4 different goals you 
+can choose from in the player options:
 1. Vanilla: Complete level 26 (the end of the tutorial).
 2. MAM: Complete a player-specified level after level 26. It's recommended to build a Make-Anything-Machine (MAM).
-3. Even Fasterer: Upgrade everything to a player-specified tier after tier 8.
+3. Even Fasterer: Upgrade everything to a player-specified tier after tier VIII (8).
 4. Efficiency III: Deliver 256 blueprint shapes per second to the hub.
 
 ## Which items can be in another player's world?
 
-- Unlock different buildings
-- Unlock blueprints
-- Big upgrade improvements (adds 1 to the multiplier)
-- Small upgrade improvements (adds .1 to the multiplier)
-- Other unusual upgrade improvements (optional)
+- Buildings
+- Unlocking blueprints
+- Upgrade improvements
+  - Big improvements, adding 1 to the multiplier
+  - Small improvements, adding 0.1 to the multiplier
+  - Optional: Other, rather unusual and even bad, improvements
 - Different shapes bundles
 - Inventory draining traps
-- Different traps afflicting random buildings and game mechanics
+- Different traps affecting random buildings and game mechanics
 
 ## What is considered a location check?
 
@@ -61,5 +62,4 @@ Here's a cheat sheet:
 ## Can I use other mods alongside the AP client?
 
 At the moment, compatibility with other mods is not supported, but not forbidden. Gameplay altering mods will most
-likely crash the game or disable loading the afflicted mods, while QoL mods might work without problems. Try at your own
-risk.
+likely break the game in some way, while small QoL mods might work without problems. Try at your own risk.

worlds/shapez/docs/setup_de.md

@@ -16,9 +16,10 @@
 
 - Archipelago von der [Archipelago-Release-Seite](https://github.com/ArchipelagoMW/Archipelago/releases)
     * (Für den Text-Client)
-    * (Alternativ kannst du auch die eingebaute Konsole (nur lesbar) nutzen, indem du beim Starten des Spiels den 
-  `-dev`-Parameter verwendest)
-- Universal Tracker (schau im `#future-game-design`-Thread für UT auf dem Discord-Server nach der aktuellen Anleitung)
+    * (Alternativ kannst du auch die eingebaute Konsole nutzen, indem du das Spiel mit dem `-dev`-Parameter 
+      startest und jede Nachricht als `AP.sendAPMessage("<Nachricht>"")` schreibst)
+- Universal Tracker (schau im Kanal von UT auf dem Discord-Server nach der aktuellen Anleitung und für weitere 
+  Informationen)
 
 ## Installation
 

worlds/shapez/docs/setup_en.md

@@ -16,9 +16,9 @@
 
 - Archipelago from the [Archipelago Releases Page](https://github.com/ArchipelagoMW/Archipelago/releases)
     * (Only for the TextClient)
-    * (If you want, you can use the built-in console as a read-only text client by launching the game 
-  with the `-dev` parameter)
-- Universal Tracker (check UT's `#future-game-design` thread in the discord server for instructions)
+    * (You can alternatively use the built-in console by launching the game with the `-dev` parameter and typing 
+      `AP.sendAPMessage("<message>"")`)
+- Universal Tracker (check UT's channel in the discord server for more information and instructions)
 
 ## Installation