toucanLib

toucanLib - это небольшая библиотека-ядро для модов разработчика jvn. Сама по себе она не добавляет в Майнкрафт ни блоков, ни мобов, ни механик - её задача чисто техническая: держать общий код, который используют сразу несколько проектов автора. Если вы скачали один из его модов, а игра отказывается запускаться и ругается на отсутствующую зависимость - скорее всего, виновник именно тут, и лечится это установкой нужного jar за минуту.

Такие библиотеки в Minecraft-моддинге - обычное дело. Вместо того чтобы копировать один и тот же код регистрации, сетевых пакетов и GUI в каждый мод, автор выносит его в отдельный проект и просто подключает как зависимость. Игроку от этого тоже польза: меньше дублей кода - меньше шансов на конфликты и баги между модами одного разработчика.

Какие моды требуют toucanLib

Скачать библиотеку нужно, если её требует один из этих проектов:

• ✅ Villager Retaliation!
• ✅ Second Wind!
• ✅ Lodged
• ✅ Emerald Pouch
• ✅ Gracebound
• ✅ Where Winds Blow
• ⛔ Cirrus - начиная с версии 1.2.1 библиотека больше не нужна
• 🚧 Focus - пока в работе над версией 2.0

Проверить просто: если мод из списка выше указывает toucanLib как зависимость, ставьте оба файла. Без библиотеки такие моды не загрузятся, и лаунчер честно об этом напишет в ошибке.

Поддерживаемые версии и загрузчики

• Minecraft: 1.21.1
• Java: 21
• Загрузчики: NeoForge и Fabric

Библиотека работает и на клиенте, и на сервере. Проект собран через Architectury, поэтому для работы также понадобится Architectury API - учтите это при ручной сборке модпака, его часто забывают.

Установка для игроков

Тут всё максимально просто, но есть один важный нюанс:

• Для модов под NeoForge берите NeoForge-версию toucanLib.
• Для модов под Fabric - Fabric-версию.
• Не смешивайте версии разных загрузчиков - jar от Fabric на NeoForge не заведётся и наоборот.

Совет из практики: если вы собираете сборку с модами jvn, проверьте, что все три компонента совпадают по загрузчику - сам мод, toucanLib и Architectury API. Менеджеры вроде Modrinth App или CurseForge обычно подтягивают зависимости автоматически, а вот при ручной установке в папку mods это самая частая причина краша на старте.

Что внутри - для разработчиков

Внутри toucanLib лежит переиспользуемый код, который jvn использует во всех своих проектах: помощники регистрации, проверки стороны (клиент/сервер), инструменты для GUI и тултипов, сетевое взаимодействие, работа с камерой и HUD, парсинг данных из датапаков, утилиты случайности и кулдаунов.

Отдельно стоит упомянуть версию 0.5.0 - в ней появился API упорядоченных пассажирских мест: синхронизация схемы посадки, посадка и высадка с конкретного места, кастомные смещения позиций, атомарная пересадка водителя и сохранение состояния пассажира. Если вы разрабатываете мод с транспортом или совместной ездой на сущностях - это готовое решение под Minecraft 1.21.1.

Нужна ли она вам

Если коротко: да, если вы играете с любым модом из списка выше. ToucanLib не нагружает игру лишним контентом, не влияет на FPS и ничего не меняет в геймплее - это чисто служебный файл. Скачайте toucanLib под свой загрузчик, закиньте в папку mods рядом с основным модом и забудьте про неё. Для сборок модов и серверов на Fabric или NeoForge с модами jvn это обязательный элемент.