漏刻

这是什么？

Clepsydra 是 Seasons Veil 的公共 API。它是一个小型库模组，让其他模组能够读取当前季节——春、夏、秋或冬，以及当前季节的进度——而无需依赖整个 Seasons Veil 模组。

它是纯 Java 实现，不依赖特定 Minecraft 版本，因此模组只需编译一次，即可在不同游戏版本间保持兼容。

玩家需要安装它吗？

只有当其他模组要求时才有必要。Seasons Veil 已经内置了 Clepsydra，所以如果你安装了 Seasons Veil，就不需要单独安装本模组。只有当某个模组将 Clepsydra 列为独立必需依赖时，才需要单独安装。

无论 Seasons Veil 是否存在，它都能安全工作——当 Seasons Veil 未安装时，所有接口都会返回“无季节数据”，因此绝不会导致崩溃或加载顺序问题。

模组开发者说明

依赖 Clepsydra（而非整个 Seasons Veil 模组），并将其作为软依赖读取季节状态：

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

当 Seasons Veil 未安装时，所有接口都会降级为 null / false，因此无论加载顺序或模组是否存在，都是安全的。

从 Modrinth 的 Maven 仓库获取：

目前尚未在 Modrinth 上发布，我正在等待审核通过

repositories { maven("https://api.modrinth.com/maven") }
dependencies {
    modImplementation("maven.modrinth:clepsydra:1.0.0")
    include("maven.modrinth:clepsydra:1.0.0") // 可选：打包集成（Fabric jar-in-jar）
}