Перейти к содержимому
Mineforgian

Luminance

a library mod that helps other mods with shaders

Загрузки
7K
Подписчики
11
Обновлён
28 июля 2026 г.
Лицензия
LGPL-3.0-only

Опубликован 22 апреля 2024 г.

Исходный кодСообщить об ошибке

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.

Ченджлог

1.1.0-beta.8+fabric-1.21.11Бета1.21.11 · 28 июля 2026 г.

Known Issue

Game crashes if Improved Transparency targets are used when Improved Transparency is off. (#2)

Bug Fixes

  • Fixed null error with shader stacks name/description.
  • Added Force Transparency Targets config option.

Report bugs here.

1.1.0-beta.7+fabric-1.21.11Бета1.21.11 · 23 июля 2026 г.
  • Fixed null check error... (i am so silly SOBBING)
1.1.0-beta.6+fabric-1.21.11Бета1.21.11 · 23 июля 2026 г.
  • Updated bundled seam version.
1.1.0-beta.5+fabric-1.21.11Бета1.21.11 · 21 июля 2026 г.
  • Fixed silhouette post effects as they were missed in the previous beta release. (Fixes crashing: Perspective/1.x#2)
1.1.0-beta.4+fabric-1.21.11Бета1.21.11 · 21 июля 2026 г.
  • luminance:outlined no longer uses multiple depths. (Fixes crashing: Perspective/1.x#2)
    • This shader is used by luminance:outlined, luminance:outlined2, luminance:silhouette, and luminance:silhouette2.
  • Replaced SpectatorHandler.Mode with PriorityMode.
    • SpectatorPriorityModeValue has been renamed to PriorityModeValue.
  • Added always_on object to shader registration.
    • Optionally takes location, and priority.
      • If not provided, defaults to luminance:game, and 0.
  • Post effects can now be registered more than once as different shaders.
1.1.0-beta.3+fabric-1.21.11Бета1.21.11 · 20 мая 2026 г.
  • Updated package to dev.dannytaylor.luminance.
    • Any mods using Luminance will need to be updated to support this version onwards.
  • Renamed uses of "Fabulous" to "Improved Transparency".
  • Moved classes and methods also used by Perspective to Seam.
  • Bundled Seam 1.0-alpha.2
  • non-resourcepack backed shader registration

source code has been moved, it's now located at https://git.gay/Perspective/luminance

1.1.0-beta.2+fabric-1.21.11Бета1.21.11 · 18 апреля 2026 г.
  • Fixed mixin for panorama alpha uniform, so the game no longer crashes. (Nettakrim)
1.1.0-beta.1+fabric-1.21.11Бета1.21.11 · 17 апреля 2026 г.

Please Note: This changelog might not contain all the changes (there's been alot), and our resource pack documentation is currently out of date.

  • Updated to 1.21.11 (Nettakrim)
  • Dynamic Uniforms now use namespaced identifiers. (Nettakrim)
    • luminance_alpha_smooth is now luminance:alpha/smooth.
  • Added and updated several shaders, and dynamic uniforms. (Nettakrim, dannytaylor)
  • Fixed MC-307206. (Nettakrim)
  • Remapped to Official Mappings in preparation for 26.1. (dannytaylor)
  • Replaced RenderTypes with RenderLocations. (dannytaylor, Nettakrim)
    • Mods can now register custom RenderLocations.
  • ShaderTime now advances when paused or not in a world. (dannytaylor)
    • We now use the raw tick progress.
  • Updated Shader Dataloader. (dannytaylor)
    • Replaced disable_ui_rendertype/disable_game_rendertype/disable_screen_mode with fallback_over_ui.
    • Replaced disable_ui_background_rendertypes with fallback_under_ui.
    • Added photosensitive.
  • Added photosensitive callable to ShaderRender event. (dannytaylor)
    • When true, shaders that have photosensitive enabled won't be rendered.
  • Added Shader Stacks. (dannytaylor)
    • This is nearly identical to the "Shader Pack" system from Perspective.
      • This was moved into Luminance to allow for greater mod compatibility.
  • Slowed down minecraft:wobble by four times. (Nettakrim)
    • This makes it alot easier on the eyes, at the cost of Mojang's artistic vision.
  • Updated Attributions Screen. (dannytaylor)

Known Issues

  • Hand Depth is not merged into the minecraft:main depth buffer.
    • This isn't super noticable on shaders that are rendered on the luminance:level render location.
      • Shaders that use Improved Transparency depth buffers - such as luminance:outlined - should fallback to this render location.
  • luminance:graphics_mode uniform has been removed.
    • We will likely add seperate uniforms for each option as this has been split into "presets".
  • Shader uniforms cannot be overriden from a stack.

Комментарии

Загружаем…