Viewfinder

模组

· 作者 xirreal

一个用于 Iris 的着色器调试模组,适用于 Fabric,它暴露了一个 MCP 服务器和游戏中命令,供外部工具和脚本检查、测试以及自动化着色器开发工作流程。

0 本站下载 0 关注 更新于 1 个月前

需要前置:Iris 光影、Fabric API

最新 v2.1.4+26.3 · 26.3 · Fabric

一键开服(送7天)

Viewfinder

一个用于 Iris 的光影调试模组,适用于 Fabric。它提供了一个 MCP 服务器以及游戏内命令,供 AI 代理检查、测试并自动化光影开发工作流。

功能

  • 光影重载与错误列表 - 触发光影重载并捕获编译错误
  • 按需 GPU 性能分析 - 在固定的帧窗口内收集分层级的逐遍(per-pass)耗时数据,且不会带来永久性的查询开销
  • 管线与程序检查 - 观察嵌套的 Iris 渲染遍次,并反映已链接程序的 Uniforms、UBOs 和 SSBOs
  • 纹理转储 - 检查或导出主/备用 colortex、深度、阴影、噪声及自定义纹理
  • SSBO 缓冲区转储 - 将着色器存储缓冲区对象(SSBO)转储到磁盘以供分析
  • 截图调度 - 支持设置带有可配置帧延迟(用于 PT)的截图计划
  • 修补后的着色器列表 - 通过列出所有着色器并搜索“errored”来以编程方式找出哪个修补后的着色器出错
  • 交互式聊天输出 - 从聊天中复制路径、打开转储的文件,并插入后续命令
  • 代理诊断快照 - 单个 JSON 负载包含 shaderpack、渲染信息、错误、指标、纹理、SSBOs 以及建议的下一步操作
  • 受限的检查探针 - 在转储大型 GPU 资源之前,检查纹理统计信息/像素和 SSBO 字节预览
  • 渲染遍次输出捕获 - 在选定的 Iris 渲染遍次结束时导出帧缓冲附件
  • 着色器变异 - 编辑目录包源文件或选项,并使用结构化诊断信息进行重载
  • 确定性场景 - 定位权威的单玩家玩家位置,设置时间/天气,并冻结或步进刻度(ticks)

安装

  1. 为 Minecraft 26.1 或 26.2 安装 Fabric Loader
  2. 安装 Fabric API 和 Iris(后者需要 Sodium)
  3. 将与你的 Minecraft 版本匹配的 Viewfinder .jar 放入 mods/ 文件夹
  4. 如需进行 MCP 安装,请查看仓库。

用法

游戏内命令

所有命令均注册在 /viewfinder 下:

命令 描述
/viewfinder status 显示当前 shaderpack 名称、错误数量和 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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源