Integrated REST

Integrated REST - это технический аддон к Integrated Dynamics, который превращает вашу сеть в полноценный веб-сервис. Если вы когда-нибудь хотели дергать лампочки в доме из браузера или получать состояние мира в свой сайт - вот этим вот тут и занимаются.

Проще говоря, мод отдаёт состояние сети, сущностей и реестров Forge в формате JSON на настраиваемом HTTP-порту. Не только для чтения - можно и писать. POST-запрос на блок HTTP Proxy, и значение внутри него меняется так, будто вы сами крутанули переменную в игре.

Кому это вообще нужно

Скажу честно: если вы не знаете слов "API" и "REST", дальше можно не читать. Мод сделан не для выживальщиков, которые хотят построить красивый домик. Это инструмент для тех, кто дружит с внешним кодом - Python, Node.js, что угодно, что умеет говорить по HTTP. По сути, вы соединяете MineCraft с реальным миром или с собственными сервисами.

Вот типичные сценарии, которые встречаются на практике:

• Управлять светом в комнате, ориентируясь на время суток в игровом мире
• Проиграть звук в Minecraft, когда на почту прилетело письмо
• Показать координаты всех игроков онлайн на своём сайте
• Открыть дверь фермы мобов, когда пришло уведомление о новом подписчике

Звучит как игрушка, но по факту это мост между Майнкрафт и любой автоматизацией, которую вы способны написать руками.

Что конкретно отдаёт мод

API индексирует довольно много всего. Через корневую страницу доступны:

• Networks - сами сети Integrated Dynamics
• Network elements - элементы внутри них
• Part types, Aspect types, Value types - типы деталей, аспектов и значений
• Items, Blocks, Fluids - предметы, блоки и жидкости
• Mods - список установленных модов

Формат вывода - JSON-LD, то бишь Linked Data JSON. Это значит, что его можно скармливать RDF-инструментам напрямую, без плясок с бубном. Для обычного программиста это просто красивый JSON со ссылками @id и @context, но полезно знать, что структура не выдумана на коленке.

Блок HTTP Proxy

Мод добавляет в игру ровно один крафтящийся блок - тот самый HTTP Proxy. Он ведёт себя как любой другой элемент сети Integrated Dynamics: у него есть внутреннее значение, которое логика мода может читать и с которым может работать.

Разница в том, что это значение обновляется снаружи через POST. Например, прокси с ID 7 доступен по адресу http://localhost:3000/networkElement/integrateddynamics/http/7. Отправили туда значение - оно оказалось в сети.

Это и есть самая полезная часть. Вы не просто читаете состояние мира, вы в него пишете. Дверь, лампочка, редстоун-сигнал, запуск механизма - что угодно, что умеет реагировать на логику Integrated Dynamics.

Требования и совместимость

Проект не работает в одиночку. Ему обязательно нужны:

• Cyclops Core - библиотека-фундамент
• Integrated Dynamics - сам мод с сетями

Без них Integrated REST просто не запустится, это не тот случай, где можно поставить аддон и надеяться на лучшее.

По загрузчикам поддержка широкая: Forge и NeoForge начиная с Minecraft 1.18.2 и выше. В списке версий значатся 1.19-1.19.4, 1.20.1 и 1.20.4, 1.21-1.21.11, а также свежие релизы вроде 26.1.1-26.3 с NeoForge. Это значит, что под современные сборки мод тоже подходит, а не застрял в прошлом. Лицензия MIT, исходники открыты - если что-то не так, всегда можно залезть в код и посмотреть.

Важный нюанс для серверов: если ставите мод на сервер, отключите запуск HTTP-сервера на клиенте. Делается это в конфиге у игроков. Иначе каждый клиент будет поднимать свой локальный порт, и вы получите путаницу с адресами. Обычно админ настраивает всё централизованно на серверной стороне, а клиентам оставляет только визуальную часть.

Ещё один момент: мод собирает анонимную статистику запуска. Отключается это тоже в конфиге, при этом он уважает общие настройки snooper в Minecraft. Если вы параноидально относитесь к телеметрии - отключите в первую очередь, не помешает.

Важно знать

На каком порту работает API? По умолчанию 3000, но порт меняется в конфиге. Ставить на стандартные вроде 80 без причины не стоит - конфликтов с другими сервисами будет выше крыши.

Можно ли использовать без программирования? Технически да - можно открыть адрес в браузере и посмотреть JSON. Но реальная польза начинается там, где вы пишете внешний код, который с этим JSON работает. Браузер сам по себе двери не открывает.

Совместимо с шейдерами и Sodium? Это серверный по своей сути мод, на графику он не влияет, так что конфликтов с графическими модами нет. Единственное, за чем стоит следить - совместимость самой Integrated Dynamics с вашей сборкой.

Безопасность. REST API - это открытый HTTP-интерфейс. Если вы выставляете порт наружу без пароля, любой в сети сможет читать состояние вашего мира и писать в HTTP Proxy. В локальной сети или в тестовом режиме это не проблема, но для публичного сервера стоит подумать о фаерволе или прокси с авторизацией. Прямо мод этого не решает - он даёт инструмент, а не няню.

Зачем это в итоге? Minecraft уже давно перестал быть игрой только для строительства и выживания. Технические сборки с Integrated Dynamics, ComputerCraft и подобными модами превращают игру в песочницу для инженеров. Integrated REST закрывает последний пробел - возможность общаться с этим миром не из игры, а снаружи. Собрали базу с сетями, написали пару скриптов на Python - и вот у вас домашняя панель управления, веб-сайт со статистикой или автоматизация, завязанная на реальные события.

Если вы собираете технологичный сервер или просто любите копаться в автоматизации - это стоит внимания. Если же вы обычный игрок, который строит домики и бегает от криперов - проходите мимо, тут вам делать нечего.

Версии для скачивания Integrated REST лежат для Fabric-подобных сборок не подходят, это чисто Forge/NeoForge-история, так что проверяйте свой загрузчик перед установкой. Скачать Integrated REST стоит тем, кто уже знаком с Integrated Dynamics и хочет вывести свою автоматизацию на новый уровень - за пределы самой игры.