
Modrinth · Minecraft mod
Viewfinder
A shader debugging mod for Iris on Fabric that exposes an MCP server and in-game commands for external tools and scripts to inspect, test, and automate shader development workflows.
Quick answer
Which Viewfinder release matches 26.2 Fabric?
Viewfinder v2.1.4+26.2 targets 26.2 with Fabric. It must be installed on the client. Do not install it on the dedicated server. All 3 required mods have matching files.
Where it goes
Is Viewfinder required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This file is marked client-only.
What else does Viewfinder v2.1.4+26.2 need?
v2.1.4+26.2 on 26.2 Fabric. Every mod below is checked against that same setup.
Install Fabric API, Iris Shaders, Sodium first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
1 extra mod was pulled in by another dependency. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Viewfinder without breaking your instance.
Built for Viewfinder v2.1.4+26.2 on 26.2 Fabric. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use v2.1.4+26.2. It targets 26.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API, Iris Shaders, Sodium first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside v2.1.4+26.2. It opens that exact file at the source.
About this project
What does Viewfinder add?
Viewfinder
A shader debugging mod for Iris on Fabric that exposes an MCP server and in-game commands for AI agents to inspect, test, and automate shader development workflows.
Features
- Shader reload and error list - trigger shader reloads and capture compilation errors
- On-demand GPU profiles - collect hierarchical per-pass timings over a fixed frame window without permanent query overhead
- Pipeline and program inspection - observe nested Iris passes and reflect linked program uniforms, UBOs, and SSBOs
- Texture dumping - inspect or export main/alternate colortex, depth, shadow, noise, and custom textures
- SSBO buffer dumping - dump shader storage buffer objects to disk for analysis
- Screenshot scheduling - schedule screenshots with configurable frame delay (for PT)
- Patched shader listing - find which patched shader errored programmatically by listing all and searching for "errored"
- Interactive chat output - copy paths, open dumped files, and insert follow-up commands from chat
- Agent diagnostics snapshot - one JSON payload with shaderpack, render, errors, metrics, textures, SSBOs, and suggested next actions
- Bounded inspection probes - inspect texture stats/pixels and SSBO byte previews before dumping large GPU resources
- Pass output capture - export framebuffer attachments at the end of a selected Iris pass
- Shader mutation - edit directory-pack sources or options and reload with structured diagnostics
- Deterministic scenes - position the authoritative singleplayer player, set time/weather, and freeze or step ticks
Installation
- Install Fabric Loader for Minecraft 26.1 or 26.2
- Install Fabric API and Iris (which requires Sodium)
- Drop the Viewfinder
.jarmatching your Minecraft version into yourmods/folder - For MCP installation, check the repo.
Usage
In-game commands
All commands are registered under /viewfinder:
| Command | Description |
|---|---|
/viewfinder status |
Show current shaderpack name, error count, and MCP address |
/viewfinder snapshot |
Summarize the agent diagnostics snapshot |
/viewfinder reload |
Reload shaders and report any compilation errors |
/viewfinder errors |
List all captured shader errors |
/viewfinder errors all |
List the full captured error buffer |
/viewfinder errors clear |
Clear captured shader errors |
/viewfinder screenshot [frames] |
Take a screenshot (optionally delayed by N frames) |
/viewfinder screenshot result |
Show the path of the last screenshot |
/viewfinder metrics |
Display the last captured GPU timings |
/viewfinder metrics capture [frames] |
Profile the next fixed number of frames |
/viewfinder metrics reset |
Clear collected GPU timing samples |
/viewfinder ssbo list |
List active SSBO buffers |
/viewfinder ssbo inspect <index> [bytes] |
Preview SSBO bytes as hex, int, uint, and float values |
/viewfinder ssbo dump <index> |
Dump an SSBO buffer to ssbo_dumps/ |
/viewfinder texture list |
List available colortex and custom textures |
/viewfinder texture inspect name <name> [samples] |
Probe texture metadata, samples, and channel statistics by name |
/viewfinder texture inspect id <id> [samples] |
Probe texture metadata, samples, and channel statistics by GL id |
/viewfinder texture sample name <name> <x> <y> [z] |
Read a specific texture pixel by name |
/viewfinder texture sample id <id> <x> <y> [z] |
Read a specific texture pixel by GL id |
/viewfinder texture dump name <name> [raw] |
Dump a texture by name (PNG or raw) |
/viewfinder texture dump id <id> [raw] |
Dump a texture by GL id (PNG or raw) |
/viewfinder patched_shaders |
List Iris patched shader files |
Chat output uses clickable controls where Minecraft supports them: dumped file paths can be opened or copied, list output includes dump command suggestions, and captured errors include copy buttons for full messages and stack traces.
MCP server
When the Minecraft client starts, Viewfinder automatically starts a stateless Streamable HTTP MCP server at:
http://127.0.0.1:7150/mcp
Project description from Modrinth.
Pick your setup
Viewfinder by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3
1 loader build26.2
1 loader build26.1
1 loader buildCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Viewfinder versions and loaders
v2.1.4+26.2
viewfinder-26.2-2.1.4+26.2.jar
3 Oct 2026
v2.1.3+26.2
viewfinder-26.2-2.1.3+26.2.jar
24 Aug 2026
v2.0.0+26.2
viewfinder-26.2-2.0.0+26.2.jar
11 Aug 2026
Looking for an older file? The official Modrinth project page is in Resources.