Rayman 2 for Archipelago

A mod for Rayman 2 built on the Twofold mod loader to add support to Rayman 2 for using it with the Archipelago mutli-world randomizer.

This mod is implemented in two parts:

• Rayman2Connector is a standalone exe placed in the game directory. This is a C++ program which implements the AP client using N00byKing's APCpp.
• Rayman2APMod is a dll mod installed with Twofold which gets injected into the game. It requires the Rayman2Connector.exe to be present so it can boot it as a subprocess and communicate with it. This is done as Rayman 2 is written in C and it is easier to use the existing AP client written in C++.

There is also a DLLDebugger module available which was used to test the connector module as executed from the C code.

Absolutely gigantic credit goes to Spitfire_x86 for their incredible work on making the mod loader and so many useful mods without which this would be absolutely impossible.

This work is based on R2DbgScr and R2Console by Spitfire_x86. Parts derived from these projects are under the copyright of Spitfire_x86.

How to install

This mod is still a work-in-progress, these instructions currently only cover installing the mod itself and not generating the game through Archipelago.

1. Install the GOG version of Rayman 2 using the standalone installer. You might be able to use the Uplay/Ubisoft Connect version but this is not supported and may cause issues. Any retail CD/DVD versions are not supported as their built-in DRM is broken on modern hardware.
2. Install Ray2Fix by downloading the zip file of its latest release and extracting the contents of the zip into the Rayman 2 game folder.
3. Run R2FixCfg.exe and choose your preferred display settings in the General tab.
4. Install Twofold by downloading the zip file of its latest release and extracting the contents of the zip into the Rayman 2 game folder.
5. Install R2Console by downloading the zip file of its latest release and extracting the contents of the zip into the Rayman 2 game folder.
6. Download the latest release of this project, extracting the contents of the zip into the Rayman 2 game folder.
7. Run the game through Ray2x.exe to launch the modded version. Rayman2.exe will launch the unmodded version of the game.
8. In-game you can press ~ to open up the console. Use the ap connect <ip> <slot> [password] command to connect to an Archipelago room.
9. Starting a new game after connecting to a room will use the configured random settings.