Camellia

Camellia

Camellia is a pathtracer shader for Minecraft.
It's my take on Quad Raytracing in Minecraft, using the state of the art techniques from the H-PLOC paper to build a BVH directly on the GPU.
While I tried my best, performance is still suboptimal and not yet suitable for real-time gameplay. Camellia is intended for research, experimentation, and learning.

Features

• Reference pathracer with spectral-like caustics and DOF.
• QuadRT allows all geometry to be captured and traced correctly, unlike traditional voxel raytracing which compromises with hardcoded models.
• Supports all kinds of blocks, including custom models, entities and players.
• Probably very good mod support, not fully tested.

Usage

This is NOT a realtime shader. You will need to stand still and let the shader accumulate samples, like a render in Blender.
Pressing F1 starts the accumulation and freezes input and geometry, so that the scene can't change anymore.
Some tips for faster renders:

• When possible, use spectator mode: especially if you have mods that add decorations to your player.
• Disable clouds, as every sky sample also samples clouds (will be improved in a future update)

Screenshots

Screenshots taken with Patrix 128x

Requirements

• Minecraft with Iris installed.
• A GPU and driver supporting GLSL 460, compute shaders, SSBOs, custom images, and GL_KHR_shader_subgroup_*.
• NVIDIA is fully tested (on a 5080), while AMD and Intel are best-effort targets and are not tested.

Installation

1. Download the repository ZIP or from Modrinth and extract it.
2. Place the extracted Camellia folder in .minecraft/shaderpacks/. The pack folder should contain a shaders/ directory.
3. Select Camellia in Iris's Shader Packs menu.

License

Special thanks to sixthsurge for allowing me to use their clouds in my shader! Check out Photon for a surprisingly fast and stunning realtime shader.

Camellia's original work is shared under the source-available license in LICENSE; it is not an open-source license. Third-party code and research remain under their own terms. See THIRD_PARTY_NOTICES.md and licenses/.

I want people to learn from Camellia (especially what is wrong with it) so the license allows you to read and modify the source code for personal use. If you want to publish a derivative, you must contact me for permission. See the license for details.

Support development

If Camellia is useful to you, sponsor me on GitHub.Check out my other projects too!