MaLiLib

Мод MaLiLib для Minecraft — библиотека для клиентских модов

MaLiLib — это вспомогательная библиотека (library mod) для клиентских модов Minecraft, разработанная авторами masa и sakura-ryoko. Она содержит большую часть общего кода, используемого в сборках проекта masa, а также обеспечивает поддержку взаимодействия между зависимыми модами. Библиотека предоставляет готовые решения для работы с конфигурационными файлами, сериализации данных, создания пользовательских интерфейсов (GUI) и управления клавиатурными сочетаниями. Название проекта является сокращением от «masa's Litemod Library».

Назначение и архитектура

Основная цель MaLiLib — упрощение разработки и унификация кода для клиентских модов. Вместо того чтобы каждый разработчик модов писал одинаковые функции для обработки настроек или создания меню, они могут использовать готовые классы из библиотеки. Это позволяет сосредоточиться на уникальных механиках проекта, а не на рутинных задачах. Библиотека также добавляет возможности для взаимодействия между разными модами, используя общую инфраструктуру.

Встроенные возможности

MaLiLib предоставляет ряд готовых инструментов для модов:

• Конфигурация и сериализация: Полноценная система для создания и сохранения настроек, включая удобную сериализацию данных.
• Система привязок (Keybinds): Мощный механизм для создания и управления клавиатурными сочетаниями, что часто требуется для управления интерфейсами или активации действий.
• Графический интерфейс (GUI): Готовые компоненты для создания окон, меню и панелей управления, экономящие время разработчиков.
• Утилиты: Набор вспомогательных классов и методов для различных задач, необходимых в создании модов.

Зависимые моды

Библиотека является обязательной зависимостью для ряда популярных модов от автора masa. Начиная с определенных версий, следующие проекты требуют наличия MaLiLib для корректной работы:

• Item Scroller (версии 0.14.0 и новее)
• Litematica (сборок, выпущенных с 11 июня 2018 года)
• MiniHUD (версии 0.17.0 и новее)
• TellMe (версии 0.6.1 и новее)
• Tweakeroo (версии 0.8.0 и новее)

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

Важные замечания по версиям

При установке критически важно подобрать корректную версию MaLiLib для вашей версии Minecraft и используемого загрузчика. В названии файла всегда указывается тип загрузчика (например, Fabric или Forge) и версия игры. Формат имени файла выглядит как malilib-{loader}-{version}.jar (например, malilib-fabric-1.19.2-0.13.0.jar).

Особое внимание следует уделить совместимости версий. Периоды между 0.9.x и 0.10.x для версий 1.12.2, 1.14.x и 1.15.x отличались нестабильной совместимостью. Также значительные изменения внесены при переписывании кода начиная с версии 0.50.0 до релиза 1.0.0. Для избежания конфликтов рекомендуется устанавливать все моды из одного и того же релиза.

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод

Автор: sakura-ryoko · Автор: masa · Лицензия: LGPL-3.0-only