Unity 日志查看器

Unity日志查看器

一个用于任何BepInEx 5 Unity游戏的游戏内日志查看器覆盖层，旨在帮助开发模组时进行调试。

功能

• 实时游戏内日志叠加层，显示Unity日志输出
  

- 可拖动、可调整大小的窗口
- 支持正则表达式的实时文本过滤器
- 自动滚动以跟上新的日志条目
- 固定模式可将窗口锁定到位并隐藏装饰，以获得不显眼的抬头显示
- 可配置的语法高亮，支持8种颜色编码的正则表达式规则（错误、警告、调试等）
- 可调节背景不透明度

安装

### Thunderstore / r2modman
- 通过Thunderstore Mod Manager或r2modman安装。
或
- 从以下位置下载模组 雷暴商店，并按照下面的手动安装说明进行操作。

### Nexus Mods / Vortex
- 通过Vortex Mod管理器安装。
或
- 从以下位置下载模组 Nexus Mods，并按照下方的手动安装说明进行操作。

### 手动安装
安装 BepInEx 5 给你的游戏。
2. 下载最新版本的 UnityLogViewer。
3. 将 [mono]UnityLogViewer.dll[/mono] 文件解压到你的 [mono]BepInEx/plugins[/mono] 目录中。

用途

按下 F7 （默认）切换日志查看器窗口。该窗口显示最近的日志输出（默认为500行，可通过BufferSize配置）。

• 筛选 — 在筛选栏中输入内容以仅显示匹配的行。支持正则表达式；若正则表达式无效，则回退为纯文本搜索。
  

- ⌫ — 清除当前筛选。
- 清除 — 清空当前缓冲区。
- 自动滚动 — 启用时（默认），视图会自动滚动到最新日志条目。关闭后可冻结视图并手动滚动。
- 别针 — 点击标题栏中的固定按钮，将窗口锁定在当前位置。固定模式下会隐藏标题栏、过滤栏和调整大小手柄，仅在透明背景上显示日志文本。点击右上角的取消固定按钮可恢复完整窗口。
- 调整大小 — 拖动窗口右下角的手柄可调整大小。
- 拖拽 — 拖动标题栏可重新定位窗口。

配置

首次运行后，配置文件[mono]com.malafein.unitylogviewer.cfg[/mono]会生成在[mono]BepInEx/config[/mono]文件夹中。设置也可以在游戏内通过以下方式修改： 配置管理器.

### 通用

| 设置 | 默认 | 描述 |
|---|---|---|
| ShowWindow | false | 开启或关闭日志查看器窗口。如果你的游戏的输入系统无法使用热键，请使用此项。 |
| ToggleShortcut | F7 | 切换日志查看器的键盘快捷键。 |
| 筛选 | i[/i] | 持久过滤字符串（支持正则表达式）。 |
|字体名称 | i[/i] | 用于日志文本的字体。留空则使用默认界面字体。如果运行时检测到有效的操作系统字体，日志查看器窗口中会出现一个选择器。 注意：字体选择尚未在所有平台上进行测试。 |
| 背景不透明度 | 40 | 日志窗口的背景不透明度（0–100）。 |
| 固定 | false | 将日志视图固定到位，隐藏窗口装饰并禁用交互。 |
| BufferSize | 500 | 缓冲区中保留的最大日志行数（100–5000）。 |

窗口

移动或调整窗口大小时，这些设置会自动保存并更新，因此你偏好的布局会在会话之间保留。

| 设置 | 默认值 | 说明 |
|---|---|---|
| WindowX | 833 | 窗口的水平位置（距左侧的像素数）。 |
| WindowY | 1019 | 窗口的垂直位置（距顶部像素）。 |
| WindowWidth | 1507 | 窗口宽度，单位为像素。 |
| WindowHeight | 300 | 窗口高度（像素）。 |

### 高亮

八个可配置的高亮槽位，让你按模式为日志行进行颜色标记。每个槽位包含一个模式和一个颜色设置。最先匹配的规则生效。

| 设置 | 默认值 | 描述 |
|---|---|---|
| Highlight1Pattern | [mono]\[错误\][/mono] | 高亮规则1的正则表达式。 |
| Highlight1Color | red | 高亮规则1的颜色。 |
| Highlight2Pattern | [mono]\[警告\][/mono] | 高亮规则2的正则表达式。 |
| Highlight2Color | yellow | 高亮规则2的颜色。 |
| Highlight3Pattern | [mono]\[DEBUG\]\|\[DBG\][/mono] | 高亮规则3的正则表达式。 |
| Highlight3Color | cyan | 高亮规则3的颜色。 |
| Highlight4Pattern | [mono]\[INFO\][/mono] | 高亮规则4的正则表达式。 |
| Highlight4Color | white | 高亮规则4的颜色。 |
| 高亮5–8 | i[/i] | 自定义规则可使用额外槽位。 |

颜色可以用颜色名称（红、黄、青、绿、蓝、品红、橙、白）或十六进制值（#RRGGBB）来指定。

更新日志

查看[mono]CHANGELOG.md[/mono]了解版本历史。