Плагин для серверов Майнкрафт на Paper, который запускает Python-ботов рядом с сервером: например, бота для Discord. Он сам скачивает подходящую сборку Python, устанавливает зависимости и следит за работой процессов.
Возможности
- Запуск нескольких ботов с отдельными журналами, процессами и защитой от циклических перезапусков.
- Автоматическая установка зависимостей из
requirements.txtи повторная установка через удалениеbot/.pyrunner_deps_installed. - Перезапуск бота после сбоя с настраиваемой задержкой; при частых сбоях перезапуски прекращаются.
- Веб-панель с паролем: состояние, время работы, идентификатор процесса, число перезапусков, потребление памяти, поток журналов, управление ботом и отправка ввода в его консоль.
- Уведомления в Discord через вебхук о запуске, остановке, сбое и установке зависимостей.
- При наличии TunnelMC в консоль выводится публичный адрес туннеля для веб-панели.
Команды
Для управления используйте:
/pybot start [name]— запустить бота;/pybot stop [name]— остановить бота;/pybot restart [name]— перезапустить бота;/pybot status [name]— показать состояние всех ботов или выбранного;/pybot install [name]— заново установить зависимости;/pybot reload— перечитатьconfig.yml.
Права
pyrunner.admin — доступ ко всем командам, по умолчанию у операторов сервера.
Настройка
Код бота размещается в plugins/PyRunner/bot/; основной файл и зависимости задаются в plugins/PyRunner/config.yml. Там же указываются переменные окружения, версия Python, параметры перезапуска, пароль и порт веб-панели, а также адрес вебхука discord.webhook.url.
Требования
Нужен сервер Paper и Java 25 или выше. Плагин работает на Linux, macOS и Windows; поддерживаются архитектуры x64 и ARM64. Python скачивается автоматически и хранится в plugins/PyRunner/python/.
