A BepInEx plugin port of the collision viewer for the game Bug Fables. This plugin is a port of a modified version of the game's Assembly-CSharp.dll which was previously distributed for this purpose. The port offers the following advantages:
- It no longer requires the distribution of the game's Assembly-CSharp.dll which could lead to copyright issues
- Since the patches are done at runtime instead of being a static patch, it allows more liberty in configuration in conjunction with BepInEx's standardized configuration scheme
- Due to #1, the code can be distributed publically under a Git repository which allows better tracking of changes through time
If you already have a previous version of the old collision viewer (one that came with an Assembly-CSharp.dll), you must uninstall it first.
If this is not done already, you first need to install the BepInEx loader into the game. To do so, download the latest release by getting the zip file marked "x64". Then, simply unzip it into the game's directory such as the BepInEx folder as well as the 3 provided files appears from the game's directory. If you are using Steam, this directory is by default located at C:\Program Files (x86)\Steam\steamapps\common\Bug Fables on Windows and at ~/.steam/steam/steamapps/common/Bug Fables on Linux. Once the files are placed, launch the game once for the installation to complete.
Once this is done, download the latest version of the plugin and unzip it into BepInEx/plugins from the game's directory. You should unzip it so the folder Collision-Viewer with all the files from the zip appears directly under the plugins folder.
To uninstall the plugin, simply delete the BepInEx/plugins/Collision-Viewer folder from the game's directory.
If you want to entirely remove BepInEx and all of its plugins, delete the following under the game's directory:
- The BepInEx folder
- The file changelog.txt
- The file doorstop_config.ini
- The file winhttp.dll
This plugin functions by adding features when pressing some hotkeys during gameplay:
- R = Show/Hide Collision Viewer (Do not disable/enable the next action direction)
- T = Show/Hide Solid Collision (Green)
- Y = Show/Hide Trigger Collision (Red, Blue for respawn)
- F = Opacity Up (hold It)
- G = Opacity Down (hold It)
- TAB = Toggle the yellow direction line
It also adds a yellow line indicating the direction of the next action of the main character.
This section is intended only for developers. You do not need to do this if you only want to use the plugin. Refer to the Installation instructions section for this purpose.
NOTE: For technical reasons, this project is configured to be built using .NET Framework 3.5. Please do not change the target Framework and make sure your environement supports this version of the .NET Framework.
This project is configured for Visual Studio 2019 (previous versions may work, but are untested). To build the project, you first need to place the required dlls into the Libs directory present on this repository. Refer to Libs/README.txt for more information on which dlls to place.
Once this is done, the project should build successfully. To improve convenience, you may want to set the output path to Bug Fables\BepInEx\plugins\Collision-Viewer (where Bug Fables is the game's directory) in the project's configuration for ease of testing.
To debug the plugin, you will need the dnSpy program (download the file dnSpy-net472.zip). Once it's installed, you will need to download this modified version of mono.dll and place it at Mono/EmbedRuntime from the game's directory. You may want to backup or rename the original one that comes with the game in case you want to revert it.
With this done, you will now be able to debug the plugin with dnSpy. Open the Collision-Viewer.dll file with dnSpy, click Start at the top, select Unity as the Debug Engine and select the game's executable in the Executable field (the file Bug Fables.exe) and finally, click OK. You may now place breakpoints, use watches in the Watch window and see all the output produced by the plugin and Unity in the Output window.
All contributions via pull requests are welcome as well as issue reports on this issue tracker. You may also request features with this issue tracker.
If you are planning to submit a pull request, do not share any substantial amount of code from the game as it can lead to copyright issues and thanks to Harmony + BepInEx, it can be avoided in almost all cases. Any pull requests that contains substantial amount of code from the game will be immediately denied if I judge it can be done without sharing the code.
This plugin was done by Faulco and I.
This plugin is licensed under the MIT license which grants you the permission to freely use, modify and distribute this plugin as long as the original license and its copyright notice is still present. Refer to the MIT license for more information.
I would like to thank everyone from Moonsprout Games for making this amazing game as it brought inspiration to me and to everyone in the community it sparked.