Unity Explorer Tree Snapshooter

UnityExplorer Tree Snapshooter

A mod that captures GameObject hierarchy and component state to text files. Useful for Debugging with AI.

Preview

Dependencies

This mod requires:

• UnityExplorer - Required for the Inspector panel
• UniverseLib - UI framework used by UnityExplorer

How It Works

1. Harmony Patch - Patches InspectorPanel.ConstructPanelContent to add a "Snapshot" button in UnityExplorer's Inspector title bar
2. UI Panel - Opens SnapShooterPanel with:

• Current selection name and instance ID
• Save path input field (editable, retains custom path on selection change)
• "Snapshot Selection" button
• Log output area

1. Snapshot Process - When clicking "Snapshot Selection":

• Gets the currently inspected GameObject from UnityExplorer's InspectorManager
• Builds the parent chain (path from scene root to selected object)
• Builds the children hierarchy (all descendants with instance IDs)
• Reads all component state via reflection for each GameObject
• Formats and saves to text file

1. F7 Integration - The Snapshooter panel follows UnityExplorer's visibility toggle:

• When UnityExplorer is hidden (F7), the panel hides with it
• When UnityExplorer is shown (F7), the panel restores if it was open before
• Manually closing the panel (X) prevents it from reopening on F7 toggle

How to Use

1. Install UnityExplorer and this mod in Game/BepInEx/plugins/
2. Open UnityExplorer (default key: F7)
3. Select a GameObject in the Inspector panel
4. Click the "Snapshot" button in the Inspector title bar
5. Edit the save path if desired, or use the default location
6. Click "Snapshot Selection" to save

Snapshot Details

The snapshot output includes:

1. Parent Hierarchy

=== PARENT HIERARCHY ===
Root (InstanceID: 100)
  Level1 (InstanceID: 200)
    Player (InstanceID: 300)

2. Children Hierarchy

=== CHILDREN HIERARCHY ===
[0] Player (InstanceID: 300)
  [1] Child1 (InstanceID: 301)
  [1] Child2 (InstanceID: 302)

3. Components

=== COMPONENTS ===
  Transform (InstanceID: 456)
  Rigidbody (InstanceID: 789)

4. Reflection State

=== GAME OBJECT REFLECTION (ALL CHILDREN) ---

--- Player (InstanceID: 300) [SELECTED] ---
  Transform (InstanceID: 456):
    property m_LocalPosition: (0, 0, 0)
    property m_LocalRotation: (0, 0, 0, 1)
  Rigidbody (InstanceID: 789):
    property mass: 1

--- Child1 (InstanceID: 301) ---
  Transform (InstanceID: 1001):
    property m_LocalPosition: (1, 2, 3)

5. Outside References

When a field references a GameObject outside the selection, it's marked:

field m_Parent: [OUTSIDE_REFERENCE: InstanceID=999, Type=Transform] ParentName

Default Snapshot Location

By default, snapshots are saved to:

{Mod Location}/Snapshots/TreeSnapShooter_{GameObjectName}_{yyyy-MM-dd_HH-mm-ss}.txt

Example:

Game/BepInEx/plugins/UnityExplorerTreeSnapShooter/Snapshots/TreeSnapShooter_Player_2026-03-27_10-30-00.txt

Users can override the save path by entering a custom directory or file path in the input field.

How to set up

To manually set up, do the following

1. Create the directory: Game\BepInEx\plugins\UnityExplorerTreeSnapShooter\.
2. Extract the archive into any directory(recommend empty).
3. Move the contents of the plugins\ directory from the archive into the BepInEx\plugins\UnityExplorerTreeSnapShooter\ directory you created.
4. It should look like Game\BepInEx\plugins\UnityExplorerTreeSnapShooter\UnityExplorerTreeSnapShooter.dll

Launch the game.

If you liked the mod leave a star on GitHub it's free