UnityExplorer

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

Powered by UniverseLib

This UnityExplorer fork is focused on Unity 6.3 Mono support.

Support for IL2CPP and newer Unity versions is currently not planned.

If there are any bugs or features you want, please open a Issue

Releases

BepInEx

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

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

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

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

| BIE 5.X | ✖️ n/a | ✖️ n/a | ✅ link | ✅ 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 | Unity 6.3 Mono |

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

| ML 0.6+ | ✅ link | ✖️ n/a | ✖️ n/a |

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

| ML 0.5 | ✅ link | ✅ 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 | Unity 6.3 Mono |

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

| ✅ link| ✅ 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).
• Bypass_UniverseLib_ICall - If you have errors when inspecting Sprites or similar objects in some games, try setting this to true.

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 traverse the active scenes, as well as the DontDestroyOnLoad and HideAndDontSave objects.
• The "HideAndDontSave" scene contains objects with that flag, as well as Assets and Resources which are not in any scene but behave the same way.