AstralBot

AstralBot представляет собой уникальное сочетание мода для Minecraft и бота для Discord, объединённых в единый пакет. Изначально разработанный для официального сервера модпака Create: Astral, данный проект обладает кроссплатформенной реализацией, что делает его доступным для использования на любых серверах.

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

Ключевой особенностью AstralBot является простота использования для начинающих администраторов серверов при сохранении широких возможностей для опытных пользователей.

Связывание аккаунтов - интеграция аккаунтов Discord и Minecraft с опциональным требованием привязки для получения вайтлиста

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

Команды FAQ - система часто задаваемых вопросов на основе Markdown-файлов, обновляемая без перезагрузки сервера

Технические требования

Для работы мода необходимы:

• Реализация Kotlin для выбранной платформы (Kotlin For Forge или Fabric Language Kotlin)
• API конфигурации (Neo-)Forge (включено в Neo/Forge, требует отдельной установки для Fabric)

Техническая реализация

Проект построен на современных технологиях:

• JDA библиотека для взаимодействия с Discord API
• Язык Kotlin для улучшенного опыта разработки
• JetBrains Exposed для работы с базой данных

Настройки конфигурации

Доступны следующие параметры настройки:

Обязательная привязка аккаунтов - включение требования связывания аккаунтов для получения вайтлиста (по умолчанию: отключено)

Синхронизация чатов с имитацией пользователей - несколько вариантов отображения сообщений:

1. Без имитации (бот отправляет сообщения от своего имени)
2. Имитация пользователей Minecraft (используются игровые ники и аватары)
3. Имитация пользователей Discord (требует обязательной привязки аккаунтов)

По умолчанию используется имитация пользователей Minecraft при доступности вебхуков.

Управление FAQ через команды - возможность редактирования FAQ через интерфейс команд (по умолчанию: отключено)

Подключение к базе данных - используется SQLite база данных по умолчанию

Текущий статус разработки

• ✅ Система вайтлиста
• ⚠️ Команды FAQ
  • ✅ Чтение Markdown файлов
  • ✅ Обновление предложений без перезагрузки
  • ❌ Управление через команды
• ✅ Синхронизация чатов
  • ✅ Minecraft → Discord
  • ✅ Discord → Minecraft
  • ✅ Имитация пользователей (аватары Minecraft или Discord)

Запуск и настройка

Публичные экземпляры бота отсутствуют. Для использования необходимо создать новое приложение в Discord Developer Portal и настроить его с тремя привилегированными намерениями: PRESENCE, SERVER MEMBERS и MESSAGE CONTENT.

Токен бота должен быть сохранён в переменной окружения DISCORD_TOKEN или в конфигурационном файле под ключом token. Пример настройки для Unix-систем:

export DISCORD_TOKEN=<ваш токен>

java ... # команда запуска сервера

После запуска сервера сгенерируйте OAuth2 URL с разрешениями bot и applications.commands в Discord Developer Portal и используйте его для добавления бота на сервер.

Для использования имитации пользователей, улучшающей читаемость синхронизированного чата, бот попытается создать вебхук в указанном канале. Это требует разрешения на управление вебхуками. Альтернативно можно создать вебхук вручную и указать его в опции webhook.url конфигурации мода.