Peripheral

Peripheral

Пиши скрипты для Minecraft на Python.

Пиши .py-скрипты, которые читают данные из игры в реальном времени, управляют твоим игроком, строят кастомные GUI и рисуют постоянно видимые HUD-оверлеи — и всё это без единой строчки на Java. Кидаешь скрипт в папку, жмёшь запуск — и смотришь, как он работает.

Что он умеет

Peripheral запускает лёгкий HTTP-сервер прямо внутри Minecraft (localhost:25585) и подкидывает в каждый скрипт вспомогательный модуль mc. Скрипты крутятся в фоне, пока ты играешь — читают твоё здоровье, отправляют сообщения в чат, рисуют на экране или двигают игрока.

Никаких лишних зависимостей. Никаких конфигов, которые надо править руками. Всё управляется через аккуратный внутриигровой GUI (нажми G).

Возможности

Скриптинг на Python

• Скрипты лежат в config/peripheral/scripts/ — редактируй их в любом текстовом редакторе или прямо в игре
• Модуль mc подставляется автоматически. Просто from mc import * — и поехали.
• Скрипты работают в фоне — запускай несколько сразу, останавливай каждый отдельно

ИИ-конструктор скриптов

Открой вкладку Build, введи имя скрипта, опиши, что хочешь, — и ИИ запишет это прямо в файл. Использует твой собственный API-ключ Claude или OpenAI. История чата сохраняется, так что можно продолжить с того места, где остановился, чинить ошибки, отправляя логи обратно ИИ, и управлять несколькими скриптами из меню сессий.

Управление игроком

say() · look() · use_item() · equip() · jump() · sprint() · sneak() · move() · click_block() · attack() · drop_item()

Данные игры

state() · pos() · health() · inventory() · chat_log()

HUD-оверлеи

Рисуй постоянные элементы прямо на игровом экране, пока играешь:

• Labels — текст с цветом и тенью
• Bars — полоски прогресса (здоровье, прочность, XP, что угодно)
• Rects — фоновые панели с опциональной рамкой
• Item sprites — отрисовка иконки любого предмета Minecraft по ID
• Привязка к любому углу экрана или к центру — позиции масштабируются под разрешение

Кастомные внутриигровые экраны

open_gui() строит настоящие экраны Minecraft из Python — кнопки, текстовые поля, надписи, слайдеры, чекбоксы. Нажми H в игре, чтобы показать/скрыть. Скрипты продолжают обновлять данные, пока экран открыт.

`

Навигация

goto(x, z) · nav_status()

HTTP API

Каждый эндпоинт, который использует модуль mc, доступен и снаружи на localhost:25585. Подключи браузерный дашборд или локальный инструмент — и всё это без вмешательства в игру.

Примеры скриптов в комплекте

Всё ещё в разработке

Мод активно дорабатывается. Если вы наткнулись на баги, проблемы или у вас есть предложения, пожалуйста, создайте issue на github.com/Sl0oth/peripheral/issues.

С чего начать

1. Установите мод (Fabric, 1.21.11 - 26.1)
2. Запустите Minecraft — примеры скриптов и PERIPHERAL_API.md автоматически запишутся в config/peripheral/scripts/
3. Нажмите G, чтобы открыть панель Peripheral
4. Нажмите Run рядом с любым примером скрипта
5. Чтобы собрать свой скрипт с помощью ИИ: откройте вкладку Build, введите название скрипта и начинайте общаться

Внешние подключения

HTTP-сервер Peripheral слушает только localhost и никогда не подключается к удалённым серверам сам по себе. Вкладка Build отправляет сообщения в API Anthropic или OpenAI с использованием вашего собственного ключа — ничего не отправляется без вашего действия. Некоторые примеры скриптов делают исходящие HTTP-запросы к сторонним API; это происходит только когда вы явно их запускаете, а эндпоинты хорошо видны в исходном коде скрипта.

Мультиплеер

Peripheral даёт вам инструменты, способные автоматизировать действия игрока. Вы несёте ответственность за то, чтобы любые запускаемые вами скрипты соответствовали правилам сервера, на котором вы играете. Многие серверы запрещают моды автоматизации. Если сомневаетесь, уточните у владельца сервера, прежде чем запускать скрипты автоматизации в мультиплеере.

Требования

• Minecraft 1.21.11 - 26.1
• Fabric Loader 0.18.4+
• Fabric API

Только на клиенте

Peripheral работает полностью на клиенте. Установка на сервер не требуется. Работает в одиночной игре, мультиплеере и Realms.

Отказ от ответственности

Этот мод предоставляется как есть, без каких-либо гарантий. Автор не несёт ответственности за потерю предметов или игрового прогресса, повреждение файлов сохранения, баны на серверах, ущерб, вызванный написанными или запущенными вами скриптами, а также за любые последствия подключения мода к внешним сервисам. Вы несёте полную ответственность за любые созданные или выполненные вами скрипты. Использование этого мода на серверах в мультиплеере — на ваш собственный риск; всегда сначала проверяйте правила сервера. Полные условия на github.com/Sl0oth/peripheral.

100% кода мода написал Claude Code (ИИ-ассистент для программирования от Anthropic) под руководством Sl0oth.