Skip to content

oliveryasuna/clear-sky

Repository files navigation

Clear Sky

A tiny Fabric mod that adds a fourth weather type to Minecraft: TRUE_CLEAR.

AI disclosure

Parts of this project were written with AI assistance, which I used as a learning exercise. In particular, the synced world attachment code (how the TRUE_CLEAR state is stored on the world and synced to clients via the Fabric Data Attachment API) was AI-assisted while I was figuring out how that API works. I've reviewed and understand the code, but wanted to be upfront about how it came together.

Why

Minecraft has three weather types — CLEAR, RAIN, and THUNDER — but "clear" isn't really clear. There are still clouds up there. Clear Sky adds TRUE_CLEAR, which is exactly like clear weather except the clouds are gone and you get an honest, empty blue sky.

It's a small thing, but once you notice the clouds during "clear" weather you can't un-notice them.

What it does

  • Adds TRUE_CLEAR as a new weather type. It looks identical to CLEAR, just without the cloud layer.
  • During the normal weather cycle, whenever a clear stretch begins it's a coin flip: half the time you get regular CLEAR, half the time you get TRUE_CLEAR. Rain and thunder are left completely alone.
  • Long clear stretches can drift on their own. Every 2.5 minutes or so (3000 ticks) there's a 25% chance the sky quietly switches to the other kind, so you occasionally catch the clouds rolling in or out without a drop of rain.
  • Clouds fade in and out over a couple of seconds when the weather changes, rather than popping in or vanishing instantly.

Everything is driven by the server and synced to clients, so it behaves the same in singleplayer and on a server.

Commands

TRUE_CLEAR slots right into the vanilla /weather command next to the others:

/weather true_clear [duration]
  • /weather clear — normal clear, clouds and all (unchanged from vanilla).
  • /weather true_clear — clear skies, no clouds.
  • duration is optional and works like the vanilla weather commands.

Requires permission level 2, same as the rest of /weather.

Roughly how often you'll see each

Assuming default game rules and no one forcing the weather, over a long session it shakes out to about:

Weather Share of the time
CLEAR ~42%
TRUE_CLEAR ~42%
RAIN ~14%
THUNDER ~1%

In other words, TRUE_CLEAR and CLEAR split the old "clear" time down the middle. Weather only cycles in dimensions with a sky (the Nether and End are left as-is).

Installing

  1. Grab Fabric Loader and Fabric API.
  2. Drop clear-sky.jar into your mods/ folder, alongside Fabric API.
  3. Do the same on the server if you're playing multiplayer — you'll want it on both sides so the clouds actually disappear for everyone.

Building from source

./gradlew build

The jar lands in build/libs/.

Requirements

  • Minecraft 1.21.11
  • Fabric Loader 0.19.3+
  • Fabric API
  • Java 21

License

MIT — see LICENSE. Do what you like with it.

About

A Minecraft mod that adds truly clear skies.

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages