Мод для Майнкрафт на Fabric, который позволяет создавать и запускать дополнения на Python прямо в игре. Он добавляет изолированную среду выполнения Python, API для регистрации контента, обработки игровых событий и создания интерфейсов.
Возможности
- Регистрация полных блоков, предметов и еды через
pythonmod.registry. - Обработчики событий сервера и клиента: вход и выход игрока, запуск и остановка сервера, тик, ломание и использование блоков, использование предметов.
- Создание экранов с надписями, кнопками, ползунками и переключателями через
pythonmod.gui. - Создание HUD-панелей из XML-файлов в папке
gui/; кнопки и переключатели могут запускать Python-скрипты. - Автоматическая генерация моделей и английских названий для добавленного контента в ресурспаке
PythonMOD Generated. - Отдельная песочница для каждого пакета: ошибка в одном скрипте отключает только его, а не весь мод или сервер.
Как пользоваться
Python-дополнение распространяется как архив .pymod. В нём нужен файл pymod.json с идентификатором, версией, api_version и точкой входа, а код обычно размещают в src/main.py.
Поместите .pymod в .minecraft/mods/pythonmods/ и перезапустите игру. Клавиша P открывает менеджер пакетов; её можно переназначить. В менеджере видны загруженные и отключённые пакеты, причины ошибок, зарегистрированный контент, выданные разрешения и вывод скриптов.
Идентификатор из pymod.json становится пространством имён: например, блок ruby_ore из пакета с id gems получит идентификатор gems:ruby_ore.
Настройки
Основной файл настроек: .minecraft/config/pythonmod.json.
enabled— включает или выключает мод.autoDownloadRuntime— разрешает загрузку среды Python при первом запуске.mavenRepository— зеркало для загрузки среды.verifyChecksums— проверяет контрольные суммы загружаемых файлов.theme— тема менеджера:auto,lightилиdark.callbackTimeoutMs— максимальное время работы обработчика; превысивший его пакет отключается.verboseLogging— расширенный журнал диагностики.
Требования и совместимость
Нужны Fabric Loader и Fabric API. Для выполнения Python используется GraalPy, совместимый с Python 3.11; среда не входит в файл мода, автоматически загружается при первом запуске и сохраняется в .minecraft/pythonmod/runtime/.
Пакеты могут запрашивать разрешения file_read, file_write, network, thread, native и process. Доступ к файлам ограничен папкой pythonmod/data/<id>/; разрешения native и process дают скрипту возможности, сопоставимые с обычным Java-модом. На выделенном сервере интерфейсы недоступны, поэтому для пакетов, работающих и на клиенте, и на сервере, следует проверять gui.available().
