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

Satin API

A Fabric library to help modders with shader usage

1.6M загрузок271 подписчиковLGPL-3.0-onlyfabricquilt

Обновлён 19 апреля 2025 г. · опубликован 26 мая 2022 г.

Satin is a simple library allowing modders to add interesting graphical effects to their mods. Its main feature is to significantly simplify the use of Minecraft's data-driven shader system (that is, the one used by super secret settings, mob vision, and spectral arrows).

A full feature list with installation instructions is available on the github repository : https://github.com/Ladysnake/Satin/

You can find documentation for the shader format on the wiki : https://github.com/Ladysnake/Satin/wiki/Data-driven-shaders

FAQ

Can it replace Optifine ?

No. Optifine shaders are significantly more complex than what this library allows. For a work-in-progress alternative, see the Canvas Renderer project.

Can it bring back Super Secret Settings ?

Satin is just a library, so it does not add any content by itself. You may however be interested in Secrets No More, a mod using Satin to do exactly that !

Does this library have a Forge version ?

No, and I do not want to port it myself. I will however support anyone who does so. Also note that the documentation for the shader format stays applicable regardless of the mod loader being used.

Версии

ВерсияКаналИграЗагрузчикиДатаСкачать
3.0.0-alpha.1Альфа1.21.2, 1.21.3, 1.21.4fabric, quilt19 апреля 2025 г..jar (97 КБ)
2.0.0Релиз1.21, 1.21.1fabric, quilt13 июня 2024 г..jar (100 КБ)
1.9.2Релиз1.19.2fabric, quilt13 июня 2024 г..jar (89 КБ)
1.18.0Релиз1.20.5, 1.20.6fabric, quilt5 июня 2024 г..jar (100 КБ)
1.17.0Релиз1.20.5, 1.20.6fabric, quilt30 апреля 2024 г..jar (97 КБ)
1.16.0Релиз1.20.4fabric, quilt31 декабря 2023 г..jar (96 КБ)
1.9.1Альфа1.19.2fabric, quilt31 декабря 2023 г..jar (89 КБ)
1.15.0Релиз1.20.3, 1.20.4fabric, quilt5 декабря 2023 г..jar (97 КБ)
1.14.0Релиз1.20, 1.20.1, 1.20.2fabric, quilt5 августа 2023 г..jar (97 КБ)
1.13.0Релиз1.20, 1.20.1, 1.20.2fabric, quilt10 июня 2023 г..jar (92 КБ)
1.12.1Релиз1.19.4fabric, quilt6 июня 2023 г..jar (92 КБ)
1.12.0Релиз1.19.4fabric, quilt29 мая 2023 г..jar (92 КБ)
1.11.0Релиз1.19.4fabric, quilt19 марта 2023 г..jar (93 КБ)
1.10.0Релиз1.19.3fabric, quilt10 декабря 2022 г..jar (94 КБ)
1.9.0Релиз1.19, 1.19.1, 1.19.2fabric, quilt8 июля 2022 г..jar (99 КБ)

Показаны последние 15 из 17 версий. Все версии — на Modrinth.

Ченджлог

3.0.0-alpha.1Альфа1.21.2, 1.21.3, 1.21.4 · 19 апреля 2025 г.

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

2.0.0Релиз1.21, 1.21.1 · 13 июня 2024 г.

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

1.9.2Релиз1.19.2 · 13 июня 2024 г.

Version 1.9.2:

Ported to Quilt to hopefully fix the incompatibility issue

see full changelog here

1.18.0Релиз1.20.5, 1.20.6 · 5 июня 2024 г.

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

1.17.0Релиз1.20.5, 1.20.6 · 30 апреля 2024 г.

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

1.16.0Релиз1.20.4 · 31 декабря 2023 г.

Version 1.16.0:

Updated to MC 1.20.4 proper (thanks DietrichPaul!)

Additions

  • Added a new UniformMat4#setFromArray method for those cases where going through a matrix is too impractical

see full changelog here

1.9.1Альфа1.19.2 · 31 декабря 2023 г.

Version 1.9.1:

Fixes

  • Fixed incompatibility with newer Fabric API for 1.19.2 (thanks unilock for the backport !)
    • may break some mods, only install this if your modpack crashes with 1.9.0

see full changelog here

1.15.0Релиз1.20.3, 1.20.4 · 5 декабря 2023 г.

Version 1.15.0:

Updated to MC 1.20.3 (thanks DietrichPaul!)

Changes

  • Slightly optimized shader uniform loading

see full changelog here

Полная история изменений — на Modrinth.

Комментарии

Загружаем…