sinaioutlander 535e88be9a 1.4.5 (pre-release)
* Pre-release. Will be released once MelonLoader bumps to Unhollower 0.4.9.0
* Added global "Force Unlock Mouse" option, should work on almost all games. Has smart behaviour and will maintain the previous value (or the value which should be set).
* Improve performacne of CacheList casting List ->IEnumerable
* Fix a bug causing some Components to not show the GameObject button in the Reflection Window (top-right corner).
* Fix a bug making the Window Manager think that two of the same Il2Cpp Object are not ReferenceEquals.
* Added logging when C# Console fails to compile anything
* Improve display of Reflection Window member name label, now expands with window resize.
2020-08-27 18:05:55 +10:00
2020-08-27 18:05:55 +10:00
2020-08-07 22:18:48 +10:00
2020-08-07 23:55:02 +10:00
2020-08-07 22:18:48 +10:00
2020-08-27 18:05:55 +10:00

CppExplorer Version

An in-game explorer and a suite of debugging tools for IL2CPP Unity games, using MelonLoader.

Known issue

Some games are experiencing MissingMethodExceptions or exceptions about failed unstripping, which prevent the CppExplorer menu from showing properly or at all. This is a bug with Il2CppAssemblyUnhollower and there isn't much I can do about it myself.

If you're familiar with C# and Unity, one possibility for now is making a fork of this repo and manually fixing all the broken methods to ones which aren't broken (if possible). There may be another overload of the same method which wasn't stripped or was unstripped successfully, which you can use instead.

Features

  • Scene hierarchy explorer
  • Search loaded assets with filters
  • Traverse and manipulate GameObjects
  • Generic Reflection inspector
  • C# REPL Console
  • Inspect-under-mouse

How to install

Requires MelonLoader to be installed for your game.

  1. Download CppExplorer.zip from Releases.
  2. Unzip the file into the Mods folder in your game's installation directory, created by MelonLoader.
  3. Make sure it's not in a sub-folder, CppExplorer.dll and mcs.dll should be directly in the Mods\ folder.

How to use

  • Press F7 to show or hide the menu.
  • Simply browse through the scene, search for objects, etc, it's pretty self-explanatory.

Mouse Control

CppExplorer can force the mouse to be visible and unlocked when the menu is open, if you have enabled "Force Unlock Mouse" (Left-Alt toggle). However, you may also want to prevent the mouse clicking-through onto the game behind CppExplorer, this is possible but it requires specific patches for that game.

  • For VRChat, use VRCExplorerMouseControl
  • For Hellpoint, use HPExplorerMouseControl
  • You can create your own mini-plugin using one of the two plugins above as an example. Usually only 1 or 2 simple Harmony patches are needed to fix the problem (if you want to submit that here, feel free to make a PR to this Readme).

Images

Scene Explorer, GameObject Inspector, and Reflection Inspectors:

Object Search:

C# REPL console:

Credits

Written by Sinai.

Thanks to:

  • ManlyMarco for their Runtime Unity Editor, which I used for the REPL Console and the "Find instances" snippet, and the UI style.
  • denikson for mcs-unity. I commented out the SkipVisibilityExt constructor in mcs.dll since it was causing an exception with the Hook it attempted.
Description
An in-game UI for exploring, debugging and modifying IL2CPP and Mono Unity games.
Readme GPL-3.0
Languages
C# 98.3%
PowerShell 1.7%