Integrated REST

Этот мод позволяет читать данные из ваших сетей Integrated Dynamics и записывать в них через REST API.
Благодаря этому можно узнавать состояние своих сетей и миров через веб-протоколы и взаимодействовать с ними, отправляя значения методом POST на блоки HTTP Proxy в вашем мире.

Несколько примеров того, что можно сделать с этим модом (и немного внешнего кода):

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

ВНИМАНИЕ: Если вы никогда не слышали об «API» или «REST», то это, скорее всего, не для вас. Этот мод в первую очередь рассчитан на продвинутых пользователей, которые хотят построить очень сложную автоматизацию с использованием внешних систем, общающихся по HTTP.

Этот мод предоставляет ваши сети в виде JSON на настраиваемом порту. Вот фрагмент вывода одного элемента сети:

{
  "@context": "https://raw.githubusercontent.com/CyclopsMC/IntegratedREST/master-1.12/src/main/resources/context.jsonld",
  "@id": "http://localhost:3000/",
  "networkElements": [
    {
      "@id": "http://localhost:3000/networkElement/integrateddynamics/part/4",
      "position": {
        "world": 0,
        "x": -26,
        "y": 57,
        "z": -249,
        "side": "ir:east"
      },
      "block": "http://localhost:3000/registry/block/integrateddynamics/cable",
      "@type": [
        "NetworkElement",
        "http://localhost:3000/registry/part/display_panel"
      ],
      "channel": 0,
      "priority": 0,
      "updateInterval": 1,
      "network": "http://localhost:3000/network/1619976862",
      "valueType": "http://localhost:3000/registry/value/valuetype/valuetypes/integrateddynamics/string/name",
      "value": "I was updated\\nvia HTTP!",
      "target": {
        "world": 0,
        "x": -25,
        "y": 57,
        "z": -249,
        "side": "ir:west"
      },
      "loaded": true
    },
  ...
  ]
}

На самом деле этот JSON — валидный JSON-LD (Linked Data JSON), что позволяет использовать этот вывод в инструментах RDF. 

Помимо состояния вашей сети и её элементов, этот мод также предоставляет состояние большинства реестров Forge.
Вся доступная информация (доступна через индексную страницу API):

• Сети
• Элементы сети
• Типы частей
• Типы аспектов
• Типы значений
• Предметы
• Блоки
• Жидкости
• Моды

Этот мод добавляет в игру один крафтящийся блок — HTTP Proxy.

Как и все элементы сети, этот блок доступен по HTTP. Например, HTTP Proxy с ID 7 будет доступен по адресу http://localhost:3000/networkElement/integrateddynamics/http/7.

У этого блока есть внутреннее состояние значения, которое можно обновлять через HTTP POST-запросы (подробнее на вики).

Примечание: Если вы используете этот мод на сервере, скорее всего, вам стоит отключить запуск HTTP-сервера на стороне клиента, отключив его через файл конфигурации игроков.

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

Если вам нравится этот мод, поддержите меня на Patreon!