IRIS/OCULUS ADD-ON. THIS IS NOT A SHADER LOADER.

A mod that lets you hide, filter, recolor, add tooltips, and reorder specific shader packs in the Iris/Oculus shaders menu using flexible patterns.

This mod does NOT load shaders! It only organizes and customizes the shader selection menu.

📝 Why use this mod?

Tired of scrolling through a messy shader list? Want to hide test packs, old versions, recolor names, add tooltips, or put your favorites at the top?
Iris Shader Folder Mod lets you filter out unwanted shader packs, organize the menu, recolor names, and add custom tooltips making your shader selection fast, clean, and personal.

Features

• Hide shader packs by name, version, or regex pattern
• Reorder shader packs in the menu using patterns and positions
• Recolor shader pack names or parts of names with Minecraft color codes
• Add custom tooltips to shader packs in the menu
• Supports both modern and legacy Iris versions and also Oculus
• Real-time config reloading (no restart required)
• Debug logging to file for troubleshooting

For Shaderpack Developers

Add your own tooltips easily!
Create a pack.json under /shaders/ (inspired by Aperture) and in json format include:

"shaderDescription": "Your Description"

Configuration

Edit the config file at:
config/iris_shader_folder.properties

Example filter section:

filterStart:[
test
{.*}Outdated{.*}
ComplementaryShaders_r{version}
]:filterEnd

• Each line is a filter pattern.
• Use {version} as a shortcut for version numbers (e.g., 1.2.3).
• Use {...} to insert raw regex (e.g., Outdated{.*(shader|Reimagined)}).
• Patterns match both folders and .zip shader packs.

Example reorder section:

reorderStart:[
{.*}EuphoriaPatches{.*}
Complementary{.*}_r{version}
BSL{.*}
]:reorderEnd

• The order of lines determines the order in the menu (top line = first position, etc.).
• If multiple shaderpacks match a pattern, they are inserted at the given position, sorted alphabetically.
• Patterns support {version} and custom regex in braces.
• Patterns match both folders and .zip shader packs.

Example recolor section:

recolorStart:[
Complementary{.*} [|] Comp [->] red [|] {version} [->] §6
{.*}EuphoriaPatches{.*} [|] EuphoriaPatches_{version} [->] light_purple
test [|] {all} [->] red
]:recolorEnd

• Recolor the whole name or just parts using Minecraft color names or codes.
• {all} recolors the entire name.
• Multiple recolor rules can be combined per line.

Example tooltip section:

tooltipStart:[
Complementary{.*} [|] Complementary is a shaderpack focused on performance and visual quality.
test [|] This is a test shaderpack.
]:tooltipEnd

• Add custom tooltip text for any shader pack.
• Tooltips appear when hovering over the shader in the menu.

Enable Debug Logging

Set debugLogging=true in the config file to write detailed debug info to config/iris_shader_filter_debug.txt