Jump to content

Installing Mods: Difference between revisions

From SA Docs
mNo edit summary
Line 81: Line 81:


== Installing the Mod Loader + Manager on SA2 PC ==
== Installing the Mod Loader + Manager on SA2 PC ==
If you only have SA2 PC, you can follow the same steps as [[Installing mods#Installing the Mod Loader + Manager on SADX PC (2004) Manually|above]] to run the SA Mod Manager and point it to the SA2 game folder.
If you only have SA2 PC, you can follow these steps to run the SA Mod Manager and point it to the SA2 game folder:
 
# Install the [[Installing Mods#Installing Dependencies|dependencies]].
# Download the latest version of the SA Mod Manager:  [https://github.com/X-Hax/SA-Mod-Manager/releases/latest/download/release_x64.zip 64-bit version (recommended)] or [https://github.com/X-Hax/SA-Mod-Manager/releases/latest/download/release_x86.zip 32-bit version (if running a 32-bit OS)].
# Extract the archive where you would like the Manager to be located and run <code>SAModManager.exe</code>.
# Follow the instructions in the SA Mod Manager to locate the game folder and install the Mod Loader.
# Click <code>Save</code> and you should have a working modded game installation.


If you have both SADX and SA2 and already have installed the SA Mod Manager on one game, you can click the game title on the bottom right of the Manager's main window and select <code>Add Game...</code>. After you finish adding the game, you will be able to toggle between them in the manager.
If you have both SADX and SA2 and already have installed the SA Mod Manager on one game, you can click the game title on the bottom right of the Manager's main window and select <code>Add Game...</code>. After you finish adding the game, you will be able to toggle between them in the manager.

Revision as of 04:30, 6 October 2025

This guide explains how to install mods on PC versions of SADX and SA2(B).

Prerequisites

Make sure you have one of the following versions of the game(s) installed. Other versions are not supported.

Sonic Adventure DX 2004 (US) 2004 (EU) Sonic PC Collection (2009) Korean version (2004) Steam
Sonic Adventure 2 Steam

Installing the Mod Loader on SADX the Easy Way

The SADX Mod Installer automatically prepares your game for modding and installs some mods. You can select which mods to install by selecting a preset, picking mods manually or following an illustrated guide. It's really easy!

  1. Download the mod installer from this page.
  2. Run sadx_setup.exe and follow the instructions.

If you are not on Windows, a Linux guide for the installer is also available.

After the installation has finished, you will have a copy of the game with the Mod Manager and several mods.

Troubleshooting Download Errors with the Installer

Depending on your location and Internet Service Provider, you may run into the following issues:

  • SADX Mod Installer is unable to download mods
  • "SendRequest error" when using the web version of the installer
  • "SSL record too long" error when trying to download the Mod Installer
  • Various other SSL or connection errors that prevent you from updating PkR's mods or using the Mod Installer

This can happen because the domain dcmods.unreliable.network, which hosts the installer's files, was blacklisted by your Internet Service Provider as malicious.

First, try using the offline version of the installer. If that doesn't help, for a short-term solution you can use a VPN to circumvent the block. However, you will not be able to update some mods without a VPN. For a long-term solution, contact your ISP's tech support and tell them to unblacklist dcmods.unreliable.network.

Why was the domain blacklisted? We don't know, but we can't fix this ourselves. Please help us make the installer and mods more accessible by reporting the domain and the installer's files as false positives on all sites that claim it's malware (because it isn't!).

Installing the Mod Loader + Manager on SADX PC (2004) Manually

If you have the 2004 (US) version of the PC port, you can install the Mod Loader and the Mod Manager manually using the following steps:

  1. Make sure you have the 2004 US version of the game installed. If your game version is different, you cannot install mods without using the SADX Mod Installer first.
  2. Install the dependencies.
  3. Download the latest version of the SA Mod Manager: 64-bit version (recommended) or 32-bit version (if running a 32-bit OS).
  4. Extract the archive where you would like the Manager to be located and run SAModManager.exe.
  5. Follow the instructions in the SA Mod Manager to locate the game folder and install the Mod Loader.
  6. Click Save and you should have a working modded game installation.

Installing Dependencies

Note: If you have used the SADX Mod Installer, you can skip this step.

To be able to play the modded game and use the Mod Manager, you need to have the following things installed:

.NET 8.0 Desktop Runtime (for SA Mod Manager)

The Mod Manager requires the .NET 8.0 Desktop runtime. You can download it here.

x64 version (recommended)

x86 version (if using a 32-bit version of the SA Mod Manager)

Visual C++ runtimes

The Mod Loader and most mods are compiled with Visual Studio 2022 and need the 2015/2022 runtime. Older mods may be compiled with Visual Studio 2010, 2012 or 2013.

To be able to play all mods, download and install all of the runtimes using the links below.

The links are for x86 runtimes. You DON'T need x64 runtimes.

2015/2022

2013 U5 + AVX fix:

2012 U4

2010 SP1

DirectX 9.0c End-User Runtimes

You can download them here. DirectX 9 is NOT installed by default, so this is a required step.

Installing the Mod Loader + Manager on SA2 PC

If you only have SA2 PC, you can follow these steps to run the SA Mod Manager and point it to the SA2 game folder:

  1. Install the dependencies.
  2. Download the latest version of the SA Mod Manager: 64-bit version (recommended) or 32-bit version (if running a 32-bit OS).
  3. Extract the archive where you would like the Manager to be located and run SAModManager.exe.
  4. Follow the instructions in the SA Mod Manager to locate the game folder and install the Mod Loader.
  5. Click Save and you should have a working modded game installation.

If you have both SADX and SA2 and already have installed the SA Mod Manager on one game, you can click the game title on the bottom right of the Manager's main window and select Add Game.... After you finish adding the game, you will be able to toggle between them in the manager.

Installing Mods with 1-click Install

The SA Mod Manager comes with an easy way to install mods from specially formatted links. After running the Manager at least once, you should be able to simply click supported links on webpages, and the Manager will show a prompt to install the mod. If that doesn't work for you, you can click the Manager's Add Mod button, select Installing from an URL, and paste the link in the box, then click OK.

Mod download links for SADX mods start with sadxmm:, and mod download links for SA2 mods start with sa2mm:.

Installing Mods Manually

To install a mod manually, you need to create a subfolder in the mods folder (located in your game folder) and extract the mod's contents there. Do not extract mods directly to the mods folder! Each mod should be in a separate subfolder:

Note that mods may require additional dependencies, such as Visual C++ runtimes or other mods.