AE2 Web Integration

AE2 Web Integration

Дополнение для AE2, которое позволяет просматривать терминал в браузере где угодно! Также можно просматривать заказы, отменять их и даже создавать новые! Есть и интеграция с Discord (через вебхук)!

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

МОД СТАВИТСЯ ТОЛЬКО НА СЕРВЕР, В ИГРУ НИКАКИХ ПРЕДМЕТОВ НЕ ДОБАВЛЯЕТСЯ!

Демонстрация на youtube

Основной мод

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

Как?

Этот мод запускает веб-сервер при старте сервера, который хостит простой сайт — можно заходить напрямую или через API-запросы

Как веб-панель понимает, какую сеть выбрать?

Поскольку мод только серверный, никаких дополнительных терминалов или блоков, которые могли бы определять сети, не добавляется,
Сети определяются через беспроводные точки доступа (или security terminal на старых версиях mc),
все игроки, которые хотят получить доступ к конкретной сети через сайт, должны поставить беспроводную точку доступа на этой сети,
К тому же, если зайти на сайт через аккаунт Admin, у вас будет доступ ко всем сетям, где есть хотя бы одна беспроводная точка доступа (неважно, кто её поставил)

На старых версиях minecraft, где есть security terminal, сети определяются через security terminal,
все игроки, которые хотят получить доступ к сети, должны иметь свои bio cards в блоке security terminal (wild bio card игнорируется из соображений безопасности!) У аккаунта Admin будет доступ ко всем сетям на сервере, где есть security terminal (неважно, есть ли там ваша bio card)

Текущие возможности

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

Галерея

Галерея

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

В публичном режиме

все пользователи на вашем сервере могут создать аккаунт на сайте и получить доступ к своим сетям AE2,
пароли сохраняются на сервере в виде хеша PBKDF2WithHmacSHA1
После аутентификации пользователя сервер генерирует токен, действительный 1 час/7 дней, и использует его для проверки всех последующих запросов

Если публичный режим отключён,

есть только аккаунт admin, пароль которого задаётся в конфиге. механизм токенов такой же, как в публичном режиме.

Примечание: подключения с localhost по умолчанию автоматически аутентифицируются, это можно изменить в конфиге!

Требования

• Открытый порт, если хотите получить доступ к сервису вне локальной сети (настраивается, терминал будет доступен по адресу http://your-server-ip-or-domain:configured-port/ например: http://server.kuba6000.pl:2324/)

Как использовать

• Скачайте последнюю версию для вашей версии игры со страницы релизов
• Положите мод в папку mods вашего сервера (только на сервер!) (Также работает в одиночной игре, но не рекомендуется)
• Запустите сервер
• Теперь конфиг можно найти в /configs/ae2webintegration/ae2webintegration.toml (или .cfg на старых версиях mc). Отредактируйте номер порта и защиту паролем под свои нужды
• Отключите публичный режим, если играете один
• [Этот шаг выполняется автоматически наблюдателем конфига начиная с 1.21.1, но вы всё ещё можете принудительно перезагрузить, если не сработало!] Перезагрузите конфиг (/ae2webintegration reload) или перезапустите сервер
• Убедитесь, что настроенный порт открыт (фаервол, проброс портов), если хотите использовать его в публичном интернете
• Теперь можно зайти на http://your-server-ip-or-domain:configured-port/ и в браузере должна появиться форма входа!
• Есть пользователь Admin по умолчанию, пароль которого задаётся в конфиге

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

Внимание: интеграция с Discord работает только при отключённом публичном режиме!

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

Свой сайт

• Если у вас уже есть веб-сервер и вы хотите разместить панель там — можно!
• Документации по API пока нет...
• Посмотрите Simple proxy site !
• Там вы найдёте простой сайт на PHP, готовый к использованию — это просто прокси для API-запросов к эндпоинту AE2.

Совместимость

На данный момент мод реализован только для версий 1.21.1 (NEO), 1.20.1, 1.12.2 и 1.7.10, хотя в будущем это может измениться!
Несколько замечаний по совместимости:

• Версия для 1.7.10 основана на GTNH-форке AE2 и GTNH-форке AE2FC для 1.7.10
• Версия для 1.12.2 основана на AE2-UEL и AE2FC для 1.12.2