OptiFine
Information regarding OptiFine (and equivalent) & Shader Pack installation for Valhelsia packs.
OptiFine is a mod for Minecraft clients intended to add a number of new graphics options to the game as well as add support for shader packs. In some cases it can also increase performance considerably, although this will vary depending on your hardware. We generally find that adding OptiFine results in higher memory usage but lower CPU and GPU usage.
Other equivalent mods to OptiFine are now available as for example Iris Shaders available only on Fabric. But there is now a fork of Iris Shaders which is called Oculus and available on Forge (require Rubidium).
The version of OptiFine or Oculus supported for the latest version of the pack is listed in the table below. If you are instead using an older version of one of our packs, you can find the compatible version listed in the #changelog channel of our Discord server.
Valhelsia: Enhanced Vanilla, Valhelsia 5 and Valhelsia 6 is provided with shaders, performance mods, and resource packs. OptiFine is not compatible with these mods, so can't be included in the pack (and serves no purpose due to the replacement mods).
| Pack | Pack Version | OptiFine | Oculus |
|---|---|---|---|
Valhelsia: Volatile (1.19) | 2.0.3 | Not compatible. | Unknown. |
Valhelsia 3 (1.16) | 3.5.1 | Unknown. | |
Valhelsia: Origins (1.15) | 1.1.5 | Unknown. | |
Valhelsia 2 (1.15) | 2.3.4 | Unknown. | |
Valhelsia 1 (1.14) | 1.2.2 | Unknown. |
¹ Note that some people have had more success with OptiFine 1.16.5 HD U G7 instead of G8. Please try downgrading to G7 if you experience any issues.
Installing OptiFine
You can add it to the pack by downloading the correct version of OptiFine and placing the .jar file in the mods folder alongside other mods. OptiForge is installed using the same method.
OptiFine should never be added to a server (and will indeed crash the server). It is a client-side mod only.
Depending on the launcher you are using, there will be a different method to find the mods folder.
CurseForge Client & GDLauncher
Right-click on the pack instance, then select Open Folder.
Double-click on the mods folder, and drop in the downloaded OptiFine .jar. You do not need run it - it functions as a mod.
OptiForge
OptiForge is a mod that aims to fix some incompatibilities between OptiFine and Minecraft Forge in Minecraft 1.17 and earlier. It is generally not required in the most recent versions of our packs, but may be required for some older versions (or may resolve certain glitches or crashes).
If you're encountering issues with OptiFine, consider adding the OptiForge mod (in the same way as described above). Please see the OptiForge changelog to ensure you have the correct version for the OptiFine and Forge versions of the pack.
Installing Oculus
You can add it to the pack by downloading the correct version of Oculus and placing the .jar file in the mods folder alongside other mods. Oculus needs the Rubidium mod to work, installed using the same method.
Oculus should never be added to a server (and will indeed crash the server). It is a client-side mod only.
Depending on the launcher you are using, there will be a different method to find the mods folder.
CurseForge Client & GDLauncher
Right-click on the pack instance, then select Open Folder.
Double-click on the mods folder, and drop in the downloaded Oculus .jar. You do not need run it - it functions as a mod.
Installing Shader Packs
Note: Shader packs should be switched before loading a Minecraft world or connecting to a multiplayer server, from the title screen.
From the Valhelsia Title Screen, click on Options, then Video Settings, then Shaders, then click the Shaders Folder button at the bottom.
Download the shader pack you wish to use. We have included links to several shader packs below, but this is by no means an exhaustive list.
Place the downloaded shader pack in the newly opened window showing the shaderpacks folder.
Select the shader pack from the list in the in-game menu.
Enabling a shader pack in Valhelsia 3 may crash the game due to an incompatibility between OptiFine and Immersive Engineering. This will typically only happen once, and reloading the game should load the shader normally. This is a bug in OptiFine that we are unable to fix.
Sildur's Shaders
Sildur's shaders come in a variety of levels - Lite, Medium, High, High w/ Motion Blur, Extreme, and Extreme w/ Volumetric Lighting. The range of packs available ensure that there's something for everybody. We use the Extreme w/ Volumetric Lighting pack to create the screenshots that you see on the Valhelsia 3 CurseForge page, as these shaders are particularly suited for breathtaking screenshots of your creations.
To remove the horizontal line in the skybox you have to disable Astral Sorcery's custom skybox, by removing "minecraft:overworld" from skyRenderingEnabled at astralsorcery-client.toml in the config directory. There is more information about this pinned in the #support channel of our Discord server.
BSL Shaders
BSL Shaders are great for survival Minecraft, with a focus on optimisation and customisation. They achieve a balance between looking good, performing well, and having subtle effects that don't detract from playing the game.
Complementary Shaders
Complementary Shaders were originally based on BSL Shaders, but the developer has shifted focus towards compatibility with as many different hardware and mod configurations as possible, and has deviated considerably from the starting point of BSL shaders, resulting in quite a different end result.
Warnings / Disclaimer
Most mod developers will not guarantee OptiFine or Oculus support since OptiFine changes a lot of expected Minecraft functionality and is additionally not an open source mod, causing it to be more difficult to achieve compatibility with. Many developers will avoid fixing problems that only occur with OptiFine installed and will close issue reports that include OptiFine. Because of this, you may experience missing textures or models, crashes, visual glitches, or negative performance while using OptiFine. While we have included the installation steps here and we will attempt to help you, we promise no support beyond this wiki page because of this. If you are seeking support on our Discord server for help with a crash or bug, please remove OptiFine (and OptiForge, if added) before asking for help and submitting a crash report.
Last updated
