Yoku's Island Adventure Randomizer Mod

Required Software

• Yoku's Island Adventure, from:
  • GOG.com,
  • Epic Games or
  • Steam
• This Mod

Optional Software

• For generating multiworld games: Archipelago and the Yoku's Island Express APWorld

• For sending commands: an archipelago text client.

Installation

Download yam-x.y.z.tgz from the releases page, and extract it into the game folder.

Launching

Launch the yam-launcher.exe file however you normally launch the game:

GOG

It should be enough to just click yam-launcher.exe, or make a shortcut, or whatever.

Epic

It should still work to simply open yam-launcher.exe; the game may complain about not being launched from the Epic launcher, but it will still run.

Steam

Windows

Modify "Launch Options" to read:

"C:\...\yam-launcher.exe" %COMMAND%

Replace C:\...\yam-launcher.exe with the correct full path to yam-launcher.exe.

Linux

Set your game's "Launch Options" to:

./yam-proton.sh %COMMAND%

Opening a game and connecting to a server.

To open an archipelago game from the main menu:

1. Select "Continue"
2. Select an empty slot
3. Select "Randomize mode"
4. Set the difficulty to "Archipelago"
5. Choose any start option.
6. When the beginning animation ends, the game will prompt you for server/slot/password.

Bugs and Peculiarities

I can't see Yoku

If it's the beginning of the game, this may be because a dialog popped up before Yoku washed up. You're just off-screen to the left; walk right to fix it.

I can't get into the Boiling Underbelly

This is a known issue when the Key to the Underbelly is received as a remote item. To fix it, just save and then Reload from Checkpoint (you don't have to exit your game).

This isn't working on my system

If the game is starting but can't connect to a server, you may be experiencing an issue with your wine prefix's certificate store. To fix it, try running internet explorer (wine iexplorer.exe) and then closing it. If that doesn't do the trick another reported fix is building the project from source.

If you're not on linux, or the above fixes don't work, let me know about it!

For anything else

The issue tracker is the best place to let me know about it.

Building

On Linux

You will need msvc-wine, GNU make, and cmake.

Download the source, switch to the directory, and run make. If that runs successfuly, then yam-<VERSION>.tgz will be in the build folder.

On Windows

You will need Visual Studio and cmake.

Download the source, switch to the directory, and run:

cmake -Bbuild .
cmake --build build --config Release

NOTE: The project will only compile if you choose the Release config because the Debug and Release versions of the std library are incompatible, and the game is compiled against the Release version.