
取景器
一个用于Fabric上Iris的着色器调试模组,它暴露了一个MCP服务器和游戏内命令,供外部工具和脚本检查、测试和自动化着色器开发工作流。
Viewfinder
一个用于 Iris 的 Fabric 着色器调试模组,提供 MCP 服务器和游戏内命令,供 AI 代理检查、测试和自动化着色器开发工作流。
功能
- 着色器重载与错误列表 - 触发着色器重载并捕获编译错误
- 按需 GPU 性能分析 - 在固定帧窗口内收集分层级的逐 pass 计时,且不会产生持久的查询开销
- 管线与程序检查 - 观察嵌套的 Iris pass,并反射已链接程序的 uniform、UBO 和 SSBO
- 纹理转储 - 检查或导出主/备用 colortex、深度、阴影、噪声和自定义纹理
- SSBO 缓冲区转储 - 将着色器存储缓冲区对象转储到磁盘以供分析
- 截图调度 - 以可配置的帧延迟调度截图(用于 PT)
- 已修补着色器列表 - 通过列出所有着色器并搜索 "errored",以编程方式找出哪个已修补着色器出错
- 交互式聊天输出 - 从聊天中复制路径、打开已转储文件并插入后续命令
- 代理诊断快照 - 一个 JSON 负载,包含着色器包、渲染、错误、指标、纹理、SSBO 和建议的后续操作
- 有界检查探针 - 在转储大型 GPU 资源之前检查纹理统计/像素和 SSBO 字节预览
- Pass 输出捕获 - 在选定的 Iris pass 结束时导出帧缓冲附件
- 着色器修改 - 编辑目录包源码或选项,并通过结构化诊断进行重载
- 确定性场景 - 定位权威单人玩家、设置时间/天气,以及冻结或步进 tick
安装
- 为 Minecraft 26.1 或 26.2 安装 Fabric Loader
- 安装 Fabric API 和 Iris(后者需要 Sodium)
- 将与你的 Minecraft 版本匹配的 Viewfinder
.jar放入mods/文件夹 - 如需安装 MCP,查看仓库。
用法
游戏内命令
所有命令均注册在 /viewfinder 下:
| 命令 | 描述 |
|---|---|
/viewfinder status |
显示当前着色器包名称、错误数量和 MCP 地址 |
/viewfinder snapshot |
汇总代理诊断快照 |
/viewfinder reload |
重载着色器并报告任何编译错误 |
/viewfinder errors |
列出所有捕获的着色器错误 |
/viewfinder errors all |
列出完整的捕获错误缓冲区 |
/viewfinder errors clear |
清除捕获的着色器错误 |
/viewfinder screenshot [frames] |
截图(可选延迟 N 帧) |
/viewfinder screenshot result |
显示最后一张截图的路径 |
/viewfinder metrics |
显示最后捕获的 GPU 计时 |
/viewfinder metrics capture [frames] |
对接下来固定数量的帧进行性能分析 |
/viewfinder metrics reset |
清除收集的 GPU 计时样本 |
/viewfinder ssbo list |
列出活动的 SSBO 缓冲区 |
/viewfinder ssbo inspect <index> [bytes] |
以十六进制、int、uint 和 float 值预览 SSBO 字节 |
/viewfinder ssbo dump <index> |
将 SSBO 缓冲区转储到 ssbo_dumps/ |
/viewfinder texture list |
列出可用的 colortex 和自定义纹理 |
/viewfinder texture inspect name <name> [samples] |
按名称探测纹理元数据、样本和通道统计信息 |
/viewfinder texture inspect id <id> [samples] |
按 GL id 探测纹理元数据、样本和通道统计信息 |
/viewfinder texture sample name <name> <x> <y> [z] |
按名称读取特定纹理像素 |
/viewfinder texture sample id <id> <x> <y> [z] |
按 GL id 读取特定纹理像素 |
/viewfinder texture dump name <name> [raw] |
按名称转储纹理(PNG 或原始数据) |
/viewfinder texture dump id <id> [raw] |
按 GL id 转储纹理(PNG 或原始数据) |
/viewfinder patched_shaders |
列出 Iris 已修补的着色器文件 |
聊天输出在 Minecraft 支持的情况下使用可点击控件:已转储的文件路径可以打开或复制,列表输出包含转储命令建议,捕获的错误包含复制完整消息和堆栈跟踪的按钮。
MCP 服务器
当 Minecraft 客户端启动时,Viewfinder 会自动在以下地址启动一个无状态 Streamable HTTP MCP 服务器:
http://127.0.0.1:7150/mcp
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。