• 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

• Fixed mixin for panorama alpha uniform, so the game no longer crashes. (Nettakrim)

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.

• Updated config screens.
  • Config and Information screens have been merged into a list screen.
  • Credits/Attribution screen is now translatable.

• Perspective uniform now defaults to 0.0F. (legotaylor)
• Added luminance:post/color_overlay shader. (legotaylor)
• Updated silhouette shaders to use the color overlay shader. (legotaylor)
• Added new uniform luminance_renderType, that returns the most appropriate rendertype for where the game currently is in its render loop (nettakrim)
• Added uniforms for arbitrary effect duration and amplitude (presence can be checked by seeing if duration is anything other than 0 [-1 is infinite]), defaults to minecraft:speed. (nettakrim)

• Perspective uniform now defaults to 0.0F. (legotaylor)
• Added luminance:post/color_overlay shader. (legotaylor)
• Updated silhouette shaders to use the color overlay shader. (legotaylor)
• Added new uniform luminance_renderType, that returns the most appropriate rendertype for where the game currently is in its render loop (nettakrim)
• Added uniforms for arbitrary effect duration and amplitude (presence can be checked by seeing if duration is anything other than 0 [-1 is infinite]), defaults to minecraft:speed. (nettakrim)

So... what's Luminance? Luminance is a library mod that helps with shader rendering. It helps mod developers setup shader rendering so they can focus on the shaders themselves! Luminance also adds Dynamic Uniforms, which allow developers to pass information to their shaders - we also include some default ones!

Are you a user that wants to see Luminance in action?
Try out Souper Secret Settings by Nettakrim, or Perspective by dannytaylor!

Luminance Documentation hasn't been written yet (it's on the top of our todo list!), however both Souper Secret Settings and Perspective are both open source so you can always see how we use it!
You can also check out our Resourcepack Guide which explains how to create a luminance shader resource pack.

Luminance Shader Resource Reloader Format

To make things simple, we've added a new resource to resource packs, which is located at assets/<namespace>/luminance/<id>.json.

{  
  "post_effect": "namespace:id", // defaults to `modid:shaderid` of the json file if not specified, this specifies the location of the post effect json.  
  "enabled": true, // defaults to true, specifies whether the shader can be used.  
  "disable_ui_rendertype": true, // defaults to false, specifies whether the shader can be rendered using the `UI` render type.  
  "registries": [ // If not provided, the shader will be registered to "luminance:main", if you do provide this, it will only be registered to the specified registries.  
    "luminance:main" // This is the default registry, most mods using Luminance should be using this.  
  ]
  "custom": {  
    "namespace": {} // defaults to new JsonObject(), can be obtained in the `ShaderRegistryEntry`.  
  }  
}  

Dynamic Uniforms

We include some default dynamic uniforms that any mod using Luminance can use in their shaders!

Custom Mod Menu Icon

Luminance adds a way to change the icon used for your mod. Want a custom icon that only shows on October 31st? You can do that: CompatHelper.addOverrideModMenuIcon(new Couple<>("modid", "halloween"), () -> "assets/modid/icons/halloween.png", () -> LocalDate.now().getMonth() == Month.October && LocalDate.now().getDayOfMonth() == 31);
You can also add a Luminance badge to your mod using:
addLuminanceModMenuBadge("modid");

Iris Shaders Compatibility

You can render both Luminance and Iris shaders at the same time! You can also check if Iris has shaders enabled by using CompatHelper.isIrisShadersEnabled()

Licenced under LGPL-3.0-or-later

Developer's note
We're working on a way for one jar for both quilt, and fabric (and eventually neoforge - that's going to take some time though!). If you have any thoughts, please share them here!

So... what's Luminance? Luminance is a library mod that helps with shader rendering. It helps mod developers setup shader rendering so they can focus on the shaders themselves! Luminance also adds Dynamic Uniforms, which allow developers to pass information to their shaders - we also include some default ones!

Are you a user that wants to see Luminance in action?
Try out Souper Secret Settings by Nettakrim, or Perspective by dannytaylor!

Luminance Documentation hasn't been written yet (it's on the top of our todo list!), however both Souper Secret Settings and Perspective are both open source so you can always see how we use it!
You can also check out our Resourcepack Guide which explains how to create a luminance shader resource pack.

Luminance Shader Resource Reloader Format

To make things simple, we've added a new resource to resource packs, which is located at assets/<namespace>/luminance/<id>.json.

{  
  "post_effect": "namespace:id", // defaults to `modid:shaderid` of the json file if not specified, this specifies the location of the post effect json.  
  "enabled": true, // defaults to true, specifies whether the shader can be used.  
  "disable_ui_rendertype": true, // defaults to false, specifies whether the shader can be rendered using the `UI` render type.  
  "registries": [ // If not provided, the shader will be registered to "luminance:main", if you do provide this, it will only be registered to the specified registries.  
    "luminance:main" // This is the default registry, most mods using Luminance should be using this.  
  ]
  "custom": {  
    "namespace": {} // defaults to new JsonObject(), can be obtained in the `ShaderRegistryEntry`.  
  }  
}  

Dynamic Uniforms

We include some default dynamic uniforms that any mod using Luminance can use in their shaders!

Custom Mod Menu Icon

Luminance adds a way to change the icon used for your mod. Want a custom icon that only shows on October 31st? You can do that: CompatHelper.addOverrideModMenuIcon(new Couple<>("modid", "halloween"), () -> "assets/modid/icons/halloween.png", () -> LocalDate.now().getMonth() == Month.October && LocalDate.now().getDayOfMonth() == 31);
You can also add a Luminance badge to your mod using:
addLuminanceModMenuBadge("modid");

Iris Shaders Compatibility

You can render both Luminance and Iris shaders at the same time! You can also check if Iris has shaders enabled by using CompatHelper.isIrisShadersEnabled()

Licenced under LGPL-3.0-or-later

Developer's note
We're working on a way for one jar for both quilt, and fabric (and eventually neoforge - that's going to take some time though!). If you have any thoughts, please share them here!