Плагин для серверов Майнкрафт, который позволяет писать и запускать скрипты JavaScript и Java через браузерный редактор без перезагрузки сервера. Скрипты могут обрабатывать игровые события, выполнять команды и управлять игроками.
Возможности
- Браузерный редактор для JavaScript и Java, открываемый по персональной ссылке из игрового чата.
- Запуск кода сочетанием
Ctrl+Enter. - Обработчики событий входа, выхода, смерти, возрождения, перемещения и взаимодействия игрока, чата, ломания и установки блоков.
- Действия со стороны скрипта: сообщения, лечение, выдача предметов, телепортация, смена режима игры, запуск серверных команд, рассылки, список игроков и просмотр TPS.
- Компиляция Java-классов прямо на работающем сервере; поддерживаются классы с
implements Listener,extends EngineScriptили методомrun(ScriptContext). - Сохранение скриптов в общей библиотеке сервера либо в отдельных папках игроков.
- Режим
Auto-Start: отмеченные скрипты сохраняются вplugins/PluginEngine/startup.jsonи запускаются при старте сервера. - Встроенный каталог скриптов сообщества с поиском и фильтром по JavaScript и Java. Перед запуском чужой код следует проверять: он получает полные права сервера.
Команды
/plugin-engine— открыть сессию и получить ссылку на редактор./plugin-engine revoke— завершить свои сессии; уже запущенные скрипты продолжат работать./plugin-engine stop— остановить все скрипты./plugin-engine status— показать активные сессии, число скриптов и состояние подключения./plugin-engine help— вывести справку.
Также работают сокращения /pe и /peng.
Права
pluginengine.use— открытие сессии и работа в редакторе; по умолчанию доступно операторам.pluginengine.admin— команды/plugin-engine stopиrevoke all; по умолчанию доступно операторам.
Выдавайте эти права только доверенным игрокам, поскольку скрипты выполняются с полными правами сервера.
Настройка
В config.yml доступны параметры:
port— порт встроенного веб-сервера.max-sessions— максимальное число одновременных сессий.session-duration-minutes— срок действия ссылки на сессию.global-storage— общая библиотека скриптов (true) или отдельные папки игроков (false).backend-url— адрес удалённого сервиса; оставьте пустым, чтобы всегда использовать локальный веб-сервер.server-id— уникальный идентификатор сервера, создаваемый автоматически; не изменяйте его вручную.
Если удалённый сервис недоступен, используется встроенный веб-сервер на указанном порту. Скрипты в памяти исчезают после перезагрузки или перезапуска сервера; для постоянного запуска используйте Auto-Start.
Требования
Нужен сервер Paper и Java 21 или выше. Для скриптов Java требуется JDK: JavaScript работает и с обычной JRE.
