Ducky Updater Lib

Ducky Updater Lib - это небольшая, но очень полезная библиотека для Майнкрафт, которая решает одну конкретную задачу: автоматическую проверку обновлений модов через платформу Modrinth. Если вы разработчик модов для Fabric и хотите, чтобы игроки всегда знали о выходе новых версий вашего проекта, эта библиотека - то, что нужно.

Что делает Ducky Updater Lib

Сама по себе библиотека не добавляет никакого игрового контента. Она работает на стороне клиента и сервера, проверяя через API Modrinth, вышла ли новая версия конкретного мода. Если обновление найдено, игрок получает уведомление прямо в игре. Никаких отдельных лаунчеров или внешних программ не требуется.

Проект распространяется под лицензией MIT, так что использовать его можно свободно. Весит библиотека всего около 17 килобайт, что делает её одним из самых лёгких решений для встроенной проверки обновлений в экосистеме Fabric.

Зачем это нужно

Каждый, кто играл в Майнкрафт с модами, знает эту боль: вышла новая версия любимого мода, а ты об этом узнаёшь через неделю случайно зайдя на Modrinth или CurseForge. Ducky Updater Lib решает эту проблему на уровне самого мода. Разработчик подключает библиотеку, указывает свой Modrinth ID, и всё - игроки автоматически получают уведомления о новых версиях.

Для игроков это удобно, потому что не нужно вручную отслеживать десятки модов. Для разработчиков - ещё удобнее, потому что аудитория быстрее переходит на свежие версии, а значит меньше багрепортов по уже исправленным проблемам.

Совместимость и версии

Библиотека работает исключительно на загрузчике Fabric. Forge, NeoForge и Quilt не поддерживаются. Зато диапазон версий Minecraft впечатляет: от 1.13 до актуальных веток 1.21.x и новых снапшот-версий 26.x. Последний подтверждённый релиз - версия 2026.6.1 для Minecraft 26.2.

Подключение зависимости

Если вы разработчик и хотите добавить Ducky Updater Lib в свой проект, вот как это делается.

build.gradle.kts

repositories {
    maven {
        url = "https://api.modrinth.com/maven"
    }
}

dependencies {
    // Вариант 1: Включить Ducky Updater прямо в свой jar (добавит ~17кб)
    include(modImplementation("maven.modrinth", "ducky-updater-lib", "<version>"))
    
    // Вариант 2: Зависимость от Ducky Updater, пользователи ставят его отдельно
    modImplementation("maven.modrinth", "ducky-updater-lib", "<version>")
}

fabric.mod.json

{
  "depends": {
    "fabricloader": "*",
    // Также добавьте зависимость в fabric.mod.json
    "ducky-updater": "*"
  }
}

Настройка и использование

Начиная с версии 2023.7.1, настройка стала ещё проще. Теперь достаточно добавить блок custom в ваш fabric.mod.json и указать Modrinth ID вашего проекта:

fabric.mod.json

{
  "custom": {
    "duckyupdater": {
      // Modrinth ID мода со страницы проекта
      "modrinthId": "mWxGwd3F",
      // Опционально (release, beta, alpha)
      // По умолчанию: release
      "type": "release",
      // Опционально (true, false)
      // По умолчанию: false
      "featured": false
    }
  }
}

Параметр type определяет, какие версии учитывать при проверке. Если поставить release, игроки будут получать уведомления только о стабильных релизах. beta и alpha полезны, если вы хотите оповещать о тестовых сборках.

Параметр featured связан с featured-версиями на Modrinth. По умолчанию выключен.

public class ModName implements ModInitializer {
    @Override
    public void onInitialize() {
        DuckyUpdater.checkForUpdate(
                "modrinthId",
                "modId",
                "alpha",        // Опционально! По умолчанию release
                true            // Опционально! По умолчанию true
        );
    }
}

Важный нюанс

Если вы выбираете второй вариант подключения (без include), игрокам придётся скачать Ducky Updater Lib отдельно с Modrinth. Это стоит учитывать - не все пользователи любят ставить дополнительные зависимости. Первый вариант с include надёжнее: библиотека встраивается прямо в ваш jar и весит всего ~17 килобайт, что никак не влияет на размер файла.

Ещё один момент: библиотека проверяет обновления только через Modrinth. Если ваш мод распространяется только через CurseForge, Ducky Updater Lib не сможет его отследить.

Стоит ли скачивать

Если вы обычный игрок и видите Ducky Updater Lib в списке зависимостей какого-то мода - просто скачайте и положите в папку mods. Библиотека никак не влияет на производительность и не меняет геймплей. Она просто сидит тихо и иногда напоминает, что пора обновиться.

Если вы разработчик модов для Fabric - это один из самых простых способов добавить проверку обновлений в свой проект. Минимум кода, минимум веса, максимум пользы. Скачать Ducky Updater Lib можно с Modrinth, там же найдёте все версии для нужного Minecraft.