Мод для Майнкрафт на Fabric, который добавляет поддержку модов, написанных на Ruby. Он запускает встроенную среду JRuby и нужен игрокам как зависимость для модов на Ruby, а разработчикам — для создания таких модов.
Возможности
- Загружает Ruby-скрипты из файла мода как точки входа Fabric.
- Передаёт Ruby-объекты Fabric Loader как обычные точки входа, включая
ModInitializer,ClientModInitializer, серверные и пользовательские интерфейсы. - Автоматически сопоставляет имена методов:
on_initializeсоответствует Java-методуonInitialize. - Позволяет использовать стандартную библиотеку Ruby через
requireи подключать другие скрипты мода черезrequire_relative. - Ruby-моды используют одну общую среду JRuby, поэтому разработчикам стоит изолировать классы и импорты в модуле с уникальным именем.
Как пользоваться
Игроку нужно поместить этот мод в папку mods рядом с модом, который требует fabric-language-ruby.
Разработчик указывает адаптер ruby и путь к скрипту в fabric.mod.json:
"entrypoints": {
"main": [
{
"adapter": "ruby",
"value": "my_ruby_mod/main.rb"
}
]
}
В value можно указать путь к скрипту, класс или конкретный метод: path/to/script.rb, path/to/script.rb::Some::Constant либо path/to/script.rb::Some::Constant#method_name. Последнее выражение скрипта становится точкой входа: класс создаётся автоматически, а модуль, объект или лямбда используются напрямую.
Зависимости Ruby можно добавить в ресурсы мода во время сборки и подключить через require_relative 'vendor/setup'. Установка гемов во время игры не поддерживается; гемы с расширениями на C и те, которым нужен доступ к собственным файлам на диске, не подходят.
Требования и совместимость
Требуется Fabric Loader. Внутри мода уже находится JRuby со стандартной библиотекой Ruby. Он совместим с fabric-language-kotlin: оба языковых модуля и моды на Ruby и Kotlin могут работать в одной сборке.
