How to archipelago for BmaN
One time installs
First of all, install the archipelago software. Can be found here: https://archipelago.gg/tutorial/Archipelago/setup/en
Do take note that this is installed in C:/ProgramData/archipelago by default, you'll need to be here. Or use the Archipelago Launcher to open this.
Next to that, since both Ape Escapes are in a non-supported state (ie not seen on archipelago.gg/games), those worlds need to be installed separetely. Simply download the latest apworlds and install them.
I'll link the install guides for both games, as they are quite specific and I don't want to update them myself in the future. Use these for general install help for the apworlds, emulators, and YAML creation. More about that later though.
Ape Escape 3: https://github.com/aidanii24/ae3-archipelago
Ape Escape 1: https://github.com/Thedragon005/Archipelago-Ape-Escape/blob/apeescape/worlds/apeescape/docs/setup_en.md
General knowledge:
Install an apworld (aka the archipelago files) into the setupfolder/custom_worlds folder, this works by simply doubleclicking it under normal circumstances
- In both games you're given "yaml" files. These are pretty much setup guides. How these are structured are a lottery.
For example, if you have:Goal_Target: specter: 20 specter_final: 40 triple_threat: 0
This means that there are 60 tickets in the raffle. Of which whenever you generate the seed, you have a 20/60 chance of getting spec 1, and 40/60 chance of having to defeat spec 2 as the main goal. What I do generally is pick 1, give it like 50 for funsies, and the rest 0 if I know what I want to do.
Also make sure that the names on top are not the same. I'd recommend BmaNAE and BmaNAE3.
Playing a game
After filling in both YAMLs, put them in C:/ProgramData/archipelago/players (or open the launcher, click "Browse Files" on the left, then open Players). It only captures the root. I got a few folders with "pre-made yamls" in case I want to do fast switches.
To generate a game, in the Archipelago Launcher, click "Generate" (2nd button). If everything is alright, the CMD window will disappear in a bit. If it errors out, you'll see the error message. This will generate a ZIP file in the output folder, called AP_numbers.zip
Upload that to https://archipelago.gg/uploads and a seed has been hosted. From here, you can make rooms. Making multiple rooms will have the same randomization, clicking the "generate" button in the program will re-roll everything.
When you're in the room, you'll see some things that are not too important from there, the only important thing is the port number (first paragraph, last row, the 5 digits in yellow). Keep this nearby
If you have the emulator open, game loaded, and in Ape Escape 1 have loaded the Tools -> Lua Console -> Generic connector LUA script, open the clients for the games you'd like to play.
Ape 1: Bizhawk Client
Ape 3: Ape Escape 3 client
In the top of these clients, fill in the connection thingy:
BmaN:[email protected]:XXXXX
Where BmaN is the name of your "world" (my example would be BmaNAE3 for ape 3), and XXXXX would be the port number.
If you click connect and no superbig errors arise, you can play. Catch a monkey and see if you see text appear in these clients.