AE2 Web Integration

Модификация-надстройка для AE2, которая открывает доступ к терминалу системы Applied Energistics 2 через веб-браузер из любого места! Функционал включает просмотр текущих заказов, их отмену и создание новых. Также реализована интеграция с Discord через вебхук.

Доступен режим для публичных серверов — каждый игрок может создать личный аккаунт и управлять несколькими независимыми сетями!

ВАЖНО: мод устанавливается только на стороне сервера. В игре не добавляются новые предметы или блоки.

Демонстрация возможностей

Видеообзор основной функциональности

Видео работы интеграции с Discord

Принцип работы

При запуске сервера мод запускает веб-сервер, который предоставляет доступ к управлению терминалом AE2 через веб-интерфейс. Также доступно API для интеграции со сторонними приложениями.

Идентификация сетей

Поскольку мод работает только на сервере и не добавляет специальных блоков, идентификация сетей происходит через беспроводные точки доступа (на старых версиях Minecraft — через терминал безопасности).

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

На версиях с терминалом безопасности сети идентифицируются через этот блок, причем для доступа игрока его биометрическая карта должна быть зарегистрирована в терминале (wild карты игнорируются в целях безопасности). Администратор видит все сети с терминалом безопасности независимо от наличия своих карт.

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

• Полнофункциональный терминал AE2 с сортировкой и фильтрацией предметов
• Ограничения на количество отслеживаемых сетей отсутствуют
• Поддержка публичного режима для многопользовательских серверов
• Создание новых заказов на крафт
• Мониторинг состояния процессинговых CPU
• Отмена активных заказов
• Отслеживание выполнения заказов

Безопасность

В публичном режиме любой пользователь сервера может создать аккаунт на веб-сайте для доступа к своим сетям AE2. Пароли хранятся в виде PBKDF2WithHmacSHA1 хэшей. После аутентификации сервер генерирует токен сроком действия 1 час или 7 дней для подтверждения последующих запросов.

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

Замечание: Подключения с локального хоста автоматически проходят аутентификацию (настраивается в конфигурации).

Системные требования и настройка

• Открытый порт для доступа извне локальной сети
• Мод совместим с версиями Minecraft 1.20.1, 1.12.2 и 1.7.10
• Версии для 1.7.10 основаны на GTNH-форках AE2 и AE2FC
• Версии для 1.12.2 используют AE2-UEL и соответствующий AE2FC

Начало работы

1. Загрузите актуальную версию мода для вашей версии игры
2. Поместите файл мода в папку mods сервера (только серверная часть)
3. Перезапустите сервер
4. Настройте параметры в файле конфигурации /configs/ae2webintegration/ae2webintegration.toml (.cfg для старых версий)
5. Для одиночной игры рекомендуется отключить публичный режим
6. Перезагрузите конфигурацию командой /ae2webintegration reload или перезапустите сервер
7. Откройте настроенный порт в брандмауэре и настройте перенаправление, если требуется внешний доступ
8. Перейдите по адресу http://ваш and-ip-или-домен:настроенный-порт/ для доступа к веб-панели
9. По умолчанию доступен пользователь Admin с паролем из конфигурации

Интеграция с Discord

Работает только при отключенном публичном режиме.

• Создайте вебхук на сервере Discord
• Укажите его в конфигурации мода

Пользовательский веб-сайт

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