View source for Game Troubleshooting Guide

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

== SA Mod Manager Issues ==

=== Mods and Codes don't Appear ===
You need to specify the game's location in <code>Manager Settings</code>. The SA Mod Manager can be used in any folder and with multiple games, so you have to set the game path manually.

Note that if you had the old SADX or SA2 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 [https://sadxmodinstaller.unreliable.network/ SADX Mod Installer] to convert your game to the 2004 version and install the Mod Manager automatically.

=== 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 SA2, simply download the SA Mod Manager from its release page and put it in your SA2 folder, then run it 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> ===

* 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 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.

=== 1-Click Support in the Mod Manager not Working ===

# Go to the SA Mod Manager's Manager Config tab. 
# Click "Uninstall 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.
'''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 ===
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 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.

=== Other SA Mod Manager Errors ===
Please report SA Mod Manager errors on its [https://github.com/X-Hax/SA-Mod-Manager/issues GitHub issue tracker]. Alternatively you can use the report button found in the <code>The Manager has encountered an Error</code> window. 

'''Please''' include the log using the <code>Copy Error Log</code> button if you decide to submit an Issue.

== SADX Mod Installer Issues ==

=== SADX Mod Installer Download and Access Errors ===

=== "SendRequest error" when Using the Web Version of the Installer ===

=== "SSL Record Too Long" Error when Trying to Download 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.

Short-term solution: Use a VPN to circumvent the block. 

Long-term solution: Contact your ISP's tech support and tell them to unblacklist <code>dcmods.unreliable.network</code>.

== 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.

=== SADX: "Windows Media Player 9 is not Installed" Error ===
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 page] for further instructions.

=== SADX: 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 [https://sadxmodinstaller.unreliable.network/ 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.

=== SADX: 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.

=== SADX: 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 [https://sadxmodinstaller.unreliable.network/ 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 [[Game Troubleshooting Guide#"Windows Media Player 9 is not Installed" Error in SADX|"Windows Media Player 9 is not installed" error]].

=== "DLL Error - The Specified Module could not be Found" Error on Loading a Mod ===

=== Error 0xc000007b 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:

* 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#Visual C++ 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> (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 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.''' 

=== SADX: "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 <code>Resizable Window</code> in the Mod Manager's Graphics settings.

=== SADX: "Shader creation failed" error on Linux (<code>unexpected KW_SAMPLER_STATE</code> and others) ===
This error is produced by the Lantern Engine mod, which needs to compile a shader before it can work. The D3D compiler supplied in many versions of WINE doesn't support the features used by Lantern Engine's shader. 

To work around this problem you can try the following: 

# '''Run the game through Steam/Proton. Do not use WINE.'''
# Install [https://www.microsoft.com/en-us/download/details.aspx?id=35 DirectX End-User Runtime] manually onto the same prefix as the game. Installation: Using Protontricks, run <code>dxwebsetup.exe</code> and follow the instructions. Internet access is required. 

Other solutions for WINE (not recommended but may work) 

# Install the D3D compiler manually using the following terminal command: <code>winetricks d3dx9 d3dcompiler_43 d3dcompiler_47</code> 
# Copy <code>d3dcompiler_47.dll</code> from the official DirectX redistributable to the game folder and set it to native in <code>winecfg</code>. 
# Delete the folder <code>~/.local/share/Steam/steamapps/compatdata/71250</code> and reinstall the game.

=== SADX: 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. 

=== SADX: Input Issues: Controller not Detected, Spinning Camera, Wrong Button Layout etc. ===

# 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].
# If you are using Steam Input, try disabling it.

=== SADX: Issues with Sony DualShock or Nintendo Switch Pro Controllers ===

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

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

'''If the game crashes, please provide your mod list and the crash dump''' '''as instructed by the Mod Loader.'''

If your game doesn't produce crash dumps, import [https://dcmods.unreliable.network/owncloud/data/PiKeyAr/files/sadocs/crashdumps.reg this registry file] to enable them.