Clepsydra

ONLY DEVELOPERS USE.

## What is this?

Clepsydra is the public API of Seasons Veil. It’s a tiny library mod that lets other
mods read the current season plus how far through
the season you are without depending on the whole Seasons Veil mod.

It’s pure Java with no Minecraft-version coupling, so a mod can compile against it once
and stay compatible across game versions.

## Do players need this?

Only if another mod asks for it. Seasons Veil already bundles Clepsydra inside itself,
so if you have Seasons Veil you do NOT need to install this separately. Install this
standalone only if a mod lists Clepsydra as a required dependency on its own.

It works safely whether or not Seasons Veil is present, everything just returns “no
season data” when Seasons Veil isn’t installed, so it never causes crashes or load-order
problems.

## For mod developers

Depend on Clepsydra (not the whole Seasons Veil mod) and read season state as a soft
dependency:

    if (Clepsydra.isAvailable()) {
        Season season = Clepsydra.seasonAt(level);
        SeasonState state = Clepsydra.stateAt(level); // season(), progress(), warmth()…
    }

Everything degrades to null / false when Seasons Veil isn’t installed, so it’s safe
regardless of load order or whether the mod is present at all.

Pull it from Modrinth’s Maven:

AS OF RIGHT NOW, IT IS NOT RELEASED ON MODRINTH YET, I AM WAITING FOR IT TO BE REVIEWED

    repositories { maven(“https://api.modrinth.com/maven“) }
    dependencies {
        modImplementation(“maven.modrinth:clepsydra:1.0.0”)
        include(“maven.modrinth:clepsydra:1.0.0”) // optional: bundle it (Fabric jar-in-jar)
    }