Плагин для серверов Майнкрафт на Paper, который запускает и контролирует ботов на Node.js прямо на сервере. Он сам загружает подходящую среду Node.js, устанавливает зависимости, следит за процессом и позволяет управлять несколькими ботами из игры или веб-панели.
Возможности
- автоматическая загрузка Node.js для Linux, macOS и Windows на процессорах x64 и ARM64;
- автоматический запуск
npm install, если для бота отсутствует папкаnode_modules; - перезапуск бота после сбоя и защита от бесконечного цикла перезапусков;
- несколько ботов с отдельными процессами, журналами и восстановлением после сбоев;
- веб-панель с журналом в реальном времени, состоянием, временем работы, идентификатором процесса, числом перезапусков и потреблением памяти;
- запуск, остановка, перезапуск, установка зависимостей и отправка ввода в процесс через веб-панель;
- уведомления через вебхук Discord о запуске, остановке, сбоях и установке зависимостей;
- поддержка фиксированной основной версии Node.js через настройку;
- вывод публичного адреса панели при работе активного туннеля TunnelMC.
Команды
/nodebot start [name]— запустить бота или бота с указанным именем;/nodebot stop [name]— остановить бота;/nodebot restart [name]— перезапустить бота;/nodebot status [name]— показать состояние всех ботов или выбранного;/nodebot install [name]— повторно выполнитьnpm install;/nodebot reload— перечитатьconfig.yml.
Права
noderunner.admin — доступ к командам; по умолчанию есть у операторов сервера.
Настройка
Код бота размещается в plugins/NodeRunner/bot/; для запуска нужны index.js и package.json. Общие параметры находятся в plugins/NodeRunner/config.yml, а секреты бота указываются в разделе env:.
Веб-панель доступна по адресу http://<ip-адрес-сервера>:8080; порт задаётся в конфиге. Перед открытием панели в интернет измените пароль в config.yml. Для уведомлений укажите адрес вебхука в discord.webhook.url и включите discord.webhook.enabled: true.
Требования
Нужны Paper и Java 25 или новее. Плагин работает на Linux, macOS и Windows, включая окружения Pterodactyl. Для веб-панели на Pterodactyl требуется отдельный выделенный порт; альтернативой может служить TunnelMC.
