GroovyScript

Мод для скриптинга и тонкой настройки, который позволяет изменять различные игровые механики без необходимости создавать собственный мод.

Чаще всего используется для создания новых рецептов.

Вот некоторые ключевые особенности GroovyScript (сокращённо GrS):

Особенности:

1. Groovy: мощный и проверенный язык скриптинга

   • Синтаксис, совместимый с Java + взаимозаменяемый код
   • Статическая компиляция
   • Опциональная динамическая типизация
   • Метапрограммирование
2. Песочница: скрипты фактически выполняются в песочнице, а чувствительные операции занесены в чёрный список и не могут быть вызваны или использованы

3. Перезагрузка: можно тестировать изменения скриптов прямо в игре без перезапуска

   • Большинство, если не все, объекты Forge Registry можно перезагружать на лету
   • Большинство реестров модов поддерживаются нативно
4. События: легко подписываться на EventBuses от Forge с помощью Groovy Closures
5. Привычность: обработчики в скобках для тех, кто знаком с CraftTweaker (сейчас реализованы, но в ближайшем будущем могут быть удалены)
6. Информативность: команды для отображения подробной информации о предмете в руке и не только
7. Оптимизация: мы следим за тем, чтобы не было компромиссов, а все функции работали на эффективном коде
8. API: обширный каталог кода для других авторов модов, чтобы сделать их моды совместимыми с GroovyScript, например чёрные списки пакетов/классов/методов/полей

Совместимость с модами

Технически совместимость с любым модом уже есть, так как вы можете напрямую обращаться ко всему коду. Однако GroovyScript добавляет вспомогательные методы, чтобы всё было чище и проще.

Перезагрузку реестров рецептов мы должны реализовывать вручную, и это очень утомительно. Сейчас мы поддерживаем несколько модов для перезагрузки рецептов, но будем очень признательны, если кто-то поможет добавить совместимость и/или написать страницы для вики.

FaQ

• Есть ли поддержка мода X? Можно ли сделать X из мода X?

  Groovy может обращаться почти к любому Java-коду. Это значит, что "поддерживается" почти всё, если вы знаете, как это сделать. Такие вещи, как рецепты, не перезагружаются. Для этого конкретного типа рецептов нам пришлось бы добавлять поддержку вручную.

• Можете добавить поддержку мода X?

  Вероятно. Мы намерены сделать так, чтобы он работал практически с любым модом. Если нужный вам мод ещё не поддерживается, вы можете спросить нас об этом в Discord.

• Почему файл мода такой большой?

  Чтобы мод работал, нам нужно включить в него библиотеки Groovy, которые довольно много весят.

• Совместим ли он с CraftTweaker и KubeJS?

  Да, но в этом нет смысла (кроме того, что CraftTweaker сейчас поддерживает больше модов).

• Почему мне стоит использовать это вместо CraftTweaker?

  Все причины перечислены выше в разделе "Особенности". Возможность перезагружать скрипты на лету — на мой взгляд, самый весомый аргумент в пользу GroovyScript.

Присоединяйтесь к нашему Discord

Официальная вики