# \ud83c\udf0d TerraLib<\/p>\n
A lightweight Fabric utility library for seasons, temperature, and world-persistent data. Designed to power seasonal survival mechanics with ease.<\/p>\n
## \ud83d\ude80 Features
\n* **Season API**: Track days and transition between Spring, Summer, Autumn, and Winter.
\n* **Temperature API**: Per-player temperature simulation with built-in effects (freezing\/overheating).
\n* **TerraWorldData**: Easy, namespaced NBT storage for saving data directly to world files.
\n* **Events**: Custom hooks for `SEASON_CHANGED`, `DAY_CHANGED`, and `PLAYER_TEMP_CHANGED`.<\/p>\n
## \ud83d\udee0 Setup for Developers
\nAdd the following to your `build.gradle`:
\n“`gradle
\nrepositories {
\n maven { url = “https:\/\/api.modrinth.com\/maven” }
\n}<\/p>\n
dependencies {
\n modImplementation “maven.modrinth:terralib:YOUR_VERSION”
\n include “maven.modrinth:terralib:YOUR_VERSION” \/\/ Recommended: bundle the lib
\n}
\n“`<\/p>\n
## \ud83d\udcd6 Quick Start
\nCheck Current Season
\n“`Java
\nSeasonAPI.Season current = SeasonAPI.getSeason();
\n if (current == SeasonAPI.Season.WINTER) {
\n \/\/ Do winter stuff
\n}
\n“`<\/p>\n
## Save Custom World Data
\n“`Java
\nTerraWorldData data = TerraWorldData.get(world);
\ndata.putInt(“my_mod”, “some_value”, 100);
\n“`<\/p>\n
## Listen for Season Changes
\n“`Java
\nTerraLibEvents.SEASON_CHANGED.register((world, oldSeason, newSeason) -> {
\n System.out.println(“The world shifted from ” + oldSeason + ” to ” + newSeason);
\n});
\n“`<\/p>\n
## \ud83d\udda5\ufe0f Commands
\nTerraLib includes a debug suite for testing seasonal and temperature logic:<\/p>\n
– \/terralib season get: Displays current season, day, and forced status.<\/p>\n
– \/terralib season set – \/terralib season skip: Skips to the next season.<\/p>\n – \/terralib temp get ## \ud83d\udcc4 License Library for the mod “seasons” made by Elias<\/p>\n","protected":false},"featured_media":153236,"template":"","meta":{"_minecraft_slug":"terralib","_minecraft_project_id":"8yQLrtw5","_minecraft_author":"justElias","_minecraft_license":"MIT","_minecraft_downloads":9,"_minecraft_follows":1,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"terralib.zip","_minecraft_size_bytes":556021,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:57:55.578636Z","_minecraft_date_created":"2026-05-07T23:40:08.622176Z","_minecraft_date_modified":"2026-05-06T12:41:18.524509Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/terralib","_minecraft_icon_attachment_id":153236,"_minecraft_imported_at":"2026-06-09T06:44:44+00:00","_minecraft_import_hash":"cd5c9f57035579acc4e999cd7ab88f48","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,873,92,159],"mod_loader":[99],"minecraft_version":[37],"class_list":["post-153235","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-library","mod_category-utility","mod_category-worldgen","mod_loader-fabric","minecraft_version-1-21-1"],"yoast_head":"\n
\nThis 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.<\/p>\n","protected":false},"excerpt":{"rendered":"