This mod's code was written entirely by AI, with the exception of the parts adapted from MCPatcher's "Better Skies" mod (MIT-licensed), credited below.
A Fabric mod for Minecraft that reimplements MCPatcher's "Better Skies" custom skybox feature (the resource pack format also known as OptiFine's "Custom Sky"). Resource packs can define one or more skybox layers per dimension, each with its own texture, fade-in/out schedule, blend mode, and rotation.
Vanilla fog fades distant chunks to the dimension's own flat color, which looks out of place once a resource pack has replaced the sky above it. The Fog Blending setting (mod settings screen, via Mod Menu) instead fades distant fog toward the active custom sky, with three modes trading accuracy for performance:
| Screenshot | Mode | Description |
|---|---|---|
 |
Per-Pixel (default) | Terrain fog samples the actual custom sky per-pixel, so it matches what's really behind it in every direction. Most accurate; adds a small cost only where fog is actually visible on screen. |
 |
Directional | Fog fades toward a single color per frame, sampled from the custom sky in the direction the camera is facing. Cheaper than Per-Pixel, but the whole screen shares one flat fog color, which can look off with more detailed skies. |
 |
Vanilla | Fog ignores the custom sky entirely and behaves exactly like unmodded Minecraft. No performance cost. |
Built with Stonecutter for four Minecraft versions from
one source tree - EnvironmentAttributes (used by AtmosphericFogEnvironmentMixin) was
introduced in 1.21.11, which is this mod's binding floor.
| Minecraft | Java | Fabric Loader | Fabric API | Mod Menu |
|---|---|---|---|---|
| 1.21.11 | 21 | 0.19.3+ | 0.141.6+1.21.11 | 17.0.0 |
| 26.1 | 25 | 0.19.3+ | 0.145.1+26.1 | 18.0.0 |
| 26.2 | 25 | 0.19.3+ | 0.156.0+26.2 | 20.0.1 |
| 26.3 | 25 | 0.19.3+ | 0.161.0+26.3 | 21.0.0 |
Only 26.2 and 26.3 currently build (both are exercised by CI). 1.21.11 and 26.1 have the Stonecutter scaffolding in place but don't compile yet - Mojang changed significant parts of the rendering API this mod uses across these versions, which needs real per-version porting, not just the ordinal-based mixin guards this scaffolding was originally built for.
26.3 replaced Blaze3D's rendering API with "RenderPearl" (com.mojang.renderpearl.*),
split each chunk section layer's pipeline into a normal and a multi-draw-indirect variant,
rewrote the sky/terrain shaders, and moved translucent terrain behind an
order-independent-transparency pipeline set. The mod handles all four: the pipeline
wrappers moved packages, ChunkSectionLayerMixin maps both layer variants,
custom_sky_terrain is a 26.3-style shader, and ChunkSectionsToRenderMixin swaps the OIT
terrain sets so per-pixel fog keeps covering translucent terrain when vanilla's
"Improved Transparency" setting is on.
Builds the currently active version (see stonecutter active in stonecutter.gradle.kts,
26.3 by default):
./gradlew build
Builds every version and collects the jars into build/libs/<mod version>/:
./gradlew buildAndCollect
Runs the currently active version:
./gradlew runClient
Layers are defined by sky<i>.properties files, one per layer, discovered under either:
assets/<namespace>/mcpatcher/sky/world<N>/sky<i>.properties(the original MCPatcher layout;world0= Overworld,world1= the End)assets/<namespace>/skies/<dimension namespace>/<dimension path>/sky<i>.properties(addresses any dimension by its own identifier)
Each properties file supports source, startFadeIn/endFadeIn/endFadeOut, blend,
rotate/speed/axis. See CustomSkyLayer.java for the exact parsing rules.
Texture paths have to be lowercase. Minecraft addresses pack files through resource
locations, whose paths only allow [a-z0-9/._-], so older packs that mix case (e.g.
ICY's Sunset2a.png) cannot be loaded at all - the layer is skipped with a warning
naming the file and the rest of the pack still loads.
This project's own code is available under the MIT license (see LICENSE).
The Custom Sky layer format (sky<i>.properties), the fade-brightness curve math, the
source= path-resolution rules, the rotation-axis convention, and the nine blend= modes
implemented in dev.oery.legacycustomsky.client.customsky are adapted from MCPatcher's
"Better Skies" mod (com.prupe.mcpatcher.sky.SkyRenderer,
com.prupe.mcpatcher.mal.resource.BlendMethod), https://bitbucket.org/prupe/mcpatcher.
MCPatcher is distributed under the MIT License:
Copyright (c) 2013
Permission is hereby granted, free of charge, to any person obtaining a copy of
this software and associated documentation files (the "Software"), to deal in
the Software without restriction, including without limitation the rights to
use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
of the Software, and to permit persons to whom the Software is furnished to do
so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
0 comments
log in to comment.