Skip to content

Latest commit

 

History

History
76 lines (41 loc) · 4.31 KB

README.md

File metadata and controls

76 lines (41 loc) · 4.31 KB

Brunnera Shaders

Brunnera is a semi-realistic pipeline shader for the Canvas mod, forked from Ambrosia's Forget-me-not. It's designed to give the most authentic and immersive experience with a plethora of post-processing camera effects.

Canvas is a client-side renderer mod that uses shaders for advanced rendering with the goal of having a modern and very flexible design for high performance and better readability. The shader system is entirely different from Optifine and Iris & Sodium and as such, Brunnera won't work with any of these mods! See the how to use section for installation instructions.

Why is it called Brunnera?

It's the only plant name closely related to the forget-me-not (genus Myosotis) that isn't a rubbish name for a shader pack. The flowers look pretty similar too.

Notice

If you're a developer or mod hoster, Brunnera is licensed under the LGPL v3.0 (following Forget-me-not), so please make sure to read over the terms of the LGPL if you use any of Brunnera or Forget-me-not's original code or distribute it.

How to use third-party shaders with canvas

  1. Be sure you're on 1.19.4 or above. Support is not guaranteed for versions that Canvas doesn't actively support.

  2. Install Fabric.

  3. Get Canvas Renderer mod through Modrinth. Keep in mind that Canvas does not work with Sodium, Iris, OptiFine, or OptiFabric.

  4. Download your preferred pipeline shaderpack. If you're looking for alternatives to Brunnera, try out Forget-me-not, Lumi Lights, Lomo (not for gameplay as of this writing), or Aerie (vanilla-plus, wip).

  5. Launch your game, put your downloaded .zip file into your resourcepacks folder and activate the resource pack. (Don't extract it!)

  6. Navigate to Options / Video Settings / Canvas / Pipeline Options / Pipelines and select the pipeline that you want to play with.

Troubleshooting

  • Experiencing bad shadow outcomes? In Options / Video Settings / Canvas / Debug, set Shadow Priming Strategy to TIERED and Disable Shadow Self-Occlusion to true.

  • Does Canvas say in chat that some shaders are broken? Please grab your log in .minecraft/logs/latest.log and all contents of the .minecraft/canvas_shader_debug/ folder and either make an issue on GitHub or let me know about it on Discord.

  • Does every Canvas pipeline break other than Canvas Basic? If so, your device is probably incompatible with Fabulous graphics, which most Canvas pipelines use. Unfortunately, there's no fix for this.

Feature highlights

  • Chromatic aberration

  • Depth-of-field

  • Interlacing effect

  • Somewhat realistic noise

  • Realistic tonemaps from real cameras

  • Most of Forget-me-not's features, including:

    • seasons! be immersed in your world as the seasons change over time

    • HDR, bloom, and tone mapping

    • dramatic skies with atmospheric scattering and custom realistic clouds

    • water waves and reflections

    • support for PBR, with hundreds of built-in default materials

    • contact-hardening variable penumbra shadows

    • advanced anti-aliasing (TAA)

Credits

Brunnera wouldn't exist if it weren't for Ambrosia, as well as the help of people like fewizz, spiralhalo, Grondag, and many others from the Canvas community for contributing and testing. Many thanks to:

  • Forget-me-not for the base and heavy lifting of this shader
  • The shaderLABS discord channel #snippets for many useful code snippets
  • Lumi Lights by spiralhalo for lots of different inspiration & help, and also references for a working TAA implementation
  • lomo by fewizz for inspiration for many different things, as well as the raytracer and lots of invaluable contributions

Discord

my server: https://discord.gg/8HwzjVh2xj
Forget-me-not/Ambrosia's server: https://discord.gg/Zzn4jJapRH