Pokemon Emerald: Implement New Game (#1813)
This commit is contained in:
Bryce Wilson
78
worlds/pokemon_emerald/docs/en_Pokemon Emerald.md
Normal file
78
worlds/pokemon_emerald/docs/en_Pokemon Emerald.md
Normal file
@@ -0,0 +1,78 @@
|
||||
# Pokémon Emerald
|
||||
|
||||
## Where is the settings page?
|
||||
|
||||
You can read through all the settings and generate a YAML [here](../player-settings).
|
||||
|
||||
## What does randomization do to this game?
|
||||
|
||||
This randomizer handles both item randomization and pokémon randomization. Badges, HMs, gifts from NPCs, and items on
|
||||
the ground can all be randomized. There are also many options for randomizing wild pokémon, starters, opponent pokémon,
|
||||
abilities, types, etc… You can even change a percentage of single battles into double battles. Check the
|
||||
[settings page](../player-settings) for a more comprehensive list of what can be changed.
|
||||
|
||||
## What items and locations get randomized?
|
||||
|
||||
The most interesting items that can be added to the item pool are badges and HMs, which most affect what locations you
|
||||
can access. Key items like the Devon Scope or Mach Bike can also be randomized, as well as the many Potions, Revives,
|
||||
TMs, and other items that you can find on the ground or receive as gifts.
|
||||
|
||||
## What other changes are made to the game?
|
||||
|
||||
There are many quality of life improvements meant to speed up the game a little and improve the experience of playing a
|
||||
randomizer. Here are some of the more important ones:
|
||||
|
||||
- Shoal Cave switches between high tide and low tide every time you re-enter
|
||||
- Bag space is greatly expanded (you're all but guaranteed to never need to store items in the PC)
|
||||
- Trade evolutions have been changed to level or item evolutions
|
||||
- You can have both bikes simultaneously
|
||||
- You can run or bike (almost) anywhere
|
||||
- The Wally catching tutorial is skipped
|
||||
- All text is instant, and with a setting it can be automatically progressed by holding A
|
||||
- When a Repel runs out, you will be prompted to use another
|
||||
- Many more minor improvements…
|
||||
|
||||
## Where is my starting inventory?
|
||||
|
||||
Except for badges, your starting inventory will be in the PC.
|
||||
|
||||
## What does another world's item look like in Pokémon Emerald?
|
||||
|
||||
When you find an item that is not your own, you will instead receive an "ARCHIPELAGO ITEM" which will *not* be added to
|
||||
your inventory.
|
||||
|
||||
## When the player receives an item, what happens?
|
||||
|
||||
You will only receive items while in the overworld and not during battles. Depending on your `Receive Item Messages`
|
||||
setting, the received item will either be silently added to your bag or you will be shown a text box with the item's
|
||||
name and the item will be added to your bag while a fanfare plays.
|
||||
|
||||
## Can I play offline?
|
||||
|
||||
Yes, the client and connector are only necessary for sending and receiving items. If you're playing a solo game, you
|
||||
don't need to play online unless you want the rest of Archipelago's functionality (like hints and auto-tracking). If
|
||||
you're playing a multiworld game, the client will sync your game with the server the next time you connect.
|
||||
|
||||
## Will battle mechanics be updated?
|
||||
|
||||
This is something we'd love to see, but it's unlikely. We don't want to force new mechanics on players who would prefer
|
||||
to play with the classic mechanics, but trying to switch between old and new mechanics based on an option would be a
|
||||
monumental task, and is probably best solved some other way.
|
||||
|
||||
## Is this randomizer compatible with other mods?
|
||||
|
||||
No, other mods cannot be applied. It would be impossible to generalize this implementation's changes in a way that is
|
||||
compatible with any other mod or romhack. Romhacks could be added as their own games, but they would have to be
|
||||
implemented separately. Check out [Archipelago's Discord server](https://discord.gg/8Z65BR2) if you want to make a
|
||||
suggestion or contribute.
|
||||
|
||||
## Can I use tools like the Universal Pokémon Randomizer?
|
||||
|
||||
No, those tools expect data to be in certain locations and in a certain format, but this randomizer has to shift it
|
||||
around. Using tools to try to modify the game would only corrupt the ROM.
|
||||
|
||||
We realize this means breaking from established habits when it comes to randomizing Pokémon games, but this randomizer
|
||||
would be many times more complex to develop if it were constrained by something like UPR.
|
||||
|
||||
The one exception might be PKHeX. You may be able to extract pokémon from your save using PKHeX, but this isn't a
|
||||
guarantee, and we make no effort to keep our saves compatible with PKHeX.
|
||||
72
worlds/pokemon_emerald/docs/setup_en.md
Normal file
72
worlds/pokemon_emerald/docs/setup_en.md
Normal file
@@ -0,0 +1,72 @@
|
||||
# Pokémon Emerald Setup Guide
|
||||
|
||||
## Required Software
|
||||
|
||||
- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases)
|
||||
- An English Pokémon Emerald ROM. The Archipelago community cannot provide this.
|
||||
- [BizHawk](https://tasvideos.org/BizHawk/ReleaseHistory) 2.7 or later
|
||||
|
||||
### Configuring BizHawk
|
||||
|
||||
Once you have installed BizHawk, open `EmuHawk.exe` and change the following settings:
|
||||
|
||||
- If you're using BizHawk 2.7 or 2.8, go to `Config > Customize`. On the Advanced tab, switch the Lua Core from
|
||||
`NLua+KopiLua` to `Lua+LuaInterface`, then restart EmuHawk. (If you're using BizHawk 2.9, you can skip this step.)
|
||||
- Under `Config > Customize`, check the "Run in background" option to prevent disconnecting from the client while you're
|
||||
tabbed out of EmuHawk.
|
||||
- Open a `.gba` file in EmuHawk and go to `Config > Controllers…` to configure your inputs. If you can't click
|
||||
`Controllers…`, load any `.gba` ROM first.
|
||||
- Consider clearing keybinds in `Config > Hotkeys…` if you don't intend to use them. Select the keybind and press Esc to
|
||||
clear it.
|
||||
|
||||
## Optional Software
|
||||
|
||||
- [Pokémon Emerald AP Tracker](https://github.com/AliceMousie/emerald-ap-tracker/releases/latest), for use with
|
||||
[PopTracker](https://github.com/black-sliver/PopTracker/releases)
|
||||
|
||||
## Generating and Patching a Game
|
||||
|
||||
1. Create your settings file (YAML). You can make one on the
|
||||
[Pokémon Emerald settings page](../../../games/Pokemon%20Emerald/player-settings).
|
||||
2. Follow the general Archipelago instructions for [generating a game](../../Archipelago/setup/en#generating-a-game).
|
||||
This will generate an output file for you. Your patch file will have the `.apemerald` file extension.
|
||||
3. Open `ArchipelagoLauncher.exe`
|
||||
4. Select "Open Patch" on the left side and select your patch file.
|
||||
5. If this is your first time patching, you will be prompted to locate your vanilla ROM.
|
||||
6. A patched `.gba` file will be created in the same place as the patch file.
|
||||
7. On your first time opening a patch with BizHawk Client, you will also be asked to locate `EmuHawk.exe` in your
|
||||
BizHawk install.
|
||||
|
||||
If you're playing a single-player seed and you don't care about autotracking or hints, you can stop here, close the
|
||||
client, and load the patched ROM in any emulator. However, for multiworlds and other Archipelago features, continue
|
||||
below using BizHawk as your emulator.
|
||||
|
||||
## Connecting to a Server
|
||||
|
||||
By default, opening a patch file will do steps 1-5 below for you automatically. Even so, keep them in your memory just
|
||||
in case you have to close and reopen a window mid-game for some reason.
|
||||
|
||||
1. Pokemon Emerald uses Archipelago's BizHawk Client. If the client isn't still open from when you patched your game,
|
||||
you can re-open it from the launcher.
|
||||
2. Ensure EmuHawk is running the patched ROM.
|
||||
3. In EmuHawk, go to `Tools > Lua Console`. This window must stay open while playing.
|
||||
4. In the Lua Console window, go to `Script > Open Script…`.
|
||||
5. Navigate to your Archipelago install folder and open `data/lua/connector_bizhawk_generic.lua`.
|
||||
6. The emulator may freeze every few seconds until it manages to connect to the client. This is expected. The BizHawk
|
||||
Client window should indicate that it connected and recognized Pokemon Emerald.
|
||||
7. To connect the client to the server, enter your room's address and port (e.g. `archipelago.gg:38281`) into the
|
||||
top text field of the client and click Connect.
|
||||
|
||||
You should now be able to receive and send items. You'll need to do these steps every time you want to reconnect. It is
|
||||
perfectly safe to make progress offline; everything will re-sync when you reconnect.
|
||||
|
||||
## Auto-Tracking
|
||||
|
||||
Pokémon Emerald has a fully functional map tracker that supports auto-tracking.
|
||||
|
||||
1. Download [Pokémon Emerald AP Tracker](https://github.com/AliceMousie/emerald-ap-tracker/releases/latest) and
|
||||
[PopTracker](https://github.com/black-sliver/PopTracker/releases).
|
||||
2. Put the tracker pack into packs/ in your PopTracker install.
|
||||
3. Open PopTracker, and load the Pokémon Emerald pack.
|
||||
4. For autotracking, click on the "AP" symbol at the top.
|
||||
5. Enter the Archipelago server address (the one you connected your client to), slot name, and password.
|
||||
Reference in New Issue
Block a user