From b64eeba98bf429574a48731a211b865a89bd6312 Mon Sep 17 00:00:00 2001
From: PTKay <jp_moura99@outlook.com>
Date: Wed, 30 Oct 2024 15:47:00 +0000
Subject: [PATCH] Added level ID map for Shadow Generations

---
 .../docs/hedgehog-engine/miller/levels/ids.md | 75 +++++++++++++++++++
 mkdocs.yml                                    |  3 +
 2 files changed, 78 insertions(+)
 create mode 100644 hedgedocs/docs/hedgehog-engine/miller/levels/ids.md

diff --git a/hedgedocs/docs/hedgehog-engine/miller/levels/ids.md b/hedgedocs/docs/hedgehog-engine/miller/levels/ids.md
new file mode 100644
index 00000000..a8379721
--- /dev/null
+++ b/hedgedocs/docs/hedgehog-engine/miller/levels/ids.md
@@ -0,0 +1,75 @@
+---
+description: Shadow Generations level ID map
+---
+
+# Level ID Map
+
+## Mapping
+Stage IDs are defined like this:
+```
+{world_id}{stage_type}{stage_number}
+```
+!!! info "Example"
+    w02a10 -> Rail Canyon: Act 1
+
+### Worlds (Zones)
+
+World ID  | World Name
+--------  | -----------
+w01       | Space Colony Ark
+w02       | Rail Canyon
+w03       | Kingdom Valley
+w04       | Sunset Heights
+w05       | Chaos Island
+w06       | Radical Highway
+w09       | White Space
+w11       | Biolizard
+w12       | Metal Overlord
+w13       | Mephiles
+w14       | Devil Doom
+
+### Stage Type
+
+Stage Type ID | Stage Type
+------------- | -----------
+a             | Normal Stage
+b             | Boss Battle
+c             | Challenge
+h             | Hard Challenge
+m             | Movie (Cutscene)
+
+### White Space
+Description                     | Level ID
+------------------------------- | -----------
+White Space                     | w09a10
+White Space (Doom Zone)         | w09a20
+
+### Stages
+Stage Name                      | Level ID
+------------------------------- | -----------
+Space Colony Ark: Act 1         | w01a11
+Space Colony Ark: Act 2         | w01a20
+Rail Canyon: Act 1              | w02a10
+Rail Canyon: Act 2              | w02a20
+Kingdom Valley: Act 1           | w03a10
+Kingdom Valley: Act 2           | w03a20
+Sunset Heights: Act 1           | w04a10
+Sunset Heights: Act 2           | w04a20
+Chaos Island: Act 1             | w05a10
+Chaos Island: Act 2             | w05a20
+Radical Highway: Act 1          | w06a10
+Radical Highway: Act 2          | w06a20
+
+### Boss Battles
+Boss Name               | Level ID
+----------------------- | -----------
+Biolizard               | w11b10
+Biolizard (Hard)        | w11b11
+Metal Overlord          | w12b10
+Metal Overlord (Hard)   | w12b11
+Mephiles                | w13b10
+Mephiles (Hard)         | w13b11
+Devil Doom              | w14b10
+
+## Oddities
+The ID of Space Colony Ark: Act 1 is `w01a11` instead of the expected `w01a10`. There are, however, files referencing this last ID. 
\ No newline at end of file
diff --git a/mkdocs.yml b/mkdocs.yml
index 7e3da527..e61fc850 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -143,6 +143,9 @@ nav:
           - Gismos: docs/hedgehog-engine/rangers/obj/gismos.md
         - Scripts:
           - Functions: docs/hedgehog-engine/rangers/scripts/funcs.md
+      - Shadow Generations:
+        - Levels:
+          - Level ID Map: docs/hedgehog-engine/miller/levels/ids.md
     - Sega NN:
       - Common:
         - NN Chunk Format: