Skip to content

BepInEx mod for Stronghold Crusader Definitive Edition that automatically replaces audio with classic sounds from the original Stronghold Crusader series. Restoring the beloved "old but gold" audio experience with zero configuration required.

License

Notifications You must be signed in to change notification settings

T3CC4/StrongholdOGSounds

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

5 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐ŸŽต OG Crusader Sounds

Version License BepInEx Platform

Bringing back the classic Stronghold Crusader audio experience to Definitive Edition

Features โ€ข Installation โ€ข Usage โ€ข Troubleshooting โ€ข Contributing

๐Ÿ”— View on GitHub


๐Ÿ“‹ Overview

OG Crusader Sounds is a BepInEx mod for Stronghold Crusader Definitive Edition that automatically replaces the game's audio with the beloved classic sound effects from the original Stronghold Crusader series.

Why this mod? Many players prefer the original audio design of classic Stronghold Crusader. This mod seamlessly brings those sounds to the Definitive Edition while maintaining full game compatibility.

โœจ Features

  • ๐Ÿ” Auto-Detection: Automatically finds your Stronghold Crusader installation via Steam or Windows Registry
  • ๐Ÿง  Smart Replacement: Uses MD5 hash comparison to only replace files that actually differ
  • ๐ŸŽ“ Tutorial Skip: Automatically excludes tutorial audio files to preserve learning experience
  • ๐Ÿ“Š Detailed Logging: Comprehensive operation logs for transparency and debugging
  • ๐Ÿ—‚๏ธ Multi-Library Support: Works with multiple Steam library locations
  • โšก Zero Configuration: Works out of the box with no setup required

๐ŸŽฏ Requirements

Component Version Notes
Stronghold Crusader Definitive Edition Any Target game
BepInEx 5.4.x+ Download here
Source Game Any variant See supported games

Supported Source Games

  • Stronghold Crusader (Original)
  • Stronghold Crusader Extreme
  • Stronghold Crusader HD

๐Ÿš€ Installation

Step 1: Install BepInEx

  1. Download BepInEx 5.4.x for your platform
  2. Extract to your Stronghold Crusader Definitive Edition directory
  3. Run the game once to generate BepInEx folders

Step 2: Install the Mod

  1. Download the latest SCDEOGSounds.dll from Releases
  2. Place it in <Game Directory>/BepInEx/plugins/
  3. Launch the game
๐Ÿ“ Stronghold Crusader Definitive Edition/
โ”œโ”€โ”€ ๐Ÿ“ BepInEx/
โ”‚   โ”œโ”€โ”€ ๐Ÿ“ plugins/
โ”‚   โ”‚   โ””โ”€โ”€ ๐Ÿ“„ SCDEOGSounds.dll  โ† Place here
โ”‚   โ””โ”€โ”€ ๐Ÿ“ config/
โ””โ”€โ”€ ๐ŸŽฎ Stronghold Crusader Definitive Edition.exe

๐ŸŽฎ Usage

The mod works automatically! Simply launch Stronghold Crusader Definitive Edition and the mod will:

  1. ๐Ÿ” Detect your original Stronghold Crusader installation
  2. ๐Ÿ“ Locate the fx folder containing audio files
  3. ๐Ÿ”„ Replace matching audio files in Definitive Edition
  4. ๐Ÿ“ Log all operations to BepInEx console/logs

Example Log Output

[Info: OG Crusader Sounds] Found 247 files in source directory
[Info: OG Crusader Sounds] Skipped tutorial file: tutorial_welcome.wav
[Info: OG Crusader Sounds] Replaced: sword_clash.ogg
[Info: OG Crusader Sounds] Already replaced: arrow_hit.wav
[Info: OG Crusader Sounds] Summary: 156 replaced, 23 skipped, 68 not found

๐Ÿ”ง Technical Details

Detection Method

The mod uses a multi-step detection process:

flowchart TD
    A[Start] --> B[Check Steam Registry]
    B --> C{Steam Found?}
    C -->|Yes| D[Parse Steam Libraries]
    C -->|No| E[Check Windows Registry]
    D --> F[Search for Crusader Games]
    E --> F
    F --> G{Game Found?}
    G -->|Yes| H[Begin Audio Replacement]
    G -->|No| I[Log Error & Exit]
Loading

File Matching

  • Files are matched by exact filename regardless of folder structure
  • MD5 hashing prevents unnecessary file operations
  • Tutorial files are automatically excluded using filename pattern matching

๐Ÿ› ๏ธ Troubleshooting

โŒ "Stronghold Crusader not found"

Possible Causes:

  • Original Stronghold Crusader is not installed
  • Game is installed in non-standard location
  • Registry entries are missing

Solutions:

  • Ensure you have Stronghold Crusader/Extreme installed
  • Try reinstalling the original game
  • Check if the game appears in Steam library
โŒ "Required directories not found"

Possible Causes:

  • Missing fx folder in original game
  • Permissions issues
  • Corrupted installation

Solutions:

  • Verify integrity of original game files
  • Check folder permissions
  • Reinstall original Stronghold Crusader
โŒ No audio changes heard

Possible Causes:

  • Files are identical (already replaced)
  • Audio caching by game engine
  • Mod not loading properly

Solutions:

  • Check BepInEx logs for mod loading confirmation
  • Restart the game completely
  • Verify mod is in correct plugins folder

๐Ÿ‘จโ€๐Ÿ’ป Development

Building from Source

git clone https://github.com/T3CC4/StrongholdOGSounds.git
cd StrongholdOGSounds
# Open in Visual Studio and build
# Reference: BepInEx.Core.dll, UnityEngine.CoreModule.dll

Project Structure

๐Ÿ“ Source/
โ”œโ”€โ”€ ๐Ÿ“„ OGSounds.cs           # Main plugin class
โ”œโ”€โ”€ ๐Ÿ“„ SCDEOGSounds.csproj   # Project file
โ””โ”€โ”€ ๐Ÿ“„ packages.config      # NuGet dependencies

๐Ÿค Contributing

Contributions are welcome! Here's how you can help:

  • ๐Ÿ› Report Bugs: Open an issue with detailed reproduction steps
  • ๐Ÿ’ก Suggest Features: Share your ideas for improvements
  • ๐Ÿ”ง Submit PRs: Fork, create feature branch, submit pull request
  • ๐Ÿ“š Improve Docs: Help make documentation clearer

Contribution Guidelines

  1. Follow existing code style
  2. Add appropriate logging for new features
  3. Test with multiple Stronghold Crusader variants
  4. Update documentation as needed

๐Ÿ“„ License

This project is licensed under the MIT License.

MIT License

Copyright (c) 2025 Tecca

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
View full license

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


Made with โค๏ธ by Tecca

โญ Star this repo if it helped you! โญ

This mod is not affiliated with or endorsed by Firefly Studios.

๐Ÿ” Back to Top

About

BepInEx mod for Stronghold Crusader Definitive Edition that automatically replaces audio with classic sounds from the original Stronghold Crusader series. Restoring the beloved "old but gold" audio experience with zero configuration required.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages