TerraLib

🌍 TerraLib

Легковесная утилитарная библиотека для Fabric: сезоны, температура и данные, сохраняемые в мире. Создана, чтобы без лишних усилий обеспечивать сезонную механику выживания.

🚀 Возможности

• Season API: отслеживание дней и переход между весной, летом, осенью и зимой.
• Temperature API: симуляция температуры для каждого игрока со встроенными эффектами (замерзание/перегрев).
• TerraWorldData: простое NBT-хранилище с пространствами имён для сохранения данных прямо в файлы мира.
• События: пользовательские хуки для SEASON_CHANGED, DAY_CHANGED и PLAYER_TEMP_CHANGED.

🛠 Настройка для разработчиков

Добавьте следующее в ваш 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
}

📖 Быстрый старт

Проверить текущий сезон

SeasonAPI.Season current = SeasonAPI.getSeason();
  if (current == SeasonAPI.Season.WINTER) {
    // Do winter stuff
}

Сохранить пользовательские данные мира

TerraWorldData data = TerraWorldData.get(world);
data.putInt("my_mod", "some_value", 100);

Слушать изменения сезона

TerraLibEvents.SEASON_CHANGED.register((world, oldSeason, newSeason) -> {
    System.out.println("The world shifted from " + oldSeason + " to " + newSeason);
});

🖥️ Команды

TerraLib включает набор отладочных команд для проверки сезонной логики и логики температуры:

• /terralib season get: показывает текущий сезон, день и статус принудительной установки.
• /terralib season set : принудительно устанавливает определённый сезон и фиксирует смещение времени.
• /terralib season skip: пропускает текущий сезон и переходит к следующему.
• /terralib temp get : показывает подробные данные о температуре и статусные метки.

📄 Лицензия

Эта библиотека доступна под MIT License. Смело включайте её в свои модпаки или используйте как зависимость для собственных модов на Fabric.