A bunch of Clone Hero tweaks I have made!
More information about each tweak can be found in their respective folders.
- You will need Clone Hero v0.23.2.2. You can use any version from the website (i.e. Win64, Win32, Mac, or Linux), but your mileage with the launcher version may vary.
- Install BepInEx v5.4.17 into your Clone Hero directory.
- Download the appropriate version and extract all of its files into your Clone Hero directory.
- Please verify that BepInEx has initialised by running the game after extracting, and then checking that there are five folders and a
LogOutput.log
file inside theBepInEx
folder. One of those folders will be namedplugins
, and you'll need that to run the mods.
- Go to the Releases page and download the latest versions of the mods you want for your version of Clone Hero.
- Almost all the mods will require
Biendeo CH Lib
to also be installed so please also download that. If you are missing it, the log will inform you. - All the downloads are
.zip
files and will need to be extracted to your Clone Hero directory. They should merge with the existingBepInEx
folder. - To ensure that the mods have been extracted properly, check that
LogOutput.log
(orLogOutput.log.1
, whichever is newer) has a line in this format for each mod:[Info : BepInEx] Loading [Biendeo CH Lib 1.5.2.0]
- Almost all the mods will require
- All mod configs are in
BepInEx\config
, so just delete the appropriate files. All mods have confings in the formatcom.biendeo.MODNAME.*
. For example, to resetExtra Song UI
, deletecom.biendeo.extrasongui.xml
andcom.biendeo.extrasongui.layout.xml
.
- If you're just mods, go to
BepInEx\plugins
and delete the folder for the appropriate mod you're removing. All configs are inBepInEx\config
if you want to also remove those. - If you're uninstalling BepInEx, delete the whole
BepInEx
folder, andwinhttp.dll
from your Clone Hero directory.
- Always perform these steps before giving up, because the logs usually indicate what has gone wrong every time!
- BepInEx logs to
BepInEx\LogOutput.log
andBepInEx\LogOutput.log.1
. If both files aren't there, BepInEx didn't initialise and you should try and reinstall it. If they are, open the latest of the two.- Ensure that there exists a line for every mod (including
Biendeo CH Lib
) in the log indicating that it'sLoading
. If not, then the mods probably aren't installed. BepInEx will look insideBepInEx\plugins
for anydll
files to load, so if you haven't extracted the mods properly, then they probably aren't even loading to begin with. - Try and find any lines starting with
ERROR
. If there are, then there's probably an actual issue with that mod and you should report a bug report through GitHub. Please follow the format and fill out as much information as you can. - If a lot of lines start with
WARN
or you don't see anything too obvious, this may be a user error, so double check that you're utilising the mods properly. Otherwise, you can also report a bug report through GitHub.
- Ensure that there exists a line for every mod (including
- Clone Hero logs to
%USERPROFILE%\AppData\LocalLow\srylain Inc_\Clone Hero\output_log.txt
. Any legacy mods would also log there, but it's only useful for spotting anything Clone Hero related that's gone wrong now. - Check out the Clone Hero Modding Discord if you want someone (maybe myself) to talk and help you out with anything.
- Request a new feature through GitHub, it's the easiest way.
- If it's a new idea as well, you can pitch the idea to the Clone Hero Modding Discord for some general feedback.
- If you spot a bug, feel free to make a pull request and I can review it. The functionality of my mods is my say though, so if it changes behaviour I'll have to decide whether I'm keeping it or not.
- If you want to just fork my mods, that's fine, just make sure you've also got the GPL-3.0 license with your code as well.
- You are free to make new mods that utilise
Biendeo CH Lib
to access the underlying game data if you choose. - My development process is described on this repository's wiki if you'd like some additional pointers.
- You are free to make new mods that utilise