Deploying to gh-pages from @ 089a565 🚀

README.md

@@ -1,3 +1,3 @@
-This is the repository for the website at https://randovania.github.io/.
+This is the repository for the website at https://randovania.org/.
 
-It's created from html files at `static_website`, with the exported logic videos from the current Randovania release.
+It's built using Jekyll. To build and test locally, first run `ci.sh` then follow the [Github Pages instructions for local testing](https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/testing-your-github-pages-site-locally-with-jekyll).

_config.yml

@@ -19,6 +19,7 @@ nav_exclude:                                            # The following paths ar
   - pages/tags.html
   - pages/404.html
   - pages/index.md
+  - pages/experimental-games.md
 
 
 ### Social Media Info ###
@@ -39,6 +40,9 @@ collections:
   redirects:
     output: true
     permalink: /:path
+  videos:
+    output: true
+    permalink: /games/:path/videos
 
 
 ### Analytics ###
@@ -60,6 +64,11 @@ defaults:
       type: "redirects"
     values:
       layout: "redirect"
+  - scope:
+      path: ""
+      type: "videos"
+    values:
+      layout: "video_db"
   - scope:
       path: ""
       type: "posts"
@@ -76,3 +85,5 @@ exclude:
   - ci.sh
   - Gemfile
   - Gemfile.lock
+  - venv/
+  - build/

_data/rdv.yml

@@ -1,2 +1 @@
-version: 7.4.0
 version: 7.5.0

_games/am2r.md

@@ -1,12 +1,60 @@
 ---
-short-name: am2r
-long-name: AM2R
-randomize:  |
-            - All items can be randomized
-            - Starting location
-            - Door locks
-            - A new goal has been added (DNA Hunt)
-need-to-play:   |
-                - AM2R version 1.5.5
+game-id: am2r
+short-name: AM2R
+long-name: Another Metroid 2 Remake
+randomize:
+- All items
+- Starting locations
+- Door locks
+- A new goal has been added (DNA Hunt)
+need-to-play:
+- AM2R version 1.5.5
 multiworld: true
----
+development-state: stable
+faq:
+- question: AM2R already has a built-in randomizer, what does this do differently?
+  answer: "The Randovania implementation provides additional robustness and more features
+    compared to the built-in randomizer.\n\nKey features supported by Randovania include,
+    but are not limited to, full item logic, toggleable tricks and difficulties, Door
+    Lock Rando, and Multiworld support.\n\nAll Metroids now also drop items. This
+    can include progression, expansions, or DNA. DNA are like keys and are used to
+    enter the path to the Queen. The amount of DNA is configurable and a hint system
+    has been implemented, which means it's not necessary anymore to fight all the
+    Metroids."
+- question: Which versions of AM2R are supported?
+  answer: Only version 1.5.5 is supported. Currently there are no plans to support
+    other versions.
+- question: Why can I not fire Missiles / Super Missiles / Power Bombs?
+  answer: You likely have the 'Required Mains' option enabled. This means you first
+    need to find the Launcher for your Missiles / Super Missiles / Power Bombs before
+    you can use them.
+- question: Why was the DNA goal chosen, and why does the Starter Preset require main
+    items / launchers for Missiles / Super Missiles / Power Bombs?
+  answer: "Both were chosen to provide better gameplay and more variety. Killing the
+    same 46 Metroids over and over again is not only tedious, but also boring. The
+    Metroids dropping items makes Metroid fights interesting and worthwhile to do
+    as opposed to most players otherwise just ignoring them entirely, while also not
+    making it mandatory to kill all Metroids.\nRequired mains / launchers causes progression
+    to be more natural, as otherwise it's possible to break the logic chain and get
+    overpowered by just finding ammo early."
+- question: I saved in a place that I can't get out of, what do I do?
+  answer: You can use the 'Restart from Start Location' option, which will reload
+    your last save but make you spawn at the original start location.
+- question: What causes Serris to spawn?
+  answer: Serris will spawn once you collect the item in Distribution Center - Ice
+    Beam Chamber and then hit the fight trigger on the left side of the Serris Arena.
+- question: Can I defeat Serris without Ice Beam?
+  answer: Yes, Serris automatically changes her weakness to not require Ice Beam if
+    you fight her before acquiring it.
+- question: Where can I find the Hints?
+  answer: "There are eight hints in total, and the map will show an 'H' icon on places
+    where hints exist. They can can be found in:\n\n- Main Caves - Research Site Elevator\n
+    - Golden Temple - Breeding Grounds Hub\n- Hydro Station - Breeding Grounds Lobby\n
+    - Industrial Complex - Breeding Grounds Fly Stadium\n- The Tower - Tower Exterior
+    North\n- Distribution Center - Distribution Facility Tower East\n- The Depths
+    - Bubble Lair Shinespark Cave\n- Genetics Laboratory - Destroyed Chozo Memorial"
+- question: What are shinies?
+  answer: "Some items have a 1 in 1024 chance of being a Pok\xE9mon-style shiny: they
+    look different but behave entirely the same as normal. In a multiworld game, only
+    your own items can be shiny."
+---

_games/blank.md

@@ -0,0 +1,14 @@
+---
+game-id: blank
+short-name: Blank
+long-name: Blank Development Game
+randomize:
+- Everything
+- Nothing
+need-to-play:
+- A Nintendo Virtual Boy
+- Your original Virtual Boy Game Cartridge
+multiworld: false
+development-state: experimental
+faq: []
+---

_games/cave_story.md

@@ -1,9 +1,13 @@
 ---
-short-name: cave_story
+game-id: cave_story
+short-name: CS
 long-name: Cave Story
-randomize:  |
-            - All items can be randomized
-need-to-play:   |
-                - Windows or Wine. The game is included in Randovania
+randomize:
+- All items
+- Starting locations
+need-to-play:
+- Windows, Linux, or Wine. The game is included with Randovania
 multiworld: true
----
+development-state: stable
+faq: []
+---

_games/dread.md

@@ -1,13 +1,57 @@
 ---
-short-name: dread
+game-id: dread
+short-name: Dread
 long-name: Metroid Dread
-randomize:  |
-            - All items can be randomized
-            - Elevator and shuttle destinations
-            - Door locks
-            - A new goal has been added (DNA Hunt)
-need-to-play:   |
-                - A modded Switch with Atmosphere and SimpleModManager; or Ryujinx
-                - A dumped RomFS of your original game. Either version 1.0.0 or 2.1.0
+randomize:
+- All items
+- Elevator and shuttle destinations
+- Starting locations
+- Door locks
+- A new goal has been added (DNA Hunt)
+need-to-play:
+- A modded Switch with Atmosphere and SimpleModManager; or Ryujinx
+- A dumped RomFS of your original game. Either version 1.0.0 or 2.1.0
 multiworld: true
----
+development-state: stable
+faq:
+- question: What Switch Emulators does Randovania support?
+  answer: Randovania only officially supports Ryujinx as an emulator, with no plans
+    to support additional emulators.
+- question: Why does this missile door not open after I shoot a missile at it?
+  answer: Shoot another missile at the door. In the process of making certain missile
+    doors possible to open from both sides, this issue shows up.
+- question: Using an Energy Recharge Station heals me to 299, but my energy maximum
+    is 249. Which one is correct?
+  answer: The 299 is a display error. You can always see the correct value in the
+    inventory screen.
+- question: Why is this pickup not animating, or displaying visual effects?
+  answer: While progressive pickups update to have the correct model, due to limitations
+    these models are not animated or have any additional effects.
+- question: Can I use other mods?
+  answer: "Depending on which files the other mods change, it can go from simple to
+    impossible.\n\n* If a Lua file is modified, very likely it's not compatible.\n
+    * If a PKG file is modified, it'll have to be combined with the one from Randovania.\n
+    * Other mods likely work fine.\n\nWhen reporting issues, your first step is always
+    to reproduce the issue without mods, **no matter how simple** the mod is."
+- question: I picked up the Speed Booster / Phantom Cloak / Storm Missile but can't
+    use them!
+  answer: "Press ZL + ZR + D-Pad Up to fix the issue. Check the entry 'Crashing after
+    suit upgrade' in 'Known Crashes' tab for important rules of when to use this button
+    combination.\n\nYou can also save and reload your game."
+- question: I entered the arena for Golzuna/Experiment Z-57 but it isn't there!
+  answer: "Golzuna and Experiment Z-57 will not appear unless the X have been released
+    from Elun.\n\nTo activate the fight against Experiment Z-57, you must use the
+    Morph Ball Launcher to enter the arena."
+- question: I opened the Wide Beam door in Dairon's Teleport to Cataris, but it won't
+    let me through!
+  answer: "Unlocking this door before turning on the power will render it unopenable.\n
+    \nTo fix this, simply save and reload the game."
+- question: I received a Beam/Missile upgrade from an E.M.M.I., and now my arm cannon
+    doesn't work!
+  answer: Reload from checkpoint immediately to fix the issue. Your checkpoint was
+    saved after killing the E.M.M.I., so you will not lose progress.
+- question: Why are items, hints, and the seed hash not displaying properly in my
+    game?
+  answer: "Currently, English is the only officially supported language.\n\nYou must
+    set your language to English to see all the text the randomizer changes."
+---

_games/fusion.md

@@ -0,0 +1,22 @@
+---
+game-id: fusion
+short-name: Fusion
+long-name: Metroid Fusion
+randomize: []
+need-to-play: []
+multiworld: false
+development-state: experimental
+faq:
+- question: What patcher does Randovania use?
+  answer: Randovania supports the open source patcher MARS (Metroid Advance Randomizer
+    System). This is a new patcher built from scratch and is unrelated to other Fusion
+    Randomizers. Any differences from the vanilla game are covered under the differences
+    tab.
+- question: Which versions of Fusion are supported?
+  answer: Only the USA version of Fusion is supported with no current plans to support
+    additional versions.
+- question: I saved in a place I can't get out of, am I softlocked?
+  answer: You can use the "Warp to Start" function in the pause menu by pressing L
+    and confirming. This will place you back at your start location with everything
+    collected since your last save. Please note that this is never logical.
+---

_games/prime1.md

@@ -1,13 +1,34 @@
 ---
-short-name: prime1
+game-id: prime1
+short-name: Prime
 long-name: Metroid Prime
-randomize:  |
-            - All items including Artifacts
-            - Elevator destinations
-            - Starting locations
-            - Door locks
-need-to-play:   |
-                - An ISO of any Gamecube release of the game
-                - A modded Wii, or Dolphin Emulator
+randomize:
+- All items including Artifacts
+- Elevator destinations
+- Starting locations
+- Door locks
+need-to-play:
+- An ISO of any Gamecube release of the game
+- A modded Wii, or Dolphin Emulator
 multiworld: true
----
+development-state: stable
+faq:
+- question: An item collection message sometimes shows up when collecting items, even
+    when disabled. Why?
+  answer: In a multiworld, you must not collect items for other players too quickly.
+    To avoid issues, the message box is forced in situations a problem could happen.
+    For more details on the problem, check *Randovania Help -> Multiworld*.
+- question: What is a Shiny Missile Expansion?
+  answer: "Missile Expansions have a 1 in 1024 of being Pok\xE9mon-style shiny: they
+    look different but behave entirely the same as normal.\n\nIn a multiworld game,
+    only your own Missile Expansions can be shiny."
+- question: What versions of the game are supported?
+  answer: All Gamecube versions are supported. If it plays with tank controls, it
+    can be randomized. Wii/Trilogy version is not supported at this time.
+- question: Won't seeds requiring glitches be incompletable on PAL, JP, and Player's
+    Choice due to the version differences from NTSC 0-00?
+  answer: When the output ISO is generated, the input version is automatically detected,
+    and any bug or sequence break fixes present on that version are undone. This reverts
+    the game to be functionally equivalent to NTSC 0-00, meaning that all versions
+    of Prime are guaranteed to be logically completable when randomized.
+---

_games/prime2.md

@@ -1,14 +1,44 @@
 ---
-short-name: prime2
-long-name: "Metroid Prime 2: Echoes"
-randomize:  |
-            - All items including Temple Keys
-            - Elevator destinations
-            - Starting locations
-            - Door locks
-            - Translator gate requirements
-need-to-play:   |
-                - An ISO of any Gamecube release of the game
-                - A modded Wii, or Dolphin Emulator
+game-id: prime2
+short-name: Echoes
+long-name: 'Metroid Prime 2: Echoes'
+randomize:
+- All items including Temple Keys
+- Elevator destinations
+- Starting locations
+- Door locks
+- Translator gate requirements
+need-to-play:
+- An ISO of any NTSC-U or PAL Gamecube release of the game
+- A modded Wii, or Dolphin Emulator
 multiworld: true
----
+development-state: stable
+faq:
+- question: I can't use this spider track, even though I have Spider Ball!
+  answer: "The following rooms have surprising vanilla behaviour about their spider
+    tracks:\n\n#### Main Reactor (Agon Wastes)\n\nThe spider tracks only works after
+    you beat Dark Samus 1 and reload the room. When playing with no tricks, this means
+    you need Dark Beam to escape the room.\n\n#### Dynamo Works (Sanctuary Fortress)\n
+    \nThe spider tracks only works after you beat Spider Guardian. When playing with
+    no tricks, you can't leave this way until you do that.\n\n#### Spider Guardian
+    fight (Sanctuary Fortress)\n\nDuring the fight, the spider tracks only works in
+    the first and last phases. After the fight, they all work normally.\nThis means
+    you need Boost Ball to fight Spider Guardian."
+- question: Where is the Flying Ing Cache inside Dark Oasis?
+  answer: The Flying Ing Cache in this room appears only after you collect the item
+    that appears after defeating Power Bomb Guardian.
+- question: What causes the Dark Missile Trooper to spawn?
+  answer: Defeating the Bomb Guardian.
+- question: What causes the Missile Expansion on top of the GFMC Compound to spawn?
+  answer: Collecting the item that appears after defeating the Jump Guardian.
+- question: Why isn't the elevator in Torvus Temple working?
+  answer: In order to open the elevator, you also need to pick the item in Torvus
+    Energy Controller.
+- question: Why can't I see the echo locks in Mining Plaza even when using the Echo
+    Visor?
+  answer: You need to beat Amorbis and then return the Agon Energy in order for these
+    echo locks to appear.
+- question: Why can't I cross the door between Underground Transport and Torvus Temple?
+  answer: The energy gate that disappears after the pirate fight in Torvus Temple
+    blocks this door.
+---

_games/prime3.md

@@ -0,0 +1,25 @@
+---
+game-id: prime3
+short-name: Corruption
+long-name: 'Metroid Prime 3: Corruption'
+randomize: []
+need-to-play: []
+multiworld: false
+development-state: experimental
+faq:
+- question: What causes the Hypermode vines in Corrupted Pool to disappear?
+  answer: Collecting the ship item in Hangar Bay removes the vines.
+- question: While fighting Rundas, the game lags and there are pirates and turrets
+    in the way. What causes this?
+  answer: If you collect the ship item in Hangar Bay before fighting Rundas, both
+    Rundas and the pirate layers will be active at the same time.
+- question: I have Ship Missiles but I am unable to break the wall in Ancient Courtyard.
+  answer: To break the wall, you must have the Main Ship Missiles in your inventory.
+- question: The item in Gearworks is blocked off. How do I collect it?
+  answer: Collecting the item in SkyTown Federation Landing Site unlocks access to
+    the item.
+- question: I don't have Command Visor. Can I still collect the items from the landing
+    sites?
+  answer: You can fly to either unlocked landing site from an already active one to
+    collect the item.
+---