MCAPIBridge

MCAPIBridge

MCAPIBridge — мощный мод для Fabric, который устанавливает TCP-соединение в реальном времени между игрой и внешними скриптами (Python и т.д.). Он предоставляет обширный API, позволяющий программно управлять миром, сущностями и состояниями игрока, выступая в роли программируемого интерфейса для Minecraft.

Вдохновлён классическим Minecraft Pi Protocol (MCPI) и плагином RaspberryJuice.

⚡ Основные возможности

🔌 Socket-сервер

• Порт 4711: Открывает локальный TCP-сервер, слушающий текстовые команды.
• Протокол: Надёжный построчный протокол, совместимый с любым языком программирования.
• Мультиклиент: Поддерживает несколько одновременных подключений скриптов благодаря многопоточности.

🌍 Управление миром и измерениями

• Манипуляция блоками: Мгновенно устанавливайте или запрашивайте любой блок (поддерживаются блоки из модов).
• Поддержка измерений: Команды могут автоматически нацеливаться на конкретные измерения (Overworld, Nether, The End).
• Редактирование табличек: Динамически изменяйте текст на табличках.
• Серверные команды: Выполняйте любые ванильные серверные команды (например, /time, /weather) с правами оператора.

🧟 Сущности и физика

• Продвинутый спавн: Призывайте сущностей с точными координатами и поворотом (Yaw/Pitch).

• Управление физикой:

  • Скорость: Применяйте векторы силы к сущностям, чтобы запускать их (создавая снаряды).
  • Гравитация: Включайте/выключайте гравитацию для конкретных сущностей (например, чтобы стрелы летели идеально прямо).
• Радар сущностей: Сканируйте и получайте список всех сущностей в заданном радиусе.
• Система частиц: Создавайте визуальные эффекты с настраиваемым количеством, скоростью и объёмом распространения.
• Принудительный взгляд: Управляйте тем, куда смотрит игрок или сущность, с помощью lookAt — идеально для катсцен или хоррор-механик.

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

• Контроль характеристик: Читайте и изменяйте здоровье (можно выходить за ванильные лимиты), уровень сытости и режим игры.
• Способности: Включайте полёт (даже в режиме выживания), режим бога (неуязвимость) и настраивайте скорость передвижения (ходьба/полёт).

• API инвентаря:

  • Чтение: Получайте полное содержимое инвентаря (основной, броня, вторая рука).
  • Запись: Выдавайте предметы или очищайте конкретные предметы/слоты.
• Подробная информация: Доступ к данным в реальном времени, включая точную позицию, поворот и предметы в руках.
• Телепортация: Телепортируйте игроков или сущностей по координатам и между измерениями.

🖱️ Система ввода и событий

• Двусторонняя архитектура: Включает как клиентскую, так и серверную логику для точного определения ввода.

• Взаимодействия через рейкаст:

  • Правый клик: Определяет взаимодействие на расстоянии до 500 блоков (серверный рейкаст).
  • Левый клик: Определяет взаимодействия и атаки.
• Прослушивание чата: Передаёт сообщения игрового чата во внешний скрипт в реальном времени.
• Макро-клавиши: Регистрирует 5 пользовательских макро-клавиш в меню управления игрой. Скрипты могут отслеживать нажатия этих клавиш для запуска собственной логики.

🔊 Собственная аудиосистема

• Генерация тонов: Создавайте синусоидальные тоны с настраиваемой частотой, длительностью и частотой дискретизации.
• Воспроизведение WAV-файлов: Загружайте и воспроизводите собственные WAV-файлы (8/16-бит PCM, моно/стерео).
• 3D-пространственный звук: Воспроизводите звуки в конкретных мировых координатах с реалистичным затуханием по расстоянию.
• Динамическое управление: Регулировка громкости в реальном времени, зацикленное воспроизведение, пауза/остановка и обновление позиции для движущихся источников звука.
• Микширование нескольких источников: Воспроизводите несколько аудиоисточников одновременно (например, аккорды, слои окружения).
• Клонирование аудио: Эффективно клонируйте загруженные аудиоданные для многоколоночных систем с низкой задержкой.

🖥️ Собственная система экранов

• Динамический веб-экран: Новый блок mcapibridge:screen, который может отображать изображения или видеопотоки в реальном времени, управляемые скриптами.
• Бесшовное объединение: Автоматически объединяет соседние блоки экранов в один большой дисплей — идеально для видеостен или рекламных щитов.
• Высокая производительность: Использует клиентский рендеринг текстур и потоковую передачу JPG/PNG для плавного воспроизведения на 30 FPS. Рекомендуется потоковая передача JPG.
• Интерактивная настройка: Нажмите ПКМ по блоку экрана, чтобы легко настроить ID и расположение без команд.

• Рецепт крафта:

  G G G   (Стеклянная панель)
  R D R   (Redstone, Светопыль, Redstone)
  I I I   (Железный слиток)

⚡ Система физического ввода-вывода

• Блок IO-порта: Специализированный блок mcapibridge:io, который связывает Redstone в Minecraft с внешним оборудованием/скриптами.
• Режим ввода: Скрипты отправляют сигналы -> Блок выдаёт сигнал Redstone (0-15).
• Режим вывода: Блок обнаруживает сигнал Redstone -> Отправляет события в скрипты.
• Взаимодействие в реальном времени: Идеально для управления устройствами умного дома из Minecraft или визуализации данных датчиков в игре.

• Рецепт крафта:

  I R I   (Железный слиток, Redstone, Железный слиток)
  S S S   (Камень)

📦 Глубокий доступ к данным (NBT)

• Изменение NBT: Прямая запись сырых данных NBT в сущности и блоки-сущности.
• Продвинутая кастомизация: Создавайте гигантов, замораживайте мобов (NoAI), заставляйте сущностей светиться или наполняйте сундуки кастомным лутом с помощью NBT-строк в стиле JSON.

Установка

Modrinth

⚠️ Предупреждение о безопасности

Этот мод открывает порт 4711 и предоставляет полные административные (OP) права любой программе, которая к нему подключится.

• Не устанавливайте его на публичном сервере без файрвола.
• Он предназначен только для одиночной игры, LAN или приватного сервера.

Мосты

Библиотека Python

Примеры на Python

Библиотека C#

Примеры на C#

Библиотека Dart

Примеры на Dart

В будущем будут поддерживаться другие языки.

📋 Журнал обновлений

24.02.2026

• Добавлена поддержка Dart

13.02.2026

• Добавлена поддержка 1.21.4, 1.20.4, 1.20.1.
• Исправлены баги со звуком. Теперь можно использовать audio.play, чтобы возобновить приостановленное аудио.

11.02.2026

• C#: Добавлена поддержка C#.
• 1.21.1: Добавлена поддержка 1.21.1.

10.02.2026 Alpha-0.5.1

• Обновление IO-блока: Добавлен метод mc.io.config для динамической перенастройки IO-блоков через скрипты.

09.02.2026 Alpha-0.5.0

• Система физического ввода-вывода: Добавлен блок mcapibridge:io для связи Redstone с внешним вводом-выводом.

  • Режим ввода: Управление сигналом Redstone в игре из скриптов.
  • Режим вывода: Отслеживание изменений сигнала Redstone в игре через скрипты.
  • Интерактивная настройка: Нажмите ПКМ, чтобы открыть GUI для настройки ID канала и режима.
  • Визуальная индикация: Текстура блока меняется в зависимости от режима (ввод/вывод).

08.02.2026 Alpha-0.4.1

• Поддержка измерений для аудио и видео: Реализовано воспроизведение с учётом измерений. Экраны и 3D-звук теперь корректно изолируются между Верхним миром, Нижним миром и Краем.
• Подключение на ходу и возобновление воспроизведения: Добавлено сохранение состояния и синхронизация смещения. Новые игроки, подключающиеся к серверу, автоматически получают аудиоданные и возобновляют воспроизведение в идеальной синхронизации с видео.
• Настройка синхронизации: Добавлен слайдер в настройках звука для ручной корректировки компенсации задержки аудио (+/- 5.00с).

2/6/2026 Alpha-0.4.0

• Система кастомных экранов: Добавлен блок mcapibridge:screen для отображения изображений и видеопотоков в реальном времени.

  • Видеостена: Поддерживает бесшовную сборку экрана из нескольких блоков с автоматическим определением раскладки.
  • Потоковое видео в высоком разрешении: Способен транслировать контент 1080p/720p при 30 FPS через сжатие JPG/PNG.
  • Простая настройка: ПКМ открывает GUI для настройки ID экранов.
• Оптимизация звука: Добавлена команда audio.clone для эффективного дублирования аудиоисточников под многоколоночные системы (например, кинотеатры с объёмным звуком) без повторной загрузки данных.

• Исправленные баги:

  • Исправлен звук в play3d, который не мог автоматически выставить громкость на 0.
  • Исправлено, что сокет иногда оставался подключённым к мостам.

2/4/2026 Alpha-0.3.1

• Интеграция настроек звука: Добавлен нативный ползунок громкости "MCAPIBridge Audio" в меню звуковых настроек Minecraft.

2/4/2026 Alpha-0.3.0

• Система кастомного звука: Добавлена полноценная поддержка воспроизведения звука через OpenAL.

  • Генерация тонов: Создание синусоидальных тонов с настраиваемой частотой и длительностью.
  • Поддержка WAV: Загрузка и воспроизведение кастомных .wav файлов (автоматически конвертирует стерео в моно).
  • 3D-пространственный звук: Воспроизведение звука по мировым координатам с реалистичным затуханием по расстоянию и управлением rolloff.
  • Динамическая позиция: Обновление позиций источников звука в реальном времени для эффектов объёмного звучания.
  • Управление воспроизведением: Регулировка громкости, переключение цикла, пауза, остановка и выгрузка.
  • Множественные источники: Одновременное воспроизведение нескольких аудиоисточников для аккордов и слоёного звука.

2/1/2026 Alpha-0.2.2

• Глубокий контроль данных: Добавлена поддержка изменения NBT для сущностей и блоков, позволяющая продвинутую кастомизацию вроде гигантских мобов или кастомного лута.
• Управление камерой: Реализован API lookAt для принудительного взгляда игроков или сущностей на определённые координаты.

1/31/2026 Alpha-0.2.1

• Исправлен баг: Одиночное событие удара или чата теперь может обрабатываться несколькими подключёнными скриптами.

1/31/2026 Alpha-0.2.0

• Клиентский ввод: Теперь определяет ЛКМ/ПКМ даже при наведении на воздух (используя клиентские пакеты).
• Макроклавиши: Добавлено 5 настраиваемых клавиш в настройках игры, которые скрипты могут отслеживать для запуска кастомных действий.

🗺️ Планы

• Больше языковых мостов: Arduino для ESP32, Micropython для библиотек ESP32.