Jump to content

Installing Mods: Difference between revisions

From SA Docs
mNo edit summary
mNo edit summary
Line 70: Line 70:
== Installing Mods Manually ==
== Installing Mods Manually ==
To install a mod manually, you need to create a subfolder in the <code>mods</code> folder (located in your game folder) and extract the mod's contents there. Do not extract mods directly to the <code>mods</code> folder! Each mod should be in a separate subfolder:
To install a mod manually, you need to create a subfolder in the <code>mods</code> folder (located in your game folder) and extract the mod's contents there. Do not extract mods directly to the <code>mods</code> folder! Each mod should be in a separate subfolder:
[[File:Installing mods 1759686345299.png|frameless]]
[[File:Installing mods 1759686345299.png|frameless]]

Revision as of 17:47, 5 October 2025

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

Prerequisites

Make sure you have the following version of the game installed. Other versions are not supported.

Sonic Adventure DX Sonic Adventure 2
2004 (US) Steam
2004 (EU)
Sonic PC Collection (2009)
Korean version (2004)
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. Download the latest version of the SA Mod Manager: 64-bit version (recommended) or 32-bit version (if running a 32-bit OS).
  2. Extract the archive where you would like the Manager to be located and run SAModManager.exe.
  3. Follow the instructions in the SA Mod Manager to locate the game folder and install the Mod Loader.
  4. Click Save and you should have a working modded game installation.

If your game version is different, you cannot install mods without using the SADX Mod Installer first.

Installing the Mod Loader + Manager on SA2 PC

If you only have SA2 PC, you can follow the same steps as above to run the SA Mod Manager, and point it to the SA2 game folder.

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: