MariesLib
MariesLib — это общая библиотека для NeoForge 1.21.1, на которой работают моды Marie. Она предоставляет классификацию предметов во время выполнения, обнаружение совместимости модов, инфраструктуру реестров и утилиты для разработчиков.
- Загрузчики
- NeoForge
- Скачиваний на Modrinth
- 4,9 тыс.
- Подписчиков на Modrinth
- 2
- версий
- 11
- Обновлён
- 2 октября 20262 окт.
- Опубликован
- в 2026
Коротко о моде
Ставится только на сервер; игрокам ставить не нужно
MariesLib
MariesLib — это общая библиотека для разработки моих модов на NeoForge.
Она содержит переиспользуемые системы, которые иначе пришлось бы реализовывать отдельно в каждом проекте. Она намеренно сосредоточена на инфраструктуре фреймворка, а не на предоставлении собственных игровых механик.
Что она предоставляет
- Отслеживание значений: постоянные значения игрока с затуханием, порогами, эффектами, убывающей отдачей, памятью об источниках, синергиями и вехами.
- Общее отслеживание: переиспользуемые счётчики для таких вещей, как добытые блоки, побеждённые сущности, пройденная дистанция, операции машин и другие числовые статистики.
- Классификация: настраиваемая классификация предметов с тегами, пространствами имён, ключевыми словами, рецептами, взвешенными сигналами, переопределениями, исключениями и разрешением во время выполнения.
- Совместимость: определения совместимости во время выполнения с регистрациями от модов и переопределениями конфигурации.
- Ресурсные системы: определения и переопределения на основе JSON, конфигурации и датапаков.
- Динамический UI: переиспользуемые компоненты, перетаскиваемые/изменяемые в размере панели, виджеты, уведомления, утилиты рендеринга и общий Command Center.
- Редактирование UI: позиционирование модулей, масштабирование, видимость, цвета, редактирование макета, наборы инструментов и элементы управления редактора.
- Инструменты для разработчиков: команды фреймворка, диагностика, трассировка классификации и сетевое взаимодействие запрос/ответ.
- Интеграция с KubeJS: экспериментальные привязки для отдельных API фреймворка.
Архитектура
MariesLib разделена на несколько модулей:
marie-core: основные API, отслеживание, классификация, совместимость и общие сервисыmarie-commands: команды и инструменты диагностикиmarie-resources: определения и переопределения на основе ресурсовmarie-ui: переиспользуемая инфраструктура UImarie-editor: инфраструктура редактирования и настройки UI
Библиотека спроектирована так, что фактический смысл и игровые правила задают использующие её моды.
Например:
MariesLib:: предоставляет общее отслеживание значений. Nourished:: определяет значения питательности и то, как они влияют на игрока.
Совместимость и API
MariesLib нацелена на Minecraft 1.21.1 / NeoForge. 21.1.x / Java 21.
Библиотека использует явные уровни стабильности API:
@Stable: предназначено для внешнего использования@Experimental: можно использовать, но может измениться@Internal: деталь реализации, не предназначена для внешнего использования
MariesLib распространяется как обычная зависимость NeoForge и не поставляется через Jar-in-Jar.
Проекты
В настоящее время используется или запланирована для:
- Nourished
- Thermal_Systems(WIP)
- ProjectE Extended Life (TBD)
Лицензия: LGPL-3.0-only
Исходный код: GitHub Документация: API Reference Список изменений: CHANGELOG.md
Частые вопросы
Как установить MariesLib?
Установите NeoForge под свою версию Minecraft, скачайте MariesLib под ту же версию и загрузчик, положите файл в папку mods и запустите игру с профилем загрузчика.
Для каких версий Minecraft есть MariesLib?
У MariesLib есть сборки для Minecraft 1.21.1.
Нужен ли MariesLib на сервере?
Ставится только на сервер; игрокам ставить не нужно