A BepInEx 5 plugin that automatically reloads plugins by watching BepInEx/plugins/ for file changes.
[!WARNING]
I have been informed that theFileSystemWatchermay work terribly on Windows. This plugin relies onFileSystemWatcherworking properly. If you are having issues with it, try running under Linux.
To make your plugin work with reloading, it must implement the OnDestroy method in the main plugin class to clean up after itself. An example of a good plugin:
[BepInAutoPlugin]
public partial class Plugin : BaseUnityPlugin
{
void Awake()
{
// Apply all hooks
MonoDetourManager.InvokeHookInitializers(typeof(Plugin).Assembly);
Log.LogInfo($"Plugin {Name} is loaded!");
}
void OnDestroy()
{
// Dispose all hooks
DefaultMonoDetourManager.Instance.Dispose();
Log.LogInfo($"Plugin {Name} unloaded!");
}
}
[!TIP]
The above plugin uses Hamunii.BepInEx.AutoPlugin for the[BepInAutoPlugin]attribute.
This is a hard fork of BepInEx.Debug ScriptEngine which dramatically changes how the plugin works.
Main changes are:
scripts/ directory is gone
plugins/LoadOnStart option is goneFileSystemWatcher option is gone, always enabled
AutoReloadDelay option is goneReloadKey option is goneIncludeSubdirectories option is gone, always enabledDumpAssemblies option is gone, always enabled