EventJS

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

EventJS — это аддон для KubeJS, предназначенный для добавления возможности перезагрузки нативных событий. Основная задача проекта — обеспечить функциональность, которая в стандартном KubeJS для версий 1.16–1.20 была недоступна до выхода версии 1.21.

Использование мода значительно упрощает разработку скриптов, так как оно избавляет от необходимости хранить обработчики в глобальных переменных (например, в global['someId']), что является менее производительным и более сложным методом. Теперь слушатели событий можно обновлять напрямую.

Мод обеспечивает несколько ключевых преимуществ для разработчиков скриптов:

• Динамическое добавление и удаление слушателей нативных событий без перезапуска игры.
• Защита от вылетов игры в случае возникновения ошибок в нативных обработчиках событий.
• Возможность регистрации слушателей только на стороне клиента или только на стороне сервера.
• Автоматическая замена стандартного метода прослушивания нативных событий на перезагружаемый по умолчанию.

По умолчанию EventJS заменяет оригинальный метод прослушивания нативных событий, делая его перезагружаемым. Это означает, что после установки мода стандартное прослушивание событий в Forge автоматически поддерживает перезагрузку.

Для более динамичного и четко определенного управления событиями можно использовать специальные методы NativeEvents.onEvent(...) и NativeEvents.onGenericEvent(...). Объект NativeEvents доступен во всех трех типах скриптов (client, server, startup).

NativeEvents.onEvent(eventType, handler)
NativeEvents.onEvent(priority, receiveCancelled, eventType, handler)
NativeEvents.onGenericEvent(genericClassFilter, eventType, handler)
NativeEvents.onGenericEvent(genericClassFilter, priority, receiveCancelled, eventType, handler)

Обработчик (handler) в JS-части является колбэком, принимающим событие, например: (event) => {...}. Параметры eventType и genericClassFilter могут представлять собой строку с именем класса события или сам класс, загруженный через java(...) или Java.loadClass(...).

В версии 1.4.0 для поддержки ProbeJS Legacy «из коробки» параметры eventType и genericClassFilter теперь активно поддерживают только классы, загруженные через соответствующие методы.

let eventType: Class
let genericClassFilter: Class

Хотя KubeJS для версий 1.21+ также содержит поддержку перезагрузки нативных событий с использованием имени NativeEvents, внутренняя реализация в EventJS отличается. Не следует предполагать идентичность внутренних механизмов при взаимодействии с EventJS через Java.

Требования проверенного файла

• По манифесту для файла EventJS-1.20.1-1.4.0.jar (Minecraft 1.20.1; Forge) требуется kubejs. Встроенных JAR-библиотек в проверенном файле нет.