Unity 日志查看器

UnityLogViewer

一个适用于任何 BepInEx 5 Unity 游戏的内置日志查看器覆盖层，旨在帮助模组开发过程中的调试工作。

功能特性

• 实时游戏内日志覆盖层，显示 Unity 日志输出
• 可拖拽、可调整大小的窗口
• 支持正则表达式的实时文本过滤
• 自动滚动以跟随新的日志条目
• 固定模式：锁定窗口位置并隐藏装饰，实现不显眼的平视显示
• 可配置的语法高亮，包含 8 个颜色编码的正则规则（错误、警告、调试等）
• 可调节的背景透明度

安装

Thunderstore / r2modman

• 通过 Thunderstore 模组管理器或 r2modman 安装。
• 或
• 从 Thunderstore 下载模组，并按照下方的手动安装说明进行操作。

Nexus Mods / Vortex

• 通过 Vortex 模组管理器安装。
• 或
• 从 Nexus Mods 下载模组，并按照下方的手动安装说明进行操作。

手动安装

1. 为你的游戏安装 BepInEx 5。
2. 下载 UnityLogViewer 的最新版本。
3. 将 UnityLogViewer.dll 文件解压到你的 BepInEx/plugins 目录中。

使用方法

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

• 筛选 — 在筛选栏中输入内容以仅显示匹配的行。支持正则表达式；如果正则表达式无效，则回退为纯文本搜索。
• ⌫ — 清除当前筛选条件。
• 清除 — 清除当前缓冲区。
• 自动滚动 — 启用时（默认），视图会自动滚动到最新的日志条目。关闭它以冻结视图并手动滚动。
• 固定 — 点击标题栏中的固定按钮以锁定窗口位置。固定模式会隐藏标题栏、筛选栏和调整大小手柄，仅留下透明背景上的日志文本。点击右上角的取消固定按钮以恢复完整窗口。
• 调整大小 — 拖拽窗口右下角的手柄来调整大小。
• 拖拽 — 拖拽标题栏来重新定位窗口。

配置

配置文件 com.malafein.unitylogviewer.cfg 在首次运行后生成于你的 BepInEx/config 文件夹中。设置也可以通过游戏内的 配置管理器 进行更改。

常规

设置	默认值	描述
ShowWindow	false	开启/关闭日志查看器窗口。如果快捷键在你的游戏输入系统中无效，可使用此项。
ToggleShortcut	F7	切换日志查看器的键盘快捷键。
Filter	（空）	持久的筛选字符串（支持正则表达式）。
FontName	（空）	用于日志文本的字体。留空以使用默认 UI 字体。如果运行时检测到有效的操作系统字体，日志查看器窗口中会显示一个选择器。注意：字体选择功能尚未在所有平台上测试。
BackgroundOpacity	40	日志窗口的背景透明度 (0–100)。
Pinned	false	固定日志视图，隐藏窗口装饰并禁用交互。
BufferSize	500	缓冲区中保留的最大日志行数 (100–5000)。

窗口

这些值会在你移动或调整窗口大小时自动保存和更新，以便在你的会话之间保留首选布局。

设置	默认值	描述
WindowX	833	窗口的水平位置（从左边缘开始的像素数）。
WindowY	1019	窗口的垂直位置（从顶部开始的像素数）。
WindowWidth	1507	窗口的宽度（像素）。
WindowHeight	300	窗口的高度（像素）。

高亮

八个可配置的高亮槽位允许你通过模式对日志行进行颜色编码。每个槽位都有一个模式和一个颜色设置。第一个匹配的规则生效。

设置	默认值	描述
Highlight1Pattern	\[ERROR\]	高亮规则 1 的正则模式。
Highlight1Color	red	高亮规则 1 的颜色。
Highlight2Pattern	\[WARNING\]	高亮规则 2 的正则模式。
Highlight2Color	yellow	高亮规则 2 的颜色。
Highlight3Pattern	`[DEBUG]	[DBG]`
Highlight3Color	cyan	高亮规则 3 的颜色。
Highlight4Pattern	\[INFO\]	高亮规则 4 的正则模式。
Highlight4Color	white	高亮规则 4 的颜色。
Highlight5–8	（空）	可用于自定义规则的额外槽位。

颜色可以指定为命名颜色（red, yellow, cyan, green, blue, magenta, orange, white）或十六进制值（#RRGGBB）。

更新日志

版本历史请参见 CHANGELOG.md。