Integrated REST [1.21.4] [1.20.4] [1.19.4]

Для работы требуется библиотека Cyclops Core и Integrated Dynamics!

Данный мод позволяет читать данные из ваших сетей Integrated Dynamics и записывать в них через REST API.
Это делает возможным отслеживание состояния ваших сетей и миров через веб-протоколы, а также взаимодействие с ними путем отправки значений через 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):

• Сети
• Сетевые элементы
• Типы деталей (parts)
• Типы аспектов (aspects)
• Типы значений (value types)
• Предметы (items)
• Блоки (blocks)
• Жидкости (fluids)
• Моды (mods)

Мод добавляет один создаваемый блок - HTTP Proxy.

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

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

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