Verify the manager points to your SonicGenerations.exe . Common Troubleshooting 🛠️ The "Vanilla" Launch Issue If the game launches but mods don't show up: Open HedgeModManager. Go to the Settings tab. Toggle the "Enable Mods" checkbox off and on. Click Save & Play . 📁 Incorrect File Structure Mods must be folders, not .zip or .7z files: Extract the mod files.

Consider using the Steam version of the game for the best compatibility. Summary Checklist Likely Cause Mods don't appear Improper Loader Installation Re-install loader via HMM Black Screen Mod Conflict / Wrong Load Order Reorder mods; disable until found Game Crashes at Loading Missing Code / Physics Fix Enable Necessary Code in HMM Textures are missing Mod installed incorrectly Re-install mod files correctly

This usually means a mod conflicts with your screen resolution or refresh rate. Turn off all mods in the manager. If the vanilla game works, re-enable your mods one by one to find the broken link. Alternatively, force the game to run in a borderless window via the Mod Manager settings tab. Mods Do Not Appear in the Manager List

Ensure HedgeModManager is pointed to your SonicGenerations.exe . A common issue is installing the manager, but it not properly "installing" the necessary loader files into the game folder. How to fix: Open HedgeModManager. Click on the "Codes" tab.

| Symptom | Most Likely Fix | |---------|----------------| | Mods don't appear in the mod manager | Wrong folder path (see Step 1) | | Game crashes on launch | Missing d3d9.dll or HedgeModManager update | | Mods show "red text" error | Missing required mod (e.g., CodeLoader or Mod Loader Base ) | | Download link is broken | Use or the HedgeModManager built-in database |

If your Sonic Generations mods aren't loading, the issue usually lies in the Mod Loader setup or the game's file configuration. Quick Fixes

Depending on the user's selection, the feature expands to show the specific fix.

If your , or you are searching for the correct setup links, this comprehensive guide will get your game up and running with your favorite custom content. Why Are Your Sonic Generations Mods Not Working?

Sometimes, mods conflict with each other, leading to a black screen or a crash immediately after the SEGA logo.

A: SonicGMI is the older mod manager that works by directly patching the game's executable and uses CPKREDIR to load mods. HedgeModManager (HMM) is the more modern, user-friendly tool that supports multiple games and is generally recommended for all new mods. SonicGMI is only needed for some very old, legacy mods that HMM can't interpret.

| Issue | Likely Cause | Step-by-Step Fix | | :--- | :--- | :--- | | | The mod was not installed correctly. The mod uses an outdated structure. | 1. Double-check your installation. For most mods, dragging the archive into HMM works. If that fails, try unzipping the mod's folder manually into the mods folder located in your main game directory. 2. For older mods: They may require the SonicGMI mod loader. Try HMM's "Install Mod Loader" button in the settings to toggle between loaders. | | ❌ "cpkredir.dll is missing" error | Required mod loader files are not in the right place. | Re-extract the files from the HedgeModManager or SonicGMI package directly into your game's main folder. Make sure cpkredir.dll is in the same directory as your game's .exe file. | | ❌ Game crashes on launch with mods enabled | A mod is corrupted or incompatible. Mods are in the wrong load order. Conflicts with RTX graphics cards. | 1. Disable mods one by one. Uncheck all your mods in HMM and launch the game to confirm it works. Then re-enable mods one at a time, launching the game each time, to find the culprit. 2. Check mod load order. Some large mods, like The Unleashed Project, require specific load orders listed on their download page. 3. RTX Incompatibility: There are known reports of mods causing crashes on RTX graphics cards. If you have one, try the "Verify integrity of game files" step below as a first measure. | | ❌ Game crashes after installing a mod (e.g., The Unleashed Project) | A specific file within a large, complex mod is causing the issue. | For The Unleashed Project, an "endless loading screen" or crash is sometimes caused by a faulty Sound folder . As a known workaround, try temporarily removing the Sound folder from inside the mod's directory. | | ❌ Game won't start at all after enabling/disabling mods | A mod made permanent changes to core game files. | 1. In your Steam Library, right-click Sonic Generations . 2. Select Properties > Installed Files . 3. Click Verify integrity of game files . Steam will scan and replace any altered core game files, fixing the problem. | | ❌ Sound is missing or broken in-game | A mod may be overriding core sound files. A recent manager update caused a conflict. | If you use a large mod pack, the manager might be loading mods in an order that causes conflicts. As a temporary fix, try disabling some mods or adjusting their load order. | | ❌ Missing Textures (Black, Rainbow, or Invisible) | Texture files are missing or have the wrong resolution. Material files have typos or are missing. | 1. Textures must have "power-of-two" resolutions (e.g., 512x512, 1024x1024). Check your mod for texture sizes. 2. Rainbow flashing means a texture is missing. Check that the file path and name are correct in the material file. | | ❌ Missing Terrain or Environment Models | The game runs out of memory trying to load custom terrain. | You can increase the game's memory limit by editing the Terrain.prm.xml file in your mod. Look for the parameters g_TerrainModelLimitSizeDefault and increase the value to something like 250 (MB). | | ❌ Mods are no longer working after a major game or manager update | The update broke compatibility with existing mods. | 1. Update HedgeModManager. Always ensure you are on the latest version, which includes fixes for game updates. 2. For mods that still won't work after an update, check the mod's official page for a compatibility patch. | | ❌ Issues on Steam Deck / Linux | A different setup process is required. | This is a more complex setup. Using the Hedge Mod Manager 8 Beta is the current recommended method for getting mods to work properly on Steam Deck. |

If you've lost all game audio after installing mods, the solution is surprisingly simple: