取景器

取景器

一个用于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

安装

  1. 为 Minecraft 26.1 或 26.2 安装 Fabric Loader
  2. 安装 Fabric API 和 Iris(后者需要 Sodium)
  3. 将与你的 Minecraft 版本匹配的 Viewfinder .jar 放入 mods/ 文件夹
  4. 如需安装 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