Плагин для серверов Майнкрафт, который позволяет создавать и запускать плагины на JavaScript через Bukkit API и GraalVM. Скрипты размещаются в папке данных плагина и могут использовать события, управление скриптами, журналирование и таймеры.
Возможности
- Доступ к Bukkit API из JavaScript.
- Загрузка, выгрузка и перезагрузка скриптов.
- Генерация файла объявлений
global.d.tsдля разработки. - Модули
registry,scripts-manager,consoleиtimer. - В модуле
timerдоступныsetTimeout,setInterval,clearTimeoutиclearInterval. - Пользовательские команды задаются в
package.json; на один файл можно определить одну команду.
Команды
/jspig reload— перезагрузить плагин./jspig load <js>— загрузить JavaScript-скрипт./jspig unload <js>— выгрузить JavaScript-скрипт./jspig list— показать список скриптов./jspig declare— создатьglobal.d.ts./jse <command>или/jsextend <command>— выполнить пользовательскую команду скрипта.
Права
JsPig.op— доступ к командам/jspig, по умолчанию для операторов.JsPig.JsExtend— доступ к/jse, доступен всем по умолчанию.- Для пользовательской команды можно задать право в поле
permissionфайлаpackage.json, напримерJsPig.JsExtend.List. Для выдачи прав игрокам нужен менеджер прав, например LuckPerms-Bukkit.
Настройка
Папка со скриптом содержит package.json, где указываются главный файл main, подключаемые modules и, при необходимости, блок command. Обработчик команды регистрируется через registry.on, например для команды list используется событие JsExtend.list.
Требования
Нужен сервер серии Bukkit и GraalVM JDK 21 для запуска и разработки JavaScript-плагинов.
