Back to mods
Viewfinder project artwork

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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Viewfinder release should I use?

Updated last month
Latest stable file v2.1.4+26.3
Game version 26.3
Loader Fabric

Viewfinder v2.1.4+26.3 targets 26.3 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.

Client Required
Dedicated server Not supported
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

This file is marked client-only.

What else does Viewfinder v2.1.4+26.3 need?

v2.1.4+26.3. Change the file and its required mods may change too.

All 3 required mods have matching files

Install Iris Shaders, Fabric API, Sodium first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.

2 listed on this file 1 pulled in by one of those mods
Iris Shaders Needed by Viewfinder v2.1.4+26.3
required
Matching file found Matched file: 1.11.7+26.3-fabric
Fabric API Needed by Viewfinder v2.1.4+26.3
required
Matching file found Matched file: 0.166.2+26.3
Sodium Needed by Iris Shaders
pulled in
Matching file found Matched file: mc26.3-0.9.2-fabric

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.3. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use v2.1.4+26.3. It targets 26.3 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Iris Shaders, Fabric API, Sodium first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.

  3. 03

    Put it on the correct side

    It must be installed on the client. Do not install it on the dedicated server.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside v2.1.4+26.3. 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

  1. Install Fabric Loader for Minecraft 26.1 or 26.2
  2. Install Fabric API and Iris (which requires Sodium)
  3. Drop the Viewfinder .jar matching your Minecraft version into your mods/ folder
  4. 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.

3 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Viewfinder versions and loaders

8 of 8 releases match

Looking for an older file? The official Modrinth project page is in Resources.