Skip to content

Commit ff01eae

Browse files
authored
Create README.md for Unity Tools documentation
Added detailed documentation for Unity Tools, including features, architecture, and usage instructions.
1 parent d3a70fd commit ff01eae

File tree

1 file changed

+284
-0
lines changed

1 file changed

+284
-0
lines changed

README.md

Lines changed: 284 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,284 @@
1+
# Unity Tools
2+
3+
> 2026.02.21 | Unity Game Hacking Tool
4+
5+
## 简介
6+
7+
Unity Tools 是一款基于 minihook 和 ImGui 开发的 Unity 游戏作弊工具,提供类浏览、内存操作、图形绘制、Shader 修改等多种功能。
8+
9+
## 技术架构
10+
11+
- **渲染引擎**: DirectX All (通过 minihook 库 Hook)
12+
- **UI 框架**: ImGui (中文支持)
13+
- **游戏框架**: Unity IL2CPP
14+
15+
## 功能概览
16+
17+
### 主菜单栏
18+
19+
工具栏位于窗口顶部,包含以下功能入口:
20+
21+
| 菜单项 | 说明 |
22+
|--------|------|
23+
| 全局管理 | 类结构浏览、变量编辑、方法查看 |
24+
| 内存扫描 | 内存扫描功能 (开发中) |
25+
| 内存绘制 | 内存地址管理与图形绘制 |
26+
| 着色器绘制 | Shader 全局属性修改 |
27+
| 主题 | UI 主题切换 |
28+
| 配置 | 语言、快捷键设置 |
29+
30+
### 状态显示
31+
32+
菜单栏右侧显示实时信息:
33+
- **FPS**: 帧率显示 (绿色 ≥100, 黄色 60-100, 红色 <60)
34+
- **DateTime**: 当前系统时间
35+
- **Unity**: 游戏使用的 Unity 版本
36+
37+
---
38+
39+
## 功能详情
40+
41+
### 1. 全局管理 (Global Management)
42+
43+
核心功能模块,提供完整的类结构分析能力。
44+
45+
#### 1.1 三列布局
46+
47+
```
48+
┌─────────────┬─────────────┬─────────────────────┐
49+
│ Assembly │ 类名 │ 变量 & 方法 │
50+
│ (程序集) │ (搜索+筛选) │ (实例搜索+编辑) │
51+
├─────────────┼─────────────┼─────────────────────┤
52+
│ Assembly-1 │ Class.A │ [变量表格] │
53+
│ Assembly-2 │ Class.B │ - 偏移 │
54+
│ Assembly-3 │ Class.C │ - 名称 │
55+
│ ... │ ... │ - 类型 │
56+
│ │ │ - 值 (可编辑) │
57+
│ │ │ [方法表格] │
58+
│ │ │ - 方法名 │
59+
│ │ │ - 返回值 │
60+
│ │ │ - 参数 │
61+
└─────────────┴─────────────┴─────────────────────┘
62+
```
63+
64+
#### 1.2 程序集列表 (第一列)
65+
66+
- 显示所有已加载的 IL2CPP 程序集
67+
- 支持搜索过滤
68+
- 点击加载对应类的列表
69+
70+
#### 1.3 类名列表 (第二列)
71+
72+
- 显示选定程序集中的所有类
73+
- **搜索框**: 模糊搜索类名
74+
- **类型筛选**:
75+
- `All` - 显示全部
76+
- `System` - 系统类
77+
- `Unity` - Unity 类
78+
- `Custom` - 自定义类
79+
80+
#### 1.4 变量与方法 (第三列)
81+
82+
##### 实例搜索
83+
84+
| 按钮 | 功能 |
85+
|------|------|
86+
| 编辑 | 手动输入实例地址 |
87+
| 寻找 | 自动搜索类的实例 |
88+
89+
##### 变量表格
90+
91+
支持编辑以下类型:
92+
93+
| 类型 | 编辑方式 | 说明 |
94+
|------|----------|------|
95+
| `int` / `uint` | 双击编辑 | 32位整数 |
96+
| `float` | 双击编辑 | 单精度浮点 |
97+
| `double` | 双击编辑 | 双精度浮点 |
98+
| `bool` | 下拉框 | 布尔值 |
99+
| `byte` | 双击编辑 | 字节 (0-255) |
100+
| `string` | 双击编辑 | 字符串 |
101+
102+
> **注意**: 静态方法以蓝色背景高亮显示
103+
104+
##### 其他功能
105+
106+
- **Tag 标签寻找**: 获取选中实例的 Tag
107+
- **结构生成**: 复制类结构代码到剪贴板 (C# 格式)
108+
- **Dump global-metadata.dat**: 导出 IL2CPP 元数据文件
109+
110+
##### Metadata Dump
111+
112+
支持两种地址格式:
113+
```
114+
格式1: GameAssembly.dll+0x1000
115+
格式2: 0x12345678
116+
```
117+
118+
---
119+
120+
### 2. 内存扫描 (Memory Scanner)
121+
122+
> ⚠️ 功能开发中
123+
124+
---
125+
126+
### 3. 内存绘制 (Memory Drawer)
127+
128+
内存地址管理与图形绘制工具。
129+
130+
#### 3.1 功能布局
131+
132+
```
133+
┌─────────────────┬─────────────────┐
134+
│ 内存地址 │ 绘制设置 │
135+
├─────────────────┼─────────────────┤
136+
│ [地址输入框] │ [类型选择] │
137+
│ - 添加地址 │ - 矩形 │
138+
│ - 移除地址 │ - 圆形 │
139+
│ [地址列表] │ - 线条 │
140+
│ │ - 文本 │
141+
│ │ [颜色选择] │
142+
│ │ [大小滑块] │
143+
│ │ [开始绘制] │
144+
│ │ [清除绘制] │
145+
│ │ [工具折叠栏] │
146+
└─────────────────┴─────────────────┘
147+
```
148+
149+
#### 3.2 地址管理
150+
151+
- 输入十六进制地址 (如 `0x7FF6A1234000`)
152+
- 支持添加/移除地址
153+
- 地址列表可重复选择
154+
155+
#### 3.3 绘制设置
156+
157+
- **绘制类型**: 矩形、圆形、线条、文本
158+
- **颜色**: RGBA 颜色选择器
159+
- **大小**: 1-100 滑块调节
160+
161+
#### 3.4 工具选项
162+
163+
- 是否可视 (显示/隐藏绘制)
164+
- 获取坐标 (3秒显示实体坐标)
165+
166+
---
167+
168+
### 4. 着色器绘制 (Shader Drawer)
169+
170+
Shader 全局属性修改工具。
171+
172+
#### 4.1 功能布局
173+
174+
```
175+
┌─────────────────┬─────────────────┐
176+
│ 着色器列表 │ 着色器属性 │
177+
├─────────────────┼─────────────────┤
178+
│ [搜索框] │ [着色器名称] │
179+
│ [着色器列表] │ │
180+
│ - 按字母排序 │ [设定全局] │
181+
│ - 搜索过滤 │ - 属性名输入 │
182+
│ [刷新按钮] │ - 类型选择 │
183+
│ │ • SetGlobalInt │
184+
│ │ • SetGlobalFloat │
185+
│ │ • SetGlobalVector │
186+
│ │ • SetGlobalColor │
187+
│ │ • SetGlobalMatrix │
188+
│ │ - 值输入 │
189+
│ │ [全局操作] │
190+
│ │ - 画质等级设定 │
191+
└─────────────────┴─────────────────┘
192+
```
193+
194+
#### 4.2 支持的属性类型
195+
196+
| 函数 | 参数类型 |
197+
|------|----------|
198+
| `SetGlobalInt` | Int32 |
199+
| `SetGlobalFloat` | Single (float) |
200+
| `SetGlobalVector` | Vector4 |
201+
| `SetGlobalColor` | Color (RGBA) |
202+
| `SetGlobalMatrix` | Matrix4x4 |
203+
204+
#### 4.3 特性
205+
206+
- 实时搜索过滤
207+
- 刷新检测新着色器 (淡蓝色高亮)
208+
- 属性值实时预览
209+
210+
---
211+
212+
### 5. 主题设置 (Theme Settings)
213+
214+
UI 主题自定义功能。
215+
216+
#### 5.1 预设主题
217+
218+
| 主题 | 说明 |
219+
|------|------|
220+
| 默认 | ImGui 深色主题 |
221+
| 明亮 | ImGui 浅色主题 |
222+
| 紫色 | ImGui 经典主题 |
223+
| 自定义 | 用户自定义颜色 |
224+
225+
#### 5.2 自定义颜色选项
226+
227+
可自定义的 UI 元素:
228+
- 窗口背景
229+
- 标题背景 / 活动标题 / 折叠标题
230+
- 标题栏 / 悬停 / 激活
231+
- 按钮 / 悬停 / 激活
232+
- 输入框背景 / 悬停 / 激活
233+
- 文本 / 禁用文本
234+
235+
---
236+
237+
### 6. 配置 (Configuration)
238+
239+
#### 6.1 语言设置
240+
241+
| 选项 | 说明 |
242+
|------|------|
243+
| 中文 | 简体中文界面 |
244+
| English | 英文界面 [暂未开放] |
245+
246+
#### 6.2 快捷键设置
247+
248+
- **菜单显示/隐藏**: 默认 `Insert`
249+
- 支持自定义按键 (F1-F12, Home, End, PageUp/Down 等)
250+
251+
#### 6.3 配置保存
252+
253+
- 保存路径: `Cofig1.ini`
254+
- 保存内容: 语言设置、快捷键
255+
256+
---
257+
258+
## 快捷键
259+
260+
| 按键 | 功能 |
261+
|------|------|
262+
| `Insert` | 显示/隐藏主菜单 |
263+
| `鼠标左键` | UI 交互 |
264+
| `鼠标右键` | UI 交互 |
265+
266+
---
267+
268+
## 依赖库
269+
270+
- **kiero**: DirectX Hook 库
271+
- **ImGui**: GUI 框架
272+
- **FontAwesome**: 图标字体
273+
274+
---
275+
276+
## 注意事项
277+
278+
1. 本工具仅供学习交流,请勿用于商业作弊
279+
2. 使用前请备份游戏数据
280+
3. 部分功能可能因游戏更新而失效
281+
282+
---
283+
284+
*文档更新于 2026.02.21*

0 commit comments

Comments
 (0)