If you prefer lots of wasted time and frustration, don't pay close attention to these instructions.

Seeking this information for any other systems if you can contribute it.

BepInEx is a utility that allows your mods to work. That's all you need to know, or at least I hope so because that's all I know about it.

---

1. Download BepInEx here[github.com].
If you have a 64-bit system, get the x64 file. If you're not sure of what version of Windows you have, you can verify that information here[support.microsoft.com].

---

2. Once you've downloaded one of the release files, open the zip file, and put its contents in your Streets of Rogue directory:After you've put the zip contents in your SOR folder, it should look something like this.

---

3. Once that's done, run the game with or without Steam. Get to the title screen, and just close the program. Among other things, this will create a new file directory automatically:
If the plugins folder showed up, then BepInEx successfully installed.

Go to the Links section, download a mod file, and put it in the indicated folder.

Did you follow all that?

Install 7-Zip from here[www.7-zip.org]. Right-click the ZIP or RAR and select Extract. If you're still confused at this point, don't give up! Treat this as a mental exercise that may help slow the onset of your dementia!

---

There's a 99% chance you skipped a step in the installation instructions. And a 99% chance you think you're the 1% who didn't.

---

First, it's Fudgecicles. Here are some of the most common issues:

• RogueLibs is out of date - As of this writing, v3.6.6 is the final edition for SOR1, as development is halted until the release of SOR2. Make sure you have the latest version and you most likely won't have to do it again.
  
• Using my (Ted Bunny's) mods in pre-release test builds - I always try to work with the newest version of RogueLibs & BTHarmonyUtils. Keep an eye out for an error log message that mentions those.
  
• BTHarmonyUtils is in the wrong folder - Some users have reported that the BTHarmonyUtils mod library does not work in the normal mod folder (plugins). Instead, try putting it in
  Steam/steamapps/Streets of Rogue/BepInEx/core
• RogueLibsPatcher is in the wrong folder - This file goes into
  Steam/steamapps/Streets of Rogue/BepInEx/patchers

---

1. Verify that you have BepInEx installed correctly. The Plugins folder should automatically generate the first time you run SOR after dropping the BepInEx folder into the directory.
   
2. Activate the error log. Open BepInEx's configuration file, which in Windows is located at:
   Steam/steamapps/common/Streets of Rogue/BepInex/config/BepInEx.cfg
   Set "LogLevels" to "All," like so:
   
3. You're doing great, buddy! Just wanted to say that.
   
4. Restart SOR. Now, whenever you close the game, the log file will be updated automatically as long as you don't have the file open.The log can be found at
   Steam/steamapps/common/Streets of Rogue/BepInEx/LogOutput.log
5. Submit that log on the Modding channel in the Streets of Rogue Discord. The community there has been very quick to help out people with questions.

The destination Folders described below are all under the BepInEx directory:

Almost all mods use RogueLibs (https://github.com/Chasmical/RogueLibs/releases/tag/v4.0.0-rc.1). See each mod's documentation for its requirements. Many mods will come packaged with their required files.

The actual mod files. First listings are the most up to date.


(Sorry, Steam mandates table ugliness through nonworking features.)