用于探索、调试和修改Unity游戏的内置界面

🔍 用于探索、调试和修改 Unity 游戏的游戏内 UI。
由以下技术提供支持 宇宙库
这个UnityExplorer分支专注于 Unity 6.3 Mono 支持。
_{目前没有计划支持IL2CPP和更新的Unity版本。}
如果有任何漏洞或你希望添加的功能，请 打开问题

发布

BepInEx

松开	IL2CPP（Il2Cpp互操作）	IL2CPP（反混淆器）	单声道	Unity 6.3 Mono
需 BIE 6.X be.647+ 或 BIE 6.0-pre.2+	✅ 链接	✖️ 不适用	✅ 链接	✅ 链接
BIE 6.X be.472 至 be.577 或 BIE 6.0-pre.1(非预发布2)	✅ 链接	✅ 链接	✅ 链接	✖️ 不适用
BIE 5.X	✖️ 不适用	✖️ 不适用	✅ 链接	✅ 链接

1. 将发布文件解压到一个文件夹中
2. 拿起 插件/sinai-dev-UnityExplorer 文件夹并将其放入 BepInEx/plugins/

注意：BepInEx 6 可通过以下方式获取 builds.bepinex.dev

MelonLoader

释放	IL2CPP	单声道	Unity 6.3 Mono
等级0.6以上	✅ 链接	✖️ 无	✖️ 不适用
ML 0.6(仅0.6阿尔法版本，非贝塔版)	✅ 链接	✖️ 不适用	✖️ 不适用
0.5毫升	✅ 链接	✅ 链接	✅ 链接

1. 将发布文件解压到一个文件夹中
2. 将DLL复制到 模组 将文件夹放入你的MelonLoader中 模组 文件夹
3. 将其中所有的 DLL 文件复制到 用户库 文件夹放入你的MelonLoader 用户库 文件夹

独立运行

IL2Cpp互操作层	脱壳者	单声道	Unity 6.3 Mono
✅ 链接	✅ 链接	✅ 链接	✅ 链接

独立版本可与您选择的任何注入器或加载器配合使用，但需要您手动加载依赖项。

1. 确保所需的库已加载 - UniverseLib、HarmonyX 和 MonoMod。将它们从 Unity资源管理器编辑器 需要时就释放它们。
2. 对于IL2CPP，加载Il2CppAssemblyUnhollower并启动一个 Il2CppAssemblyUnhollower 运行时
3. 加载 UnityExplorer DLL
4. 创建一个 Unity Explorer 实例，使用 UnityExplorer.ExplorerStandalone.CreateInstance();
5. 可选择订阅 探险家独立版.日志记录 处理日志记录的事件（如果你需要）

Unity 编辑器

1. 下载 UnityExplorer.编辑器 释放。
2. 通过包管理器导入并安装该包，或者 package.json 文件，或手动将文件夹拖入您的 资产 文件夹。
3. 拖动 运行时/UnityExplorer 将预制体拖入场景，或创建一个游戏对象并添加 探索者编辑器行为 把它写成脚本。

常见问题与解决方法

尽管UnityExplorer对大多数Unity游戏应该开箱即用，但在某些情况下，你可能需要调整设置才能让它正常工作。

要调整设置，请打开配置文件：

• BepInEx： BepInEx\config\com.sinai.unityexplorer.cfg
• MelonLoader： UserData\MelonPreferences.cfg
• 独立： sinai-dev-UnityExplorer\config.cfg

尝试调整以下设置，看看是否能解决您的问题：

• 启动延迟时间 - 增加到5-10秒（或按需更长），可以修复UnityExplorer在启动时被销毁或损坏的问题。
• 禁用事件系统覆盖 - 如果输入无法正常工作，请尝试将其设置为 真.
• 禁用设置强制重新加载托管程序集 - 如果 Mono 游戏在启动时无法解析程序集依赖项，请尝试将其设置为 真（详情：yukieiji/UniverseLib#4）。
• 绕过_UniverseLib_ICall - 如果你在某些游戏中检查精灵或类似对象时出现错误，请尝试将其设置为 真.

如果这些修复方法不起作用，请在此仓库中创建一个问题，我会尽力调查。

功能

检查器 API

如果你想从C#控制台外部检查某个对象或类型，请使用 检查员管理器 职业：

检查物体：

UnityExplorer.InspectorManager.Inspect(theObject);

查看类型：

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

对象资源管理器

• 使用 场景浏览器 按 Tab 键可遍历活动场景，以及 DontDestroyOnLoad 和 HideAndDontSave 对象。
  • “HideAndDontSave”场景包含带有该标记的对象，以及不在任何场景中但行为方式相同的资源和资产。
  • 你可以使用场景加载器轻松加载构建中的任何场景（可能不适用于Unity 5.X游戏）
• 使用 对象搜索 按 Tab 键搜索 Unity 对象（包括 GameObject、组件等）、C# 单例或静态类。
  • 使用 UnityObject 搜索来查找任何派生自 UnityEngine.Object，可選篩選條件
  • 单例搜索会查找任何带有典型“Instance”字段的类，并检查其当前值。由于我们无法区分真实属性和字段属性，某些属性访问器会被调用，这可能会在某些IL2CPP游戏中导致意外行为。

督察员

检查器用于查看任意类型对象的详细信息并操作其值，同时也可通过静态反射检查 C# 类。

• 这 游戏对象检查器 （制表符前缀 [G]) 用于检查一个 游戏对象，并查看和操作其变换和组件。
  • 你可以编辑检查器中的任何输入字段（只读字段除外），然后按 进入 来应用你的更改。你也可以对游戏对象路径执行此操作，以此更改游戏对象的父级。按下 退出 按此键取消编辑。
  • 注意：检查带有Canvas的GameObject时，变换控制可能会被RectTransform锚点覆盖。
• 这 反射检查器 （tab前缀 [R] 和 [系统]）用于其他所有情况
  • 默认情况下未启用自动更新，您必须按“应用”才能使所做的任何更改生效。
  • 按 ▼ 用于展开特定值的按钮，如字符串、枚举、列表、字典、部分结构体等
  • 使用顶部的筛选器快速找到您要查找的成员
  • 对于 Texture2D, 图片, 精灵 和 材料 物体，有一个 查看纹理 检查器顶部的按钮，可让你查看纹理并将其保存为 PNG 文件。
  • 对于 音频片段 那里的物体有一个 显示玩家 打开音频播放器组件的按钮。对于作为 加载时解压，还有一个按钮可以将它们保存到 .wav 文件。

C# 控制台

• C# 控制台使用 Mono.CSharp.求值器 定义临时类或运行即时REPL代码。
• 你可以在启动时自动执行脚本，只需将其命名为 启动.cs 并将其放入 sinai-dev-UnityExplorer\脚本\ 文件夹（此文件夹将在您放置 DLL 文件的位置创建）。
  • 你也可以加载/保存/编译 客户端 以下文件位于 sinai-dev-UnityExplorer\Scripts\ 文件夹
    • 加载中：按下 刷新（重命名为重置）按钮并选择下拉菜单中的文件名。
    • 保存：按下 编译 点击按钮，并自动使用下拉菜单中选择的文件名保存文件
• 更多详细信息请查看 C# 控制台菜单中的“Welcome”下拉菜单。

钩子管理器

• 挂钩面板允许您通过点击按钮来挂钩方法，以便进行调试。
  • 只需输入任意类，然后从菜单中挂接你需要的方法。
  • 你可以使用“编辑钩子源代码”按钮来编辑生成的钩子的源代码。可接受的方法名称为 前缀 （可能返回 布尔值 或 虚空), 后缀, 终结者 （可能返回 异常 或 虚空），以及 转译器 （必须返回 可枚举的和谐库代码指令)。你可以根据需要定义多个补丁。

鼠标查看

• “检查器”面板中的“鼠标检查”下拉菜单允许你检查鼠标下的对象。
  • 世界: 使用Physics.Raycast来查找碰撞体
  • 界面使用图形射线检测器来查找UI对象

自由视角

• UnityExplorer 提供了一个基础的自由相机，你可以用键盘和鼠标来控制它。
• 与UnityExplorer的其他所有功能不同，即使UnityExplorer菜单隐藏时，你仍然可以使用自由视角。
• 支持使用游戏的主摄像机或单独的自定义摄像机。
• 查看自由视角面板以获取更多说明和详细信息。

剪贴板

• “剪贴板”面板可让你查看当前的粘贴值，或将其清除（重置为 null)
  • 可以从反射检查器、可枚举或字典中的任意成员复制值，也可以从任意检查器标签页的目标复制值
  • 可以将值粘贴到反射检查器中的任意成员上
  • 方法/属性求值器中不可解析的参数允许粘贴值
  • C# 控制台具有辅助方法 复制(对象) 和 粘贴() 访问剪贴板

设置

• 你可以通过菜单中的“选项”标签页更改设置，也可以直接修改配置文件。
  • BepInEx： BepInEx\config\com.sinai.unityexplorer.cfg
  • MelonLoader： 用户数据\MelonPreferences.cfg
  • 独立 {DLL_location}\sinai-dev-UnityExplorer\config.cfg

建筑

1. 运行 build.ps1 用于构建UnityExplorer的PowerShell脚本。发布版本可在 释放 文件夹。

从IDE构建单独的配置是可以的，但请注意初始构建过程会生成到 发布/<version>/... 而不是 PowerShell 脚本所使用的子文件夹。该项目目前不支持批量构建。

致谢

• 雪影寺 感谢维护他们的分支 Unity探索器，最初由 西奈开发.

• 曼利马可 对于 运行时 Unity 编辑器 [许可证]，RUE 的 REPL 控制台中的 ScriptEvaluator 被用作 UnityExplorer 的 C# 控制台的基础。
• 杰弗里·霍辛顿 为了 mcs-unity [无许可]，用作 Mono.CSharp C# 控制台的参考。

免责声明

UnityExplorer 与 Unity Technologies 无任何关联。“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国及其他地区的商标或注册商标。