DillonLib - библиотека и API для модов Dillon

DillonLib - это библиотека (API), на которой держатся моды автора Dillon8775. Своего контента в ней нет: ни блоков, ни мобов, ни механик. Ставится она ради другого - чтобы чужие моды запускались и корректно работали на разных загрузчиках.

Проще говоря, вы скачали мод от Dillon, а он без DillonLib просто не стартанёт. Игра выдаст ошибку про отсутствующую зависимость, либо крашнется на этапе загрузки. Так что если в сборке поселился Quality of Queso, The Speedrunner Mod, Simple Keybinds или Enchantment Transferring - библиотека едет в комплекте, как обязательный пассажир.

Зачем вообще нужна библиотека модов

У Майнкрафта несколько загрузчиков: Fabric, Forge, NeoForge, Quilt. У каждого своя логика регистрации предметов, свой способ работы с конфигами, свои экраны и свои миксины. Если автор пишет мод на несколько платформ, ему приходится либо дублировать код, либо городить прослойку.

DillonLib - как раз такая прослойка. Она даёт абстракцию платформы: пишешь один раз, работает везде. Для игрока это значит, что мод Dillon не разваливается при переходе с Fabric на NeoForge, а версии выходят почти одновременно.

Что внутри

Возможностей здесь прилично, и они разные по уровню - от мелочей до вполне серьёзных систем:

• Абстракция платформы - единый слой поверх загрузчиков
• Управление миксинами и простые предикаты для них
• Система конфигурации - аккуратная, с чтением и записью настроек
• Фабрики - авторегистрация поведения для отдельных типов объектов
• Хранение данных игрока в памяти по UUID
• Задачи, привязанные к серверному тику - планировщик без костылей
• Геттер прав и конструктор экранов - быстро собрать GUI
• Калькуляторы тиков - перевод времени в тики и обратно
• Система опций и общие тексты
• Клиентские операции и списки виджетов в современном стиле
• Звуковые файлы для модов Dillon
• Встроенная проверка обновлений

Отдельно стоит сказать про фабрики. Это, по сути, автоматическая регистрация поведения: ножницы, луки, лодки, щиты, тотемы, кастомные предметы и клавиши получают нужную логику без ручной обвязки. Автору мода это экономит часы, а игроку - нервы, потому что меньше шансов наткнуться на баг с "предмет существует, но ничего не делает".

Кому это нужно на самом деле

Тут важный момент, который многие путают. DillonLib - не мод в привычном смысле, а инфраструктура. Если вы обычный игрок, вам нечего в ней настраивать: поставили, забыли, играете.

Кто вы	Что даёт DillonLib
Игрок	Моды Dillon запускаются и не крашатся
Админ сервера	Стабильная работа модов Dillon на серверной стороне
Сборщик модпаков	Одна зависимость вместо десятка костылей
Разработчик	Готовая база: миксины, конфиги, фабрики, экраны, тики

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

Установка

Ничего хитрого, но пара моментов есть:

1. Скачайте DillonLib под свою версию Minecraft и свой загрузчик
2. Закиньте файл в папку mods
3. Для Fabric дополнительно нужен Fabric API
4. Для NeoForge ничего сверху не требуется

На сервере библиотеку тоже надо ставить, если на нём крутятся моды Dillon. Клиентская часть подтянется сама, но лучше держать версии в синхроне с обеих сторон.

Важные нюансы

Версия должна совпадать. Библиотека жёстко привязана к версии Minecraft. Файл под одну ветку не заведётся на другой - это самая частая причина "мод не грузится", хотя сам мод скачан правильно.

Обновлять с умом. Актуальный стабильный релиз - 1.2.5 под Minecraft 26.3 для Fabric и NeoForge, вышел 25 октября 2026 года. Если обновили DillonLib, а мод Dillon остался старым, возможны конфликты. И наоборот: старую библиотеку новые версии модов могут просто не увидеть. Держите пару в одном состоянии.

Конфиги. В последних версиях чинили загрузку конфигурации. Если настройки не подхватываются после перезапуска - первым делом проверьте, не остался ли старый файл конфига от предыдущей версии библиотеки.

Проверка обновлений. Она встроена, но её можно отключить. На серверах с жёстким контролем трафика это порой полезно, да и лишние запросы в логах никому не нравятся.

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

Не удаляйте библиотеку "на почистить". Моды Dillon после этого отваливаются, а вместе с ними могут посыпаться ошибки при загрузке мира.

Для разработчиков

Если вы пишете свой мод, DillonLib закрывает рутину, которую обычно делаешь руками в каждом проекте: регистрация поведения для предметов, хранение данных игрока по UUID, отложенные задачи по тикам, простые предикаты для миксинов, сборка экранов и списков виджетов. Плюс общий набор звуков и текстов, чтобы не изобретать их заново.

Внешних зависимостей почти нет - только Fabric API для тех, кто на Fabric. За это отдельное спасибо, потому что тянуть в сборку три библиотеки ради одной фичи никто не любит.

Права на код принадлежат автору (all rights reserved), если не указано иное - учитывайте это, если планируете форкать или встраивать части библиотеки в свой проект.

Кому не нужен

Тем, у кого в сборке нет ни одного мода от Dillon8775. Сама по себе DillonLib в игре ничего не поменяет: ни новых предметов, ни механик, ни графики. Это чистая инфраструктура - та самая незаметная прослойка, которая делает вид, что её нет, пока всё работает.

Скачать DillonLib стоит сразу вместе с модом Dillon, который вы ставите. Так вы точно не поймаете краш на старте и не будете потом искать, чего не хватает в логах.