Satin API

Version 3.0.0-alpha.1:

Partially updated to MC 1.21.2

This update contains major breaking changes made by Mojang to shader declarations preparing the terrain for Vibrant Visuals. More breaking changes should be expected for later versions.

For this first alpha, only ShaderEffectManager#manage, ManagedShaderEffect and basic uniform manipulation methods are expected to work.

Feedback is welcome on the Satin GitHub page.

Changes

• Post process shaders are now loaded from post_effect and shaders instead of respectively shaders/post and shaders/program. By convention, files previously in shaders/program should go to the shaders/post subdirectory.
• Identifiers for ManagedShaderEffect have changed: mymod:shaders/post/example.json becomes mymod:example (the example.json file also needs to be moved to the post_effect directory)
• Includes (loaded from shaders/include) are now available in post process shaders
• Post-process effect format has changed:
  • inputs take a sampler_name, which will be suffixed with "Sampler" (e.g. "sampler_name": "In" becomes "name": "InSampler" in the shader definition)

see full changelog here

Version 2.0.0:

Updated to MC 1.21

Changes

• The root package has been changed from ladysnake.satin to org.ladysnake.satin
  • global search-replace of ladysnake.satin -> org.ladysnake.satin should do the trick for the migration in your projects

Removals

• Removed the nanoTime parameter in PostWorldRenderCallback and PostWorldRenderCallbackV2 (deprecated since 1.17.0)
• Removed the ShaderEffectManager#manageProgram methods (deprecated since 1.6.0)
• Removed deprecated GlMatrices methods (deprecated since 1.1.0)

see full changelog here

Version 1.9.2:

Ported to Quilt to hopefully fix the incompatibility issue

see full changelog here

Version 1.18.0:

Additions

• Added WorldRendererReloadCallback, an event that gets triggered when e.g. video settings are updated or the player joins a world

Changes

• Shaders' init callbacks now also run during the above event
  • This fixes resource leaks caused by setting a sampler uniform to a vanilla Framebuffer in those callbacks
• Added a warning in the logs for bad framerate when installed together with the Vivecraft mod

see full changelog here

Version 1.17.0:

Updated to MC 1.20.5

Additions

• Added PostWorldRenderCallbackV3, with the projection and model-view matrices passed in

Changes

• The nanoTime parameter in PostWorldRenderCallback and PostWorldRenderCallbackV2 has been deprecated, and is subject to removal in a future version

see full changelog here