9.5 KiB
Sonic Adventure 2: Battle Randomizer Setup Guide
Required Software
- Sonic Adventure 2: Battle from: Sonic Adventure 2: Battle Steam Store Page
- The Battle DLC is required if you choose to add Chao Karate locations to the randomizer
- SA Mod Manager from: SA Mod Manager GitHub Releases Page
- .NET Desktop Runtime 7.0 from: .NET Desktop Runtime 7.0 Download Page
- Archipelago Mod for Sonic Adventure 2: Battle from: Sonic Adventure 2: Battle Archipelago Randomizer Mod Releases Page
Optional Software
- Sonic Adventure 2 Tracker
- PopTracker from: PopTracker Releases Page
- Sonic Adventure 2: Battle Archipelago PopTracker pack from: SA2B AP Tracker Releases Page
- Quality of life mods
- SA2 Volume Controls from: [SA2 Volume Controls Release Page] (https://gamebanana.com/mods/381193)
- Sonic Adventure DX from: Sonic Adventure DX Steam Store Page
- For setting up the
SADX Music
option (See Additional Options for instructions).
- For setting up the
Installation Procedures (Windows)
-
Install Sonic Adventure 2: Battle from Steam.
-
Launch the game at least once without mods.
-
Install SA Mod Manager as per its instructions.
-
Unpack the Archipelago Mod into the
/mods
directory in the folder into which you installed Sonic Adventure 2: Battle, so that/mods/SA2B_Archipelago
is a valid path. -
In the SA2B_Archipelago folder, run the
CopyAPCppDLL.bat
script (a window will very quickly pop up and go away). -
Launch the
SAModManager.exe
and make sure the SA2B_Archipelago mod is listed and enabled.
Installation Procedures (Linux and Steam Deck)
-
Install Sonic Adventure 2: Battle from Steam.
-
In the properties for Sonic Adventure 2 on Steam, force the use of Proton Experimental as the compatibility tool.
-
Launch the game at least once without mods.
-
Create both a
/mods
directory and a/SAManager
directory in the folder into which you installed Sonic Adventure 2: Battle. -
Install SA Mod Manager as per its instructions. Specifically, extract SAModManager.exe file to the folder that Sonic Adventure 2: Battle is installed to. To launch it, add
SAModManager.exe
as a non-Steam game. In the properties on Steam for SA Mod Manager, set it to use Proton as the compatibility tool. -
Run SAModManager.exe from Steam once. It should produce an error popup for a missing dependency, close the error.
-
Install protontricks, on the Steam Deck this can be done via the Discover store, on other distros instructions vary, see its github page.
-
Download the .NET 7 Desktop Runtime for x64 Windows. If this link does not work, the download can be found on this page.
-
Right click the .NET 7 Desktop Runtime exe, and assuming protontricks was installed correctly, the option to "Open with Protontricks Launcher" should be available. Click that, and in the popup window that opens, select SAModManager.exe. Follow the prompts after this to install the .NET 7 Desktop Runtime for SAModManager. Once it is done, you should be able to successfully launch SAModManager to steam.
-
Unpack the Archipelago Mod into this folder, so that
/mods/SA2B_Archipelago
is a valid path. -
In the SA2B_Archipelago folder, copy the
APCpp.dll
file and paste it in the Sonic Adventure 2 install folder (wheresonic2app.exe
is). -
Launch
SAModManager.exe
from Steam and make sure the SA2B_Archipelago mod is listed and enabled.
Note: Ensure that you launch Sonic Adventure 2 from Steam directly on Linux, rather than launching using the Save & Play
button in SA Mod Manager.
Joining a MultiWorld Game
-
Before launching the game, run the
SAModManager.exe
, select the SA2B_Archipelago mod, and hit theConfigure Mod
button. -
For the
Server IP
field underAP Settings
, enter the address of the server, such as archipelago.gg:38281, your server host should be able to tell you this. -
For the
PlayerName
field underAP Settings
, enter your "name" field from the yaml, or website config. -
For the
Password
field underAP Settings
, enter the server password if one exists, otherwise leave blank. -
Click The
Save
button then hitSave & Play
to launch the game. On Linux, launch Sonic Adventure 2 from Steam directly rather than usingSave & Play
. -
Create a new save to connect to the MultiWorld game. A "Connected to Archipelago" message will appear if you sucessfully connect. If you close the game during play, you can reconnect to the MultiWorld game by selecting the same save file slot.
Additional Options
Some additional settings related to the Archipelago messages in game can be adjusted in the SAModManager if you select Configure Mod
on the SA2B_Archipelago mod. This settings will be under a General Settings
tab.
- Message Display Count: This is the maximum number of Archipelago messages that can be displayed on screen at any given time.
- Message Display Duration: This dictates how long Archipelago messages are displayed on screen (in seconds).
- Message Font Size: The is the size of the font used to display the messages from Archipelago.
If you wish to use the SADX Music
option of the Randomizer, you must own a copy of Sonic Adventure DX
on Steam, and follow these steps:
-
Find the folder on your PC where
Sonic Adventure DX
is installed. -
Enter the
SoundData
folder in theSonic Adventure DX
installation folder, and copy thebgm
folder. -
Paste the
bgm
folder into theADX
folder which exists within thegd_PC
folder in yourSA2B_Archipelago
mod folder.
Troubleshooting
-
"The following mods didn't load correctly: SA2B_Archipelago: DLL error - The specified module could not be found."
- Make sure the
APCpp.dll
is in the same folder as thesonic2app.exe
. (See Installation Procedures step 6)
- Make sure the
-
"sonic2app.exe - Entry Point Not Found"
- Make sure the
APCpp.dll
is up to date. Follow Installation Procedures step 6 to update the dll.
- Make sure the
-
Game is running too fast (Like Sonic).
- Limit framerate using the mod manager:
- Launch
SAModManager.exe
. - Select the
Game Config
tab, then select thePatches
subtab. - Check the
Lock framerate
box under the Patches section. - Press the
Save
button.
- Launch
- If using an NVidia graphics card:
- Open the NVIDIA Control Panel.
- Select
Manage 3D Settings
under3D settings
on the left. - Select the
Program Settings
tab in the main window. - Click the
Add
button and selectsonic2app.exe
(or browse to the exe location), then clickAdd Selected Program
. - Under
Specify the settings for this program:
, find theMax Frame Rate
feature and click the Setting column for that feature. - Choose the
On
radial option and in the input box next to the slide enter a value of 60 (or 59 if 60 causes the game to crash).
- Limit framerate using the mod manager:
-
Controller input is not working.
- Run the Launcher.exe which should be in the same folder as the your Sonic Adventure 2: Battle install.
- Select the
Player
tab and reselect the controller for the player 1 input method. - Click the
Save settings and launch SONIC ADVENTURE 2
button. (Any mod manager settings will apply even if the game is launched this way rather than through the mod manager)
-
Game crashes after display logos.
- This may be caused by a high monitor refresh rate.
- Change the monitor refresh rate to 60 Hz [Change display refresh rate on Windows] (https://support.microsoft.com/en-us/windows/change-your-display-refresh-rate-in-windows-c8ea729e-0678-015c-c415-f806f04aae5a)
- This may also be fixed by setting Windows 7 compatibility mode on the sonic app:
- Right click on the sonic2app.exe and select
Properties
. - Select the
Compatibility
tab. - Check the
Run this program in compatility mode for:
box and select Windows 7 in the drop down. - Click the
Apply
button.
- Right click on the sonic2app.exe and select
- This may be caused by a high monitor refresh rate.
-
No resolution options in the Launcher.exe.
- In the
Graphics device
dropdown, select the device and display you plan to run the game on. TheResolution
dropdown should populate once a graphics device is selected.
- In the
-
No music is playing in the game.
- If you enabled an
SADX Music
option, then most likely the music data was not copied properly into the mod folder (See Additional Options for instructions).
- If you enabled an
-
Mission 1 is missing a texture in the stage select UI.
- Most likely another mod is conflicting and overwriting the texture pack. It is recommeded to have the SA2B Archipelago mod load last in the mod manager.
Save File Safeguard (Advanced Option)
The mod contains a save file safeguard which associates a savefile to a specific Archipelago seed. By default, save files can only connect to Archipelago servers that match their seed. The safeguard can be disabled in the mod config.ini by setting IgnoreFileSafety
to true. This is NOT recommended for the standard user as it will allow any save file to connect and send items to the Archipelago server.