GroovyModLoader (GML)

Мод GroovyModLoader (GML) для Minecraft — разработка модов на Groovy

GroovyModLoader (GML) — это загрузчик, позволяющий писать и запускать моды для Minecraft на языке Groovy. Он работает как язык-поставщик для NeoForge, предоставляя возможность компилировать Groovy-код прямо в среде игры. Мод включает набор полезных библиотек (stdlib, contracts, datetime, nio, macro и др.) и механизм загрузки объявлений объектов с помощью аннотации @GMod. Для разработчиков это основной инструмент создания скриптовых модов, а для пользователей — компонент, который нужно установить в папку mods для работы других Groovy-модов.

Как это работает

GML использует технологию JiJ'ing для динамической загрузки библиотек Groovy внутри Minecraft. Это позволяет интерпретировать и компилировать код модов на лету, обеспечивая поддержку функциональности, которая обычно требует отдельного компилятора. Ядро загрузчика предоставляет класс GMLLangProvider, который обрабатывает объявления классов с помощью аннотации @GMod. Это упрощает структуру кода модов, позволяя авторам описывать объекты напрямую в скриптах без необходимости создавать сложные файлы классов Java вручную.

Встроенные модули

Сборка включает в себя набор модулей Groovy, расширяющих стандартную функциональность языка. Среди них можно выделить:

• stdlib — базовая библиотека стандартного языка.
• contracts — система контрактов для валидации типов данных.
• datetime — работа с датами и временем.
• nio — доступ к неблокирующим операциям ввода-вывода.
• macro и macro-library — поддержка макросов.
• templates — шаблонизация кода.
• typecheckers — инструменты для проверки типов.
• dateutil — утилиты для работы с датами.
• ginq — Groovy Query Language для запросов данных.
• toml и json — парсеры конфигурационных файлов.

Эти модули доступны разработчикам сразу после установки загрузчика, что ускоряет процесс написания модов.

Для кого этот мод

Этот мод имеет две целевые аудитории. Для разработчиков модов GML является фундаментом: он предоставляет среду для написания скриптов на Groovy, доступной через редактор кода игры. Документация и примеры использования находятся в файле README проекта. Для пользователей (игроков) GML не добавляет новых механик, предметов или блоков в игру. Его единственная задача — обеспечить работу других модов, написанных на языке Groovy. Чтобы использовать такие моды, пользователю необходимо просто добавить файл gml-6.0.2.jar в папку mods игрового профиля.

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

• Fabric API — похожий мод
• Cloth Config API — похожий мод
• YetAnotherConfigLib (YACL) — похожий мод
• Fabric Language Kotlin — похожий мод
• Architectury API — похожий мод
• Just Enough Items (JEI) — похожий мод

Автор: GroovyMC · Лицензия: MIT