Мод для Майнкрафт на Fabric, который связывает игру с внешними программами через TCP-сокет. Он подходит для создания скриптовых механик, автоматизации, карт, интерактивных сцен и управления миром из программ на Python, C# или Dart; проект вдохновлён Minecraft Pi Protocol и плагином RaspberryJuice.
Возможности
- Открывает локальный TCP-сервер на порту
4711и принимает текстовые команды от нескольких подключённых программ. - Скрипты могут ставить и читать блоки, включая блоки из модов, менять надписи на табличках, выполнять серверные команды, а также работать с обычным миром, незером и эндом.
- Позволяет создавать мобов с точными координатами и поворотом, менять их скорость и гравитацию, искать сущностей в радиусе, создавать частицы и принудительно направлять взгляд сущности или игрока.
- Даёт доступ к здоровью, сытости, режиму игры, полёту, неуязвимости, скорости ходьбы и полёта, координатам, повороту, предмету в руке и всему инвентарю, включая броню и вторую руку. Игроков и сущностей можно телепортировать между измерениями.
- Передаёт во внешнюю программу сообщения чата, нажатия левой и правой кнопки мыши и нажатия пяти назначаемых клавиш макросов.
- Воспроизводит WAV-файлы, тоны и несколько источников звука одновременно; поддерживаются громкость, зацикливание, пауза, остановка, перемещение источника и объёмный звук с затуханием по расстоянию.
- Позволяет менять NBT-данные сущностей и блоков: например, отключать ИИ моба, делать его светящимся или задавать содержимое сундука.
Крафты
Экран mcapibridge:screen собирается так:
стеклянная панель | стеклянная панель | стеклянная панель
редстоун | светокаменная пыль | редстоун
железный слиток | железный слиток | железный слиток
Блок ввода-вывода mcapibridge:io:
железный слиток | редстоун | железный слиток
камень | камень | камень
Как пользоваться
Блок mcapibridge:screen выводит изображения или видеопоток, передаваемый скриптом. Соседние экраны объединяются в единое большое полотно; настройка идентификатора и расположения открывается правой кнопкой мыши.
mcapibridge:io связывает редстоун со скриптом: в режиме входа программа задаёт силу сигнала от 0 до 15, а в режиме выхода блок отправляет программе изменения сигнала. Его идентификатор и режим также задаются через интерфейс правой кнопки мыши.
Пять клавиш макросов назначаются в меню управления Майнкрафта. Внешние скрипты могут отслеживать эти нажатия и запускать нужную логику.
Настройки
Громкость звуков мода регулируется отдельным ползунком «MCAPIBridge Audio» в настройках звука.
Требования и совместимость
Нужен Fabric. Для работы со скриптами доступны библиотека Python, библиотека C# и библиотека Dart.
Подключившаяся к порту 4711 программа получает права оператора и полный доступ к управлению игрой. Мод предназначен для одиночной игры, локальной сети или закрытого сервера; на публичном сервере порт следует защищать межсетевым экраном.
