Back to mods
Luminance project artwork

Modrinth · Minecraft mod

Luminance

a library mod that helps other mods with shaders

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

Quick answer

Which Luminance release should I use?

Updated 6 days ago
Latest stable file 1.0.1-release.1+1.21.4-quilt
Game version 1.21.4
Loader Quilt

Luminance 1.0.1-release.1+1.21.4-quilt targets 1.21.4 with Quilt. Installation on the client is optional. Installation on the dedicated server is optional. 1 required mod needs a matching file.

Where it goes

Is Luminance required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

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

The source marks this as usable on both the client and server.

What else does Luminance 1.0.1-release.1+1.21.4-quilt need?

1.0.1-release.1+1.21.4-quilt. Change the file and its required mods may change too.

1 required mod needs a matching file

Install Fabric API first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match.

Fabric API Needed by Luminance 1.0.1-release.1+1.21.4-quilt
required
No matching file

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Luminance without breaking your instance.

Built for Luminance 1.0.1-release.1+1.21.4-quilt. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.0.1-release.1+1.21.4-quilt. It targets 1.21.4 with Quilt; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Fabric API first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.0.1-release.1+1.21.4-quilt. It opens that exact file at the source.

About this project

What does Luminance add?

Luminance

About

Luminance is a library mod that is primarily designed to help other mods with shaders.

As a user, you should only need to install this if a mod requires it.

Features

  • Adds Dynamic Shader Uniforms
    • These let post-processing shaders have more information about what's happening in-game.
    • Luminance comes with a bunch of these by default, but you can add your own too!
  • Adds shaders that have been used in previous minecraft versions.
    • Requires Perspective or Souper Secret Settings.
    • Luminance takes care of rendering shaders, so you don't have to!
    • You can check if Iris Shaders are enabled using Luminance.
      • This means you don't have to have Iris added to your development environment!
    • You can replace your ModMenu icon using Luminance!
      • Make your mod icon change depending on the time of year, or via a config option, anything's possible!

Dependencies

  • Fabric API or Quilted Fabric API (QFAPI)
    • fabric-resource-loader-v0
    • fabric-key-binding-api-v1
    • fabric-lifecycle-events-v1
  • Java 21 or later.
    • Built with the Microsoft build of OpenJDK 21.0.2.

How to add Luminance to your mod:

  1. Add the following lines to the repository section of your build.gradle:
exclusiveContent {
		forRepository {
			maven {
				name = "Modrinth"
				url = "https://api.modrinth.com/maven"
			}
		}
		filter {
			includeGroup "maven.modrinth"
		}
	}
  1. Add the following line to the dependencies section of your build.gradle:
include(modImplementation "maven.modrinth:luminance:${project.luminance}")
  1. Add the following line to your gradle.properties:
    1. Replace 1.0.0-rc.1+1.21.4-fabric with the latest version of Luminance!
      1. This can be found on the version page on Modrinth.
luminance = 1.0.0-release.1+1.21.4-fabric
#luminance = 1.0.0-release.1+1.21.4-quilt
  1. Reload gradle and you're ready to use Luminance!

Also check out

Our GitHub Page
Perspective by dannytaylor
Souper Secret Settings by Nettakrim
Luminance Mod Collection

Licensed under LGPL-3.0-or-later.

This mod is not affiliated with/endorsed by Mojang Studios or Microsoft.
Some game assets are property of Mojang Studios and fall under Minecraft EULA.

Project description from Modrinth.

Pick your setup

Luminance by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

15 available setups

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

Recent files

Luminance versions and loaders

24 of 24 releases match

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