Мод для Майнкрафт на Fabric, добавляющий серверные сценарии на Python. Владельцы сервера могут автоматизировать действия, реагировать на события, отправлять игрокам сообщения и выполнять команды без пересборки мода; игрокам устанавливать его не требуется.
Возможности
- Загружает сценарии Python из папки сервера и сам запускает локальный процесс Python.
- Передаёт события запуска и остановки сервера, игровых тиков, входа и выхода игрока.
- API позволяет писать в журнал, отправлять сообщение всем или одному игроку и выполнять серверные команды:
mc.log(),mc.broadcast(),mc.tell()иmc.execute(). - При первом запуске создаёт пример сценария.
Как пользоваться
Файлы сценариев с расширением .py размещаются в config/pythonmc/scripts; файлы, начинающиеся с _, не загружаются. После изменения используйте /pythonmc reload.
Обработчики событий задаются функциями on_server_started, on_server_stopping, on_server_tick, on_player_join, on_player_leave, on_shutdown и on_event. В данных игрока доступны поля name и uuid, а в данных сервера — players, max_players, tick и scripts_dir.
Команды
Все команды требуют уровень прав 4.
/pythonmc status/pythonmc start/pythonmc stop/pythonmc restart/pythonmc reload/pythonmc py <python code>/pythonmc event <event_name>
Требования и совместимость
Для работы на сервере нужны Fabric Loader, Fabric API, Java 21 и установленный Python 3.8 или новее. Команда python3 или python должна быть доступна в PATH; иной путь можно указать параметром -Dpythonmc.python=/path/to/python или переменной PYTHONMC_PYTHON=/path/to/python.
Сценарии выполняются с правами процесса сервера, а mc.execute() запускает команды от имени сервера, поэтому доступ к командам и сами сценарии следует доверять только администраторам.
