HFF UnityExplorer

🔍 An in-game UI for exploring, debugging and modifying Unity games.

✔️ Supports most Unity versions from 5.2 to 2021+ (IL2CPP and Mono).

✨ Powered by UniverseLib

🛠️ This is fork of UnityExplorer maintained by yukieiji

Changes from original

• Bug fixes due to continued development
• Il2CPP and Mono support for BepInEx 6.x be.647+(DL:Il2CPP/DL:Mono)
• Compatible with MelonLoader 0.6.x(OpenBeta) or later(DL)
• and etc..
• Some new featuree
• Stabilize overall performance by adjusting project settings, etc.

If there are any bugs or features you want, please create a ticket!

Comparison with other forks

• New features while keeping high compatibility
• stability

Releases

Release schedule

Releases will be posted at most once per week, generally on weekends.

Nightly builds can be found here.

BepInEx

| Release | IL2CPP(Il2CppInterop) | IL2CPP(Unhollower) | Mono |

| ------- | ------ | ------ | ---- |

| BIE 6.X be.647+ or BIE 6.0-pre.2+ | ✅ link | ✖️ n/a | ✅ link |

| BIE 6.X be.472 to be.577 or BIE 6.0-pre.1(NOT pre.2) | ✅ link | ✅ link | ✅ link |

| BIE 5.X | ✖️ n/a | ✖️ n/a | ✅ link |

• Unzip the release file into a folder
• Take the plugins/sinai-dev-UnityExplorer folder and place it in BepInEx/plugins/

Note: BepInEx 6 is obtainable via builds.bepinex.dev

MelonLoader

| Release | IL2CPP | Mono |

| ------- | ------ | ---- |

| ML 0.6+ | ✅ link | ✖️ |

| ML 0.6(ONLY 0.6 ALPHA BUILD, NOT BETA) | ✅ link | ✖️ |

| ML 0.5 | ✅ link | ✅ link |

• Unzip the release file into a folder
• Copy the DLL inside the Mods folder into your MelonLoader Mods folder
• Copy all of the DLLs inside the UserLibs folder into your MelonLoader UserLibs folder

Standalone

| Il2CppInterop | Unhollower | Mono |

| ------ | ------ | ---- |

| ✅ link| ✅ link | ✅ link |

The standalone release can be used with any injector or loader of your choice, but it requires you to load the dependencies manually.

• Ensure the required libs are loaded - UniverseLib, HarmonyX and MonoMod. Take them from the UnityExplorer.Editor release if you need them.
• For IL2CPP, load Il2CppAssemblyUnhollower and start an Il2CppAssemblyUnhollower runtime
• Load the UnityExplorer DLL
• Create an instance of Unity Explorer with UnityExplorer.ExplorerStandalone.CreateInstance();
• Optionally subscribe to the ExplorerStandalone.OnLog event to handle logging if you wish

Unity Editor

• Download the UnityExplorer.Editor release.
• Install the package, either by using the Package Manager and importing the package.json file, or by manually dragging the folder into your Assets folder.
• Drag the Runtime/UnityExplorer prefab into your scene, or create a GameObject and add the Explorer Editor Behaviour script to it.

Common issues and solutions

Although UnityExplorer should work out of the box for most Unity games, in some cases you may need to tweak the settings for it to work properly.

To adjust the settings, open the config file:

• BepInEx: BepInEx\config\com.sinai.unityexplorer.cfg
• MelonLoader: UserData\MelonPreferences.cfg
• Standalone: sinai-dev-UnityExplorer\config.cfg

Try adjusting the following settings and see if it fixes your issues:

• Startup_Delay_Time - increase to 5-10 seconds (or more as needed), can fix issues with UnityExplorer being destroyed or corrupted during startup.
• Disable_EventSystem_Override - if input is not working properly, try setting this to true.
• Disable_Setup_Force_ReLoad_ManagedAssemblies - if Mono game fails to resolve assembly dependencies at startup, try setting this to true(detail: yukieiji/UniverseLib#4).

If these fixes do not work, please create an issue in this repo and I'll do my best to look into it.

Features

Inspector API

If you want to inspect an object or Type from outside the C# console, use the InspectorManager class:

To inspect an object:

UnityExplorer.InspectorManager.Inspect(theObject);

To inspect a Type:

UnityExplorer.InspectorManager.Inspect(typeof(SomeClass));

Object Explorer

• Use the Scene Explorer tab to t