🌍 TerraLib
A lightweight Fabric utility library for seasons, temperature, and world-persistent data. Designed to power seasonal survival mechanics with ease.
🚀 Features
- Season API: Track days and transition between Spring, Summer, Autumn, and Winter.
- Temperature API: Per-player temperature simulation with built-in effects (freezing/overheating).
- TerraWorldData: Easy, namespaced NBT storage for saving data directly to world files.
- Events: Custom hooks for
SEASON_CHANGED,DAY_CHANGED, andPLAYER_TEMP_CHANGED.
🛠 Setup for Developers
Add the following to your build.gradle:
repositories {
maven { url = "[https://api.modrinth.com/maven](https://api.modrinth.com/maven)" }
}
dependencies {
modImplementation "maven.modrinth:terralib:YOUR_VERSION"
include "maven.modrinth:terralib:YOUR_VERSION" // Recommended: bundle the lib
}
📖 Quick Start
Check Current Season
SeasonAPI.Season current = SeasonAPI.getSeason();
if (current == SeasonAPI.Season.WINTER) {
// Do winter stuff
}
Save Custom World Data
TerraWorldData data = TerraWorldData.get(world);
data.putInt("my_mod", "some_value", 100);
Listen for Season Changes
TerraLibEvents.SEASON_CHANGED.register((world, oldSeason, newSeason) -> {
System.out.println("The world shifted from " + oldSeason + " to " + newSeason);
});
🖥️ Commands
TerraLib includes a debug suite for testing seasonal and temperature logic:
/terralib season get: Displays current season, day, and forced status.
/terralib season set : Forces a specific season and anchors the time offset.
/terralib season skip: Skips to the next season.
/terralib temp get : Views detailed temperature data and status labels.
📄 License
This library is available under the MIT License. Feel free to bundle it in your modpacks or use it as a dependency for your own Fabric mods.
