Game Troubleshooting Guide - Revision history

PkR at 00:07, 14 October 2025

2025-10-14T00:07:26Z

← Older revision		Revision as of 00:07, 14 October 2025
Line 36:		Line 36:
	'''1-click installation is supported only on Windows. If you're on Linux, you can install mods from 1-click links using the <code>Add Mod</code> button.'''		'''1-click installation is supported only on Windows. If you're on Linux, you can install mods from 1-click links using the <code>Add Mod</code> button.'''

	=== Error 403 on ~~updating mods~~ ===		=== Error 403 on Updating Mods ===
	If you're getting a 403 error when trying to update GitHub-hosted mods, it means GitHub has temporarily banned your IP address because there were too many requests. Wait a while and try again.		If you're getting a 403 error when trying to update GitHub-hosted mods, it means GitHub has temporarily banned your IP address because there were too many requests. Wait a while and try again.

	=== Error 443 on ~~updating mods~~ ===		=== Error 443 on Updating Mods ===
	Error 443 indicates a connection error. It's most likely caused by issues with your Internet connection, your service provider or firewall blocking connections to our servers, or the servers themselves being offline.		Error 443 indicates a connection error. It's most likely caused by issues with your Internet connection, your service provider or firewall blocking connections to our servers, or the servers themselves being offline.

Line 49:		Line 49:
	== SADX Mod Installer Issues ==		== SADX Mod Installer Issues ==

	=== SADX Mod Installer ~~download~~ and ~~access errors, mod update errors~~ ===		=== SADX Mod Installer Download and Access Errors ===

	=== "SendRequest error" when ~~using~~ the ~~web version~~ of the ~~installer~~ ===		=== "SendRequest error" when Using the Web Version of the Installer ===

	=== "SSL ~~record too long~~" ~~error~~ when ~~trying~~ to ~~download~~ the Mod Installer ===		=== "SSL Record Too Long" Error when Trying to Download the Mod Installer ===

	=== ~~Various other~~ SSL or ~~connection errors that prevent you from using the Mod Installer~~ ===		=== Other SSL or Connection Errors ===
	This can happen because the domain <code>dcmods.unreliable.network</code> was blacklisted by your Internet service provider as malicious.		This can happen because the domain <code>dcmods.unreliable.network</code> was blacklisted by your Internet service provider as malicious.

PkR at 00:05, 14 October 2025

2025-10-14T00:05:05Z

← Older revision		Revision as of 00:05, 14 October 2025
Line 34:		Line 34:
	# Click "Install Mod Loader".		# Click "Install Mod Loader".
	# If the above doesn't work, import [https://dcmods.unreliable.network/owncloud/data/PiKeyAr/files/sadocs/Remove_SA_Mod_Manager_1-click_support.reg this registry file] and try again.		# If the above doesn't work, import [https://dcmods.unreliable.network/owncloud/data/PiKeyAr/files/sadocs/Remove_SA_Mod_Manager_1-click_support.reg this registry file] and try again.
			'''1-click installation is supported only on Windows. If you're on Linux, you can install mods from 1-click links using the <code>Add Mod</code> button.'''

	=== Error 403 on updating mods ===		=== Error 403 on updating mods ===
Line 107:		Line 108:
	=== "DLL Error - The Specified Module could not be Found" Error on Loading a Mod ===		=== "DLL Error - The Specified Module could not be Found" Error on Loading a Mod ===

	=== Error 0xc000007b when ~~trying~~ to ~~start~~ the ~~game~~ ===		=== Error 0xc000007b when Trying to Start the Game ===

	=== "Failed to load d3dx9_43.dll" when ~~trying~~ to ~~start~~ the ~~game~~ ===		=== "Failed to load d3dx9_43.dll" when Trying to Start the Game ===
	There are several things that can cause these errors:		There are several things that can cause these errors:

Line 115:		Line 116:

	* DirectX 9.0c end-user runtimes are missing. Download and install all of the runtimes from [[Installing Mods#DirectX 9.0c End-User Runtimes\|this page]].		* DirectX 9.0c end-user runtimes are missing. Download and install all of the runtimes from [[Installing Mods#DirectX 9.0c End-User Runtimes\|this page]].
	* The mod is missing the DLL file. In the Mod Manager, right click the mod and select <code>Verify integrity</code>. If any errors are detected, let the Mod Manager repair the mod and try again. If no errors are found, contact the mod developer.		* The mod is missing the DLL file. In the Mod Manager, right click the mod and select <code>Verify integrity</code> (only for mods that have a manifest). If any errors are detected, let the Mod Manager repair the mod and try again. If no errors are found, contact the mod developer.
	* The DLL file was compiled in Debug mode. If you have all the runtimes installed, the mod DLL file exists and you are still getting the error, contact the mod developer.		* The DLL file was compiled in Debug mode. If you have all the runtimes installed, the mod DLL file exists and you are still getting the error, contact the mod developer.
	'''The right way to install dependencies is to use official installers. DO NOT put individual DLL files in Windows system folders because that can break the installers, and your Windows installation will be stuck with wrong versions of the runtimes.''' '''If you ended up in this situation, see [https://learn.microsoft.com/en-us/answers/questions/4019413/missing-d3dcompiler-43-dll-unable-to-reinstall-usi this page].'''		'''The right way to install dependencies is to use official installers. DO NOT put individual DLL files in Windows system folders because that can break the official installers, and your Windows installation will be stuck with wrong versions of the runtimes.''' '''If you ended up in this situation, see [https://learn.microsoft.com/en-us/answers/questions/4019413/missing-d3dcompiler-43-dll-unable-to-reinstall-usi this page].'''

	'''Some tutorials tell you to put DLL files in the game folder. Such fixes are not recommended and should only be used as a last resort.'''		'''Some tutorials tell you to put DLL files in the game folder. Such fixes are not recommended and should only be used as a last resort.'''
Line 146:		Line 147:
	=== SADX: Input Issues: Controller not Detected, Spinning Camera, Wrong Button Layout etc. ===		=== SADX: Input Issues: Controller not Detected, Spinning Camera, Wrong Button Layout etc. ===

	# Make sure <code>Better Input</code> is enabled in Input options in the Mod Manager.		# Make sure <code>Better Input</code> is enabled in the <code>Game Config</code> tab's <code>Input</code> options in the Mod Manager.
	# Make sure your controller is detected and configured in SADX Launcher's <code>Controls</code> tab. If you don't have SADX Launcher, you can get it with the [https://sadxmodinstaller.unreliable.network/ SADX Mod Installer].		# Make sure your controller is detected and configured in SADX Launcher's <code>Controls</code> tab. If you don't have SADX Launcher, you can get it with the [https://sadxmodinstaller.unreliable.network/ SADX Mod Installer].
	# If you are using Steam Input, try disabling it.		# If you are using Steam Input, try disabling it.
Line 153:		Line 154:

	# Install [https://ds4-windows.com/ ds4windows] and use it in X360 emulation mode.		# Install [https://ds4-windows.com/ ds4windows] and use it in X360 emulation mode.
	# ~~Run~~ SADX Launcher ~~and~~ configure ~~the~~ axes and buttons ~~as usual~~.		# If necessary, run SADX Launcher to configure axes and buttons.

	== Where to Get Help ==		== Where to Get Help ==

PkR at 00:00, 14 October 2025

2025-10-14T00:00:10Z

← Older revision		Revision as of 00:00, 14 October 2025
Line 16:		Line 16:

	For SA2, simply download the SA Mod Manager from its release page and put it in your SA2 folder, then run it through Protontricks.		For SA2, simply download the SA Mod Manager from its release page and put it in your SA2 folder, then run it through Protontricks.
	~~Please note that if~~ you plan to use the Manager for both Adventure games on Linux, it is recommended to have a different copy of the Manager for each game, all in their respective game folder and just run them through Protontricks.
			'''If you plan to use the SA Mod Manager for both Adventure games on Linux, it is recommended to have a different copy of the Manager for each game, all in their respective game folder and just run them through Protontricks.'''

	=== The Game Crashes on Clicking <code>Save And Play</code> ===		=== The Game Crashes on Clicking <code>Save And Play</code> ===

PkR at 23:58, 13 October 2025

2025-10-13T23:58:06Z

← Older revision		Revision as of 23:58, 13 October 2025
Line 1:		Line 1:
	This guide contains solutions to most common problems related to Sonic Adventure games and their mods.		This guide contains solutions to most common problems related to Sonic Adventure games and their mods.

	== ~~Troubleshooting~~ SA Mod Manager ==		== SA Mod Manager Issues ==

	=== Mods and Codes don't Appear ===		=== Mods and Codes don't Appear ===

PkR at 23:57, 13 October 2025

2025-10-13T23:57:28Z

← Older revision		Revision as of 23:57, 13 October 2025
Line 106:		Line 106:
	=== "DLL Error - The Specified Module could not be Found" Error on Loading a Mod ===		=== "DLL Error - The Specified Module could not be Found" Error on Loading a Mod ===

	=== ~~'''~~Error 0xc000007b when trying to start the game~~'''~~ ===		=== Error 0xc000007b when trying to start the game ===

	=== ~~'''~~"Failed to load d3dx9_43.dll" when trying to start the game~~'''~~ ===		=== "Failed to load d3dx9_43.dll" when trying to start the game ===
	There are several things that can cause these errors:		There are several things that can cause these errors:

PkR at 23:56, 13 October 2025

2025-10-13T23:56:32Z

← Older revision		Revision as of 23:56, 13 October 2025
Line 74:		Line 74:
	# Restart your computer. The error should now be gone.		# Restart your computer. The error should now be gone.

	For other versions of Windows see [https://support.microsoft.com/en-us/topic/media-feature-pack-list-for-windows-n-editions-c1c6fffa-d052-8338-7a79-a4bb980a700a this~~] [https://support.microsoft.com/en-us/topic/media-feature-pack-list-for-windows-n-editions-c1c6fffa-d052-8338-7a79-a4bb980a700a~~ page] for further instructions.		For other versions of Windows see [https://support.microsoft.com/en-us/topic/media-feature-pack-list-for-windows-n-editions-c1c6fffa-d052-8338-7a79-a4bb980a700a this page] for further instructions.

	=== SADX: Missing Music and/or Character Voices ===		=== SADX: Missing Music and/or Character Voices ===
Line 146:		Line 146:

	# Make sure <code>Better Input</code> is enabled in Input options in the Mod Manager.		# Make sure <code>Better Input</code> is enabled in Input options in the Mod Manager.
	# Make sure your controller is detected and configured in SADX Launcher's <code>Controls</code> tab. If you don't have SADX Launcher, you can get it with the [[SADX Mod Installer]].		# Make sure your controller is detected and configured in SADX Launcher's <code>Controls</code> tab. If you don't have SADX Launcher, you can get it with the [https://sadxmodinstaller.unreliable.network/ SADX Mod Installer].
	# If you are using Steam Input, try disabling it.		# If you are using Steam Input, try disabling it.

PkR at 23:54, 13 October 2025

2025-10-13T23:54:57Z

Show changes

PkR at 15:09, 13 October 2025

2025-10-13T15:09:27Z

← Older revision		Revision as of 15:09, 13 October 2025
Line 3:		Line 3:
	== Troubleshooting SA Mod Manager ==		== Troubleshooting SA Mod Manager ==

	=== Mods and ~~codes~~ don't ~~appear~~ ===		=== Mods and Codes don't Appear ===
	This means you haven't selected the Game's location, unlike the previous Mod Manager, this Manager can work anywhere and with multiple games, so you have to set the game path manually.		This means you haven't selected the Game's location, unlike the previous Mod Manager, this Manager can work anywhere and with multiple games, so you have to set the game path manually.
	Note that if you had the previous Mod Manager before, you can directly update from it to install the new one and it will automatically set the game path for you in that scenario.		Note that if you had the previous Mod Manager before, you can directly update from it to install the new one and it will automatically set the game path for you in that scenario.
Line 11:		Line 11:
	You can download and run the [[SADX Mod Installer]] to convert your game to the 2004 version and install the Mod Manager automatically.		You can download and run the [[SADX Mod Installer]] to convert your game to the 2004 version and install the Mod Manager automatically.

	=== ~~How do I get mods to work~~ on Steam Deck ~~/ Linux?~~ ===		=== Mods on Linux and the Steam Deck ===
	For SADX, you can follow the guide [https://gitlab.com/PiKeyAr/sadx-mod-installer/-/wikis/SteamDeck here].		For SADX, you can follow the guide [https://gitlab.com/PiKeyAr/sadx-mod-installer/-/wikis/SteamDeck here].

Line 17:		Line 17:
	Please note that if you plan to use the Manager for both Adventure games on Linux, it is recommended to have a different copy of the Manager for each game, all in their respective game folder and just run them through Protontricks.		Please note that if you plan to use the Manager for both Adventure games on Linux, it is recommended to have a different copy of the Manager for each game, all in their respective game folder and just run them through Protontricks.

	=== The ~~game crashes when I click~~ on <code>Save And Play</code> ===		=== The Game Crashes on Clicking <code>Save And Play</code> ===

	* Make sure both your Manager and Loader are up to date/		* Make sure both your Manager and Loader are up to date/
Line 23:		Line 23:
	* If you're still having issues, check if your game starts fine without mods and codes (you can use the Profile feature in the Manager Config tab to save your mods list).		* If you're still having issues, check if your game starts fine without mods and codes (you can use the Profile feature in the Manager Config tab to save your mods list).

	=== SADX Launcher ~~displays an error~~: "Unable to ~~detect~~ SADX Mod Loader" ===		=== SADX Launcher Error: "Unable to Detect SADX Mod Loader" ===
	Go to your SADX game folder and delete <code>AppLauncher.exe</code> and the <code>AppLauncher</code> folder, then open the SA Mod Manager, click <code>Game Config</code>, <code>Input</code> and select <code>Get AppLauncher</code> to download the latest version.		Go to your SADX game folder and delete <code>AppLauncher.exe</code> and the <code>AppLauncher</code> folder, then open the SA Mod Manager, click <code>Game Config</code>, <code>Input</code> and select <code>Get AppLauncher</code> to download the latest version.

Line 85:		Line 85:
	# Enable "Resizable Window" in SADX Mod Manager's Graphics settings.		# Enable "Resizable Window" in SADX Mod Manager's Graphics settings.

	=== Can't ~~rebind keyboard keys~~ ===		=== Can't Rebind Keyboard Keys ===
	Keyboard binds from the Steam version won't work on the modded game because the modded game is based on an old version of SADX that doesn't support custom keybinds. However, you can rebind keys with the Input mod and a configuration tool that is included in the SADX Mod Installer. After using the installer, select <code>Configure Sonic Adventure DX</code> on Steam or run <code>AppLauncher.exe</code> in the SADX folder, and you will be able to change keys in the Controls tab.		Keyboard binds from the Steam version won't work on the modded game because the modded game is based on an old version of SADX that doesn't support custom keybinds. However, you can rebind keys with the Input mod and a configuration tool that is included in the SADX Mod Installer. After using the installer, select <code>Configure Sonic Adventure DX</code> on Steam or run <code>AppLauncher.exe</code> in the SADX folder, and you will be able to change keys in the Controls tab.

	=== Input ~~issues~~: Controller ~~isn't detected~~, ~~spinning camera~~, ~~button layout is wrong~~ etc. ===		=== Input Issues: Controller not Detected, Spinning Camera, Wrong Button Layout etc. ===

	# Make sure <code>Better Input</code> is enabled in Input options in the Mod Manager.		# Make sure <code>Better Input</code> is enabled in Input options in the Mod Manager.
Line 94:		Line 94:
	# If you are using Steam Input, try disabling it.		# If you are using Steam Input, try disabling it.

	=== Issues with Sony DualShock or Nintendo Switch Pro ~~controllers~~ ===		=== Issues with Sony DualShock or Nintendo Switch Pro Controllers ===

	# Install ds4windows and use it in X360 emulation mode.		# Install ds4windows and use it in X360 emulation mode.
	# Run SADX Launcher and configure the axes and buttons as usual.		# Run SADX Launcher and configure the axes and buttons as usual.

	== Where to ~~get help~~ ==		== Where to Get Help ==
	You can ask for help on the #troubleshooting channel on the [https://discord.com/invite/gqJCF47 x-hax Discord server].		You can ask for help on the #troubleshooting channel on the [https://discord.com/invite/gqJCF47 x-hax Discord server].

PkR: Created page with "This guide contains solutions to most common problems related to Sonic Adventure games and their mods. == Troubleshooting SA Mod Manager == === Mods and codes don't appear === This means you haven't selected the Game's location, unlike the previous Mod Manager, this Manager can work anywhere and with multiple games, so you have to set the game path manually. Note that if you had the previous Mod Manager before, you can directly update from it to install the new one and..."

2025-10-13T15:07:33Z

Created page with "This guide contains solutions to most common problems related to Sonic Adventure games and their mods. == Troubleshooting SA Mod Manager == === Mods and codes don't appear === This means you haven't selected the Game's location, unlike the previous Mod Manager, this Manager can work anywhere and with multiple games, so you have to set the game path manually. Note that if you had the previous Mod Manager before, you can directly update from it to install the new one and..."

New page

This guide contains solutions to most common problems related to Sonic Adventure games and their mods.

== Troubleshooting SA Mod Manager ==

=== Mods and codes don't appear ===
This means you haven't selected the Game's location, unlike the previous Mod Manager, this Manager can work anywhere and with multiple games, so you have to set the game path manually.
Note that if you had the previous Mod Manager before, you can directly update from it to install the new one and it will automatically set the game path for you in that scenario.

=== SADX Game Location Error on the Steam Version ===
The Steam version of SADX is not supported by our tools.
You can download and run the [[SADX Mod Installer]] to convert your game to the 2004 version and install the Mod Manager automatically.

=== How do I get mods to work on Steam Deck / Linux? ===
For SADX, you can follow the guide [https://gitlab.com/PiKeyAr/sadx-mod-installer/-/wikis/SteamDeck here].

For SA2, simply download the SA Mod Manager from its release page and put it in your SA2 folder, then run it through Protontricks.
Please note that if you plan to use the Manager for both Adventure games on Linux, it is recommended to have a different copy of the Manager for each game, all in their respective game folder and just run them through Protontricks.

=== The game crashes when I click on <code>Save And Play</code> ===

* Make sure both your Manager and Loader are up to date/
* Make sure that you have all of the Visual C++ Runtimes (x86) installed. See [[Installing Mods]] for more details.
* If you're still having issues, check if your game starts fine without mods and codes (you can use the Profile feature in the Manager Config tab to save your mods list).

=== SADX Launcher displays an error: "Unable to detect SADX Mod Loader" ===
Go to your SADX game folder and delete <code>AppLauncher.exe</code> and the <code>AppLauncher</code> folder, then open the SA Mod Manager, click <code>Game Config</code>, <code>Input</code> and select <code>Get AppLauncher</code> to download the latest version.

== Common Game Issues ==

=== Game doesn't Start (no Error Message) ===
If you have multiple monitors, try changing the Screen in SADX Mod Manager's Display tab.

=== "Windows Media Player 9 is not Installed" Error in SADX ===
SADX relies on Windows Media Player components, which are missing in some versions of Windows.
To install Windows Media features on Windows 10, do the following:

# In the Settings app, go to <code>Apps</code>, <code>Apps & features</code>, <code>Optional features</code>.

# Click <code>Add a feature</code>, find <code>Media Feature Pack</code> and install it.
# Restart your computer. The error should now be gone.

For other versions of Windows see [https://support.microsoft.com/en-us/topic/media-feature-pack-list-for-windows-n-editions-c1c6fffa-d052-8338-7a79-a4bb980a700a this] [https://support.microsoft.com/en-us/topic/media-feature-pack-list-for-windows-n-editions-c1c6fffa-d052-8338-7a79-a4bb980a700a page] for further instructions.

=== Missing Music and/or Character Voices ===
Check if your game has music and voice files. There should be ADX files in:

<code>Sonic Adventure DX\SoundData\BGM\wma</code> and <code>Sonic Adventure DX\SoundData\voice_us\wma</code>

or WMA files in:

<code>Sonic Adventure DX\system\sounddata\BGM\wma</code> and <code>Sonic Adventure DX\system\sounddata\voice_us\wma</code>.

If you can't find them, use the [[SADX Mod Installer]] or install the ADX Audio mod manually.

Make sure music and voices are enabled in the Mod Manager. In the Sound tab, make sure Music Volume and Voice Volume are not 0 and <code>Enable Music</code> is checked. In the <code>Codes</code> tab, make sure <code>Disable Music</code> and <code>Disable Voices</code> are unchecked.

Click the volume icon in Windows system tray and check if the sound is going through the correct output device. If you have multiple output devices and don't know which one is correct, try switching between them. For most cases, it should be <code>Speakers</code> or <code>Headphones</code>, or the model of your monitor if it has built-in speakers. Don't select <code>S/PDIF</code> or <code>Optical</code> if you aren't sure you're using it.

=== Missing Sound Effects ===

# Check if your game has sound effect files. There should be <code>DAT</code> files in <code>Sonic Adventure DX\SoundData\SE</code> or in <code>Sonic Adventure DX\system\sounddata\se</code>. If they are missing, you need to reinstall the game or copy these files manually from the original game's CD 2. If you have the Steam version, reinstall it and use the SADX Mod Installer.
# Click the volume icon in Windows system tray and check if the sound is going through the correct output device. If you have multiple output devices and don't know which one is correct, try switching between them. For most cases, it should be <code>Speakers</code> or <code>Headphones</code>, or the model of your monitor if it has built-in speakers. Don't select <code>S/PDIF</code> or <code>Optical</code> if you aren't using it.
# Look for the file <code>dsound.dll</code> in your SADX folder. Try renaming this file to something else and see if sound effects come back.

=== The Game Skips Videos ===

# Check if your game has video files. There should be <code>MPG</code> files in <code>Sonic Adventure DX\system</code>. The intro is called <code>RE-US.mpg</code>. If it is missing, you need to reinstall the game (and run the [[SADX Mod Installer]] if you have the Steam version).
# Make sure the <code>Disable Videos</code> and <code>Skip Intro</code> codes are unchecked in the Mod Manager's <code>Codes</code> tab.
# If you have any software that affects video playback, such as ffdshow, LAV, Smooth Video Project etc., you might need to disable or uninstall it.
# See the steps for the "Windows Media Player 9 is not installed" error.

=== "DLL Error - The Specified Module could not be Found" Error on Loading a Mod ===
There are several things that can cause this error:

* The required Visual C++ runtimes are missing. Most mods are compiled with Visual Studio 2015-2022, so you need this runtime to load them. Older mods may be compiled with Visual Studio 2013 or 2012. Download and install all of the runtimes from [[Installing Mods|this page]].

* DirectX 9.0c end-user runtime is missing. Download and install all of the runtimes from [[Installing Mods|this page]].
* The mod is missing the DLL file. In the Mod Manager, right click the mod and select <code>Verify integrity</code>. If any errors are detected, let the Mod Manager repair the mod and try again. If no errors are found, contact the mod developer.
* The DLL file was compiled in Debug mode. If you have all the runtimes installed, the mod DLL file exists and you are still getting the error, contact the mod developer.

=== "Direct3D Reset Failed: D3DERR_INVALIDCALL" Error During Gameplay ===
This error occurs when the Direct3D device handle used by the game becomes invalid. This can happen when other 3D programs or games take control of the Direct3D device, or when User Account Control (UAC) dims the desktop. To avoid this issue, you can do the following:

# Avoid running other programs (especially those that require elevation) while the game is running.
# Enable "Resizable Window" in SADX Mod Manager's Graphics settings.

=== Can't rebind keyboard keys ===
Keyboard binds from the Steam version won't work on the modded game because the modded game is based on an old version of SADX that doesn't support custom keybinds. However, you can rebind keys with the Input mod and a configuration tool that is included in the SADX Mod Installer. After using the installer, select <code>Configure Sonic Adventure DX</code> on Steam or run <code>AppLauncher.exe</code> in the SADX folder, and you will be able to change keys in the Controls tab.

=== Input issues: Controller isn't detected, spinning camera, button layout is wrong etc. ===

# Make sure <code>Better Input</code> is enabled in Input options in the Mod Manager.
# Make sure your controller is detected and configured in SADX Launcher's <code>Controls</code> tab. If you don't have SADX Launcher, you can get it with the [[SADX Mod Installer]].
# If you are using Steam Input, try disabling it.

=== Issues with Sony DualShock or Nintendo Switch Pro controllers ===

# Install ds4windows and use it in X360 emulation mode.
# Run SADX Launcher and configure the axes and buttons as usual.

== Where to get help ==
You can ask for help on the #troubleshooting channel on the [https://discord.com/invite/gqJCF47 x-hax Discord server].