[Pokemon Red and Blue] Initial implementation (#1016)

worlds/pokemon_rb/docs/en_Pokemon Red and Blue.md

@@ -0,0 +1,55 @@
+# Pokémon Red and Blue
+
+## Where is the settings page?
+
+The [player settings page for this game](../player-settings) contains all the options you need to configure and export a
+config file.
+
+## What does randomization do to this game?
+
+Items which the player would normally acquire throughout the game have been moved around. Logic remains, so the game is
+always able to be completed, but because of the item shuffle the player may need to access certain areas before they
+would in the vanilla game.
+
+A great many things besides item placement can be randomized, such as the location of Pokémon, their stats, types, etc., depending on your yaml settings.
+
+Many baseline changes are made to the game, including:
+
+* Bag item space increased to 128 slots (up from 20)
+* PC item storage increased to 64 slots (up from 50)
+* You can hold B to run (or bike extra fast!).
+* You can hold select while talking to a trainer to re-battle them.
+* You can return to route 2 from Diglett's Cave without the use of Cut.
+* Mew can be encountered at the S.S. Anne dock truck. This can be randomized depending on your settings.
+* The S.S. Anne will never depart.
+* Seafoam Islands entrances are swapped. This means you need Strength to travel through from Cinnabar Island to Fuchsia
+City
+* After obtaining one of the fossil item checks in Mt Moon, the remaining item can be received from the Cinnabar Lab
+fossil scientist. This may require reviving a number of fossils, depending on your settings.
+* Obedience depends on the total number of badges you have obtained instead of depending on specific badges.
+* Pokémon that evolve by trading can also evolve by reaching level 35.
+* Evolution stones are reusable.
+* Much of the dialogue throughout the game has been removed or shortened.
+* If the Old Man is blocking your way through Viridian City, you do not have Oak's Parcel in your inventory, and you've
+exhausted your money and Poké Balls, you can get a free Poké Ball from your mom.
+
+## What items and locations get shuffled?
+
+All items that go into your bags given by NPCs or found on the ground, as well as gym badges.
+Optionally, hidden items (those located with the Item Finder) can be shuffled as well.
+
+## Which items can be in another player's world?
+
+Any of the items which can be shuffled may also be placed into another player's world.
+By default, gym badges are shuffled across only the 8 gyms, but you can turn on Badgesanity in your yaml to shuffle them
+into the general item pool.
+
+## What does another world's item look like in Pokémon Red and Blue?
+
+All items for other games will display simply as "AP ITEM," including those for other Pokémon Red and Blue games.
+
+## When the player receives an item, what happens?
+
+A "received item" sound effect will play. Currently, there is no in-game message informing you of what the item is.
+If you are in battle, have menus or text boxes opened, or scripted events are occurring, the items will not be given to
+you until these have ended.

worlds/pokemon_rb/docs/setup_en.md

@@ -0,0 +1,84 @@
+# Setup Guide for Pokémon Red and Blue: Archipelago
+
+## Important
+
+As we are using Bizhawk, this guide is only applicable to Windows and Linux systems.
+
+## Required Software
+
+- Bizhawk: [Bizhawk Releases from TASVideos](https://tasvideos.org/BizHawk/ReleaseHistory)
+  - Version 2.3.1 and later are supported. Version 2.7 is recommended for stability.
+  - Detailed installation instructions for Bizhawk can be found at the above link.
+  - Windows users must run the prereq installer first, which can also be found at the above link.
+- The built-in Archipelago client, which can be installed [here](https://github.com/ArchipelagoMW/Archipelago/releases)
+  (select `Pokemon Client` during installation).
+- Pokémon Red and/or Blue ROM files. The Archipelago community cannot provide these.
+
+## Configuring Bizhawk
+
+Once Bizhawk has been installed, open Bizhawk and change the following settings:
+
+- Under Config > Customize > Advanced, make sure the box for AutoSaveRAM is checked, and click the 5s button.
+  This reduces the possibility of losing save data in emulator crashes.
+- Under Config > Customize, check the "Run in background" and "Accept background input" boxes. This will allow you to
+  continue playing in the background, even if another window is selected.
+
+It is strongly recommended to associate GB rom extensions (\*.gb) to the Bizhawk we've just installed.
+To do so, we simply have to search any Gameboy rom we happened to own, right click and select "Open with...", unfold
+the list that appears and select the bottom option "Look for another application", then browse to the Bizhawk folder
+and select EmuHawk.exe.
+
+## Configuring your YAML file
+
+### What is a YAML file and why do I need one?
+
+Your YAML file contains a set of configuration options which provide the generator with information about how it should
+generate your game. Each player of a multiworld will provide their own YAML file. This setup allows each player to enjoy
+an experience customized for their taste, and different players in the same multiworld can all have different options.
+
+### Where do I get a YAML file?
+
+You can generate a yaml or download a template by visiting the [Pokemon Red and Blue Player Settings Page](/games/Pokemon Red and Blue/player-settings)
+
+It is important to note that the `game_version` option determines the ROM file that will be patched.
+Both the player and the person generating (if they are generating locally) will need the corresponding ROM file.
+
+For `trainer_name` and `rival_name` the following regular characters are allowed:
+
+* `‘’“”·… ABCDEFGHIJKLMNOPQRSTUVWXYZ():;[]abcdefghijklmnopqrstuvwxyzé'-?!.♂$×/,♀0123456789`
+
+And the following special characters (these each take up one character):
+* `<'d>`
+* `<'l>`
+* `<'t>`
+* `<'v>`
+* `<'r>`
+* `<'m>`
+* `<PK>`
+* `<MN>`
+* `<MALE>` alias for `♂`
+* `<FEMALE>` alias for `♀`
+
+## Joining a MultiWorld Game
+
+### Obtain your Pokémon patch file
+
+When you join a multiworld game, you will be asked to provide your YAML file to whoever is hosting. Once that is done,
+the host will provide you with either a link to download your data file, or with a zip file containing everyone's data
+files. Your data file should have a `.apred` or `.apblue` extension.
+
+Double-click on your patch file to start your client and start the ROM patch process. Once the process is finished
+(this can take a while), the client and the emulator will be started automatically (if you associated the extension
+to the emulator as recommended).
+
+### Connect to the Multiserver
+
+Once both the client and the emulator are started, you must connect them. Within the emulator click on the "Tools"
+menu and select "Lua Console". Click the folder button or press Ctrl+O to open a Lua script.
+
+Navigate to your Archipelago install folder and open `data/lua/PKMN_RB/pkmr_rb.lua`.
+
+To connect the client to the multiserver simply put `<address>:<port>` on the textfield on top and press enter (if the
+server uses password, type in the bottom textfield `/connect <address>:<port> [password]`)
+
+Now you are ready to start your adventure in Kanto.