Tags
Creators
Details
2.1.0
Compatibility
Changes
2.1.0 — 2026-09-25
Added
-
film_graincan be coloured (chroma). A newchromaparam (0, monochrome, default;1, fully coloured) mixes an independent per-channel grain into the shared monochrome grain and stops halfway, so at1the grain keeps its luminance structure instead of dissolving into plain colour noise. Animated like any other param (keyframes,expr,setParam,fade_ticks). Additive: absent = exactly the previous monochrome look, no datapack field renamed, no wire change. See film_grain. -
fog_modifier— change the vanilla fog. A new value-modifier effect (likefov_modifier, not a post pass):fog_start_scale/fog_end_scalemultiply the vanilla fog start/end distance (neutral1.0;>1sees further,<1pulls the fog closer) and optionalfog_r/fog_g/fog_b(neutral "unset") override the fog colour.fog_color_amount(0..1, neutral1/unset) scales how far the colour moves from vanilla — animating it ramps smoothly from the dimension's own fog colour to the authored one, and0is a true no-op that never writes the colour. The mod rewrites the fog at the return of vanillaFogRenderer.setupFog, mutating the instance the game produced in place before anything consumes it: the same values then reach the fog uniforms (FogEnvironmental/FogRenderDistancestart+end,FogSkyEnd/FogCloudsEndandFogColor), the level renderer and the sky/cloud shaders, so vanilla terrain, entities, the horizon band and the entity-effect geometry all see the change; absent params leave the fog bit-for-bit untouched. Scales combine additively around neutral (1 + Σ((s−1)·weight)) and the colour is a weighted average blended from vanilla (order-independent, clamped; each effect's colour weight is itsweight·fog_color_amount), so overlapping effects stack predictably. All six params are ordinary animatable params, sokeyframes,expr, graphs,setParamandfade_tickswork. The start/end scales apply to every distance-based fog on all three nodes — overworld, nether (fog_start/fog_enddistances) and End, plus water/lava/snow/blindness/darkness, andfog_end_scalealso scales the sky/cloud fade ends; these versions have no density-fog field or attribute, so nothing is left out. Honest limits: under an Iris shaderpack this effect is a no-op (a pack computes its own fog and ignores the vanilla values); and theblock_tint/block_outline/glow/spark overlays use a fog-free shader, so only the entity-effect geometry inherits the change. No shader change, no UBO change, no new dependency;PROTOCOL_VERSIONunchanged. The mixin hooks the return of vanillaFogRenderer.setupFogatpriority 900(before Sodium's fog mixin) and mutates the returned instance in place, so the fog uniforms, the level renderer and the sky/cloud shaders all see it. Not verified in game: the visual result; the static contract — the per-nodeFogRenderer.setupFoghook point (return ofsetupFog, mutated in place), the colour-amount combination maths and the type/neutral/isPostProcessing wiring — is asserted byscripts/check-fog-modifier.ps1. -
sky_pattern— follow the sun, the moon or the stars (anchor). The overnight sky body is a new optional top-levelanchorstring: omitted (or"dome") is the world-fixedanchor_yaw/anchor_pitchauthoring;"sun"and"moon"make the pattern track the vanilla body;"stars"locks the pattern to the rotating star sphere (the shader inverts vanilla's star pose exactly — see Fixed below). The body angles are read from the client's own sky render state on the CPU and fed to the existinganchor_yaw/anchor_pitchuniforms (plus two internal star fields), so there is no mixin — which is what keeps it working under an Iris shaderpack (the world time, hence the angles, is still computed by the game). When the sky state is unavailable (no overworld sky, or the render state is not ready) the effect contributes nothing instead of painting at a guessed spot, and warns once. Additive: a new top-level field only, no existing effect changed, no datapack field renamed,PROTOCOL_VERSIONunchanged, and no UBO/Config change. Honest limits: the effect is an overlay, so the vanilla sun/moon are still drawn underneath (size the pattern to cover them: sun ≈33° apparent width, moon ≈24°), and because the vanilla star colour is not reached without aSkyRenderermixin,"stars"positions a pattern at the star sphere rather than recolouring the vanilla stars. The rendering is not verified in game by the author. -
sky_pattern— a datapack figure or texture drawn on the sky dome. A new screen post effect and the sky sibling ofsurface_pattern: the same structuralpatternblock, shared shape library andpattern.textureaddressing, but the pixel's view ray is projected onto the dome instead of a depth-reconstructed world surface (the projection is chosen bysky_mode— see thesky_modeentry below). The dome anchor is authored asanchor_yaw/anchor_pitch(degrees) and the image can be spun about world Y withdome_rotation;repeat: [3, 3]draws nine dots with no texture, and apattern.texturewith asheetplus the animatableframeparam draws an animated sky. The pass is gated on the depth sky test, so it never touches terrain, the hand or the GUI. Additive: a new effect type only, no existing effect changed, no datapack field renamed,PROTOCOL_VERSIONunchanged, and no existing shader's UBO layout touched. The rendering is not verified in game by the author; like every post effect it composes over an Iris shaderpack's sky. -
light_beamcan end on a chosen point. Three optional params,end_at_x/end_at_y/end_at_z, name a world point the far end of the beam lands on: the anchor is derived from it (end − axis × height), so the geometry finishes exactly there — with the default axis the beam hangs straight down fromheightabove the point, which is how a beam comes out of the sky. They are ordinary animatable params, so the landing point can be keyframed, driven by an expression or bound, and a beam from A to B isend_at = Bwith the axis and length computed between the two points. Unset, the beam behaves exactly as before. No shader, pipeline, UBO or wire change. -
light_beamcan point in any direction. Three new params,dir_x/dir_y/dir_z(defaults0/1/0), replace the fixed vertical axis, so a beam can be aimed at an angle — e.g. from a point on the sky. They are ordinary animatable params, so they can be keyframed, driven by an expression or bound, including to the camera look ({"bind": "look_x"}etc.). With the defaults the beam renders exactly as before. No shader, pipeline, UBO or wire change. -
Sky masks. Two new mask leaves address the sky instead of the world:
sky(the whole visible sky, no parameters) and a 2D shape (circle/ellipse/rect/polygon) in the newspace: "dome", which places it on an equirectangular map of the sky with the centre authored as[yaw, pitch]degrees. A dome leaf is sky-occluded by construction — a hill or a wall occupying a dome direction is never tinted — and both fail closed (zero coverage) when no trustworthy depth is available. This is what lets any existing screen effect be restricted to the sky, e.g. a green or glitching sky. Additive: no datapack field was renamed, the wire format andPROTOCOL_VERSIONare unchanged and the coverage UBO layout did not change. The far-depth test is verified in game on all three lines (26.2, 26.1.2, 1.21.11). The sun, the moon and the clouds are drawn without depth, so asky/domeleaf covers them too (a green sky turns the sun green); the horizon fog is baked into the terrain, so it is not recoloured and a strong tint can leave a seam there. -
volume: "aura"on a world GLSL-plugin mask leaf. A custom mask leaf registered withVFXAPI.registerMaskShapeGlslcan now be a real volume instead of a surface-only shape: the pixel's view ray is sphere-traced through the plugin's own distance field and the effect fills the volume — air and sky included — wherever the scene does not occlude it, with the same silhouette, edge fade and occlusion maths as a built-insphere/boxaura. A composed custom leaf (no raw SDF to march) and a screen-space plugin leaf are per-file parse errors naming the reason rather than silent fallbacks. An optionalvec4 vfx_shape_custom_bounds()in the plugin source (world centre and radius) acts as an analytic broad phase: a ray that misses it is rejected without evaluating the SDF, which makes the average cost proportional to the volume's screen area instead of the whole frame. A plugin that declares neither function compiles and behaves exactly as before; the wire format,PROTOCOL_VERSIONand the coverage UBO layout are unchanged.
Changed
-
sky_patternaddresses the sky withpatchorfill— the legacy equirectangulardomemode was removed before release. A single global chart of a sphere is topologically unable to tile it cleanly:uis undefined at the poles (a whole-sky pattern winds into a funnel at the zenith) andumust wrap at ±180° yaw (a mandatory visible seam / mirror axis) — properties of the chart, not formula bugs, so no formula fixes them. The effect therefore offers only local-chart modes:patch(default,0) is one gnomonic decal at the anchor (no pole, no seam, clean discard past the decal horizon) andfill(1) covers the whole sphere with three orthographic charts blended by a sharpened partition of unity (no pole convergence, no seam anywhere; the charts' coverage and colour are blended, never their UVs)."dome"and any other unknown value are now a per-file parse error naming the accepted values.sky_modeis appended last to the Config UBO, so no existing shader's layout changes; no datapack field was renamed andPROTOCOL_VERSIONis unchanged. The effect is not in any release yet, so removingdomebreaks nothing. A full skybox cube remains a separate future feature. -
A custom mask leaf in
surfacemode no longer tints the sky. The surface path classifies only what the depth buffer contains, so a sky pixel contributes no coverage. Built-in shapes already behaved this way (their bounded distance field puts a far-plane point outside the shape); the gate is now explicit for custom leaves, whose SDF may be intentionally unbounded. A plugin that relied on painting the sky from asurfaceleaf will no longer do so. -
A built-in world GLSL mask plugin,
vfxweaver:blobs_glsl. The only shipped GLSL plugin wasvfxweaver:ringed_glsl, a screen-space 2D figure, sospace: "world"plugin leaves had no volume to march and the dynamic-data demo could not show the data driving anything.vfxweaver:blobs_glslis a genuine world-space SDF — a union of up to eight spheres, negative inside — whose sphere centres/radii come from the leaf's dynamic data (mask.p<N>.d0..d31, four floats per sphere) and whosep0..p7are global controls (offset, radius scale/bias, count). It also declares the optionalvfx_shape_custom_bounds()broad phase over the same data+params extent, sovolume: "aura"with it is cheap. It works for bothsurfaceandaura; the three mask demos use it. The plugin leaf shape is inert on the1.21.11node (no shader-source hook). Additive:vfxweaver:ringed_glslstays the screen reference, no existing pass's UBO/wire layout changes,PROTOCOL_VERSIONunchanged. See masks.
Fixed
-
film_grainnoise no longer repeats in a fixed pattern. The cells were hashed with afract(sin(dot(...)))hash, which is only well distributed for large inputs: on the small integers a pixel cell produces it repeats in a visible lattice, so the frame read as one small tile stamped over and over. Cells are now hashed with an integer bit-mix, and the per-frame offset is an integer tick mix rather than afract()-scaled float. -
film_grainandpixelatecell grids grow from the centre, not the corner. Both derived their grid straight from the UV, so an animated cell size expanded the pattern out of the bottom-left corner; the grid is now measured from the screen centre. Effects whose pattern is per-scanline (scanlines,vhs,digital_glitch) are deliberately unchanged — those bands run from the top edge and have no centre to grow from. -
sky_patternanchor: "stars"really tracks the star field. The anchor previously drovedome_rotation, a world-Y spin, while vanilla rotates the star sphere about a different axis (its pose isRy(-90°) · Rx(starAngle)), so astarspattern was only an approximation and turned about the wrong axis. The sky shader now takes the sampled direction into the star sphere's own frame with the exact inverse, so the pattern is locked to the star material.dome_rotationis not hijacked — it stays the author's world-Y spin, applied first. Two internal Config fields are appended aftersky_mode; no datapack field was renamed andPROTOCOL_VERSIONis unchanged. See sky_pattern. -
sky_patternpatchdecals have no built-in clip, and the ring demo no longer circles the player. Apatchis a flat sign on the tangent plane: it is evaluated out to the tangent-plane horizon, where a pixel behind the decal (dot(dir, anchor) <= 0) is discarded - no wrapping, no pole convergence and no built-in clip. A large patch can therefore show that horizon as a straight cut; restrict the effect with a mask if you need a clean edge. (An earlier unit-disc bound was removed: it visibly cut the figure.) The demos use each projection for what it is for:show_sky_pattern_texture(a whole-sky texture) andsky_cracksarefill, whileshow_sky_pattern(the ring) andnine_red_pixelsare smallpatchdecals. The ring demo no longer animatesdome_rotation- inpatchmode that moves the decal along its latitude, around the sky, so it now animates onlytile_scaleandopacityand stays at its spot. The effect is not in any release yet; no datapack field was renamed andPROTOCOL_VERSIONis unchanged.
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:HBhB8m4j:fQVpkt1m"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:HBhB8m4j:fQVpkt1m"
}

