Skip to main content
AucSocial связывает CakeAuction с Discord и Telegram. Игроки могут привязать аккаунт, просматривать лоты и историю, получать уведомления и управлять своими лотами через бота.

Требования и режимы

Нужны Java 17+, Paper 1.16.5+ или совместимый форк и CakeAuction. В plugins/CakeAuction/addons/AucSocial/config.yml выберите режим:
  • LOCAL — боты работают в процессе Minecraft-сервера.
  • REMOTE — аддон подключается по WebSocket к отдельному приложению AucSocial Standalone, которое запускает ботов.

Установка LOCAL

  1. Поместите JAR аддона в plugins/CakeAuction/addons/ и запустите сервер для создания конфига.
  2. В plugins/CakeAuction/addons/AucSocial/config.yml оставьте mode: "LOCAL", настройте раздел database, включите нужных ботов и укажите их токены в discord.bot-token и telegram.bot-token.
  3. Перезапустите сервер или выполните /ah admin addon reload AucSocial.

Установка REMOTE

  1. Поместите JAR аддона в plugins/CakeAuction/addons/ каждого Minecraft-сервера и запустите серверы для создания конфигов.
  2. Поместите JAR standalone в отдельный каталог и запустите его из этого каталога:
    Имя JAR в команде замените на фактическое. При запуске создаётся standalone-config.yml в текущем рабочем каталоге. Остановите процесс и настройте конфиг.
  3. В standalone-config.yml укажите database, server.port, server.auth-token, а также включите нужных ботов и задайте discord.token и telegram.token. Запустите приложение снова.
  4. На каждом Minecraft-сервере установите mode: "REMOTE", настройте database для общей базы AucSocial и укажите адрес standalone и тот же токен:
  5. Перезапустите серверы или перезагрузите аддон.
Standalone принимает обычный WebSocket. Для подключения через публичную сеть настройте TLS на обратном прокси и используйте адрес wss://. Например, для порта standalone 8085:
Прокси в примере и standalone находятся на одном хосте. Настройте сертификат и сетевой доступ для своего окружения.

Привязка аккаунтов

  • 1 Minecraft UUID привязывается максимум к 1 профилю Discord и 1 профилю Telegram.
  • 1 профиль соцсети может содержать несколько привязанных Minecraft-аккаунтов (лимит задаётся max-links-per-platform).
  • Одноразовый код действителен ограниченное время (code-ttl-seconds).
  • Отвязка на одной платформе независима и не затрагивает другие соцсети.

Команды плагина

Для привязки выполните /ah social link в игре, затем /link <code> в боте.

Команды и интерфейс ботов

Поддерживаемые плейсхолдеры

Диагностика и названия валют

Настройки доступны в конфигурации аддона и в standalone-config.yml:
debug включает служебные сообщения в консоли. Ошибки и предупреждения выводятся независимо от этой настройки. currency-names задаёт обычный текст для цен, балансов, истории и уведомлений обоих ботов. Неизвестный идентификатор валюты отображается без замены. В админ-панели статус интеграции отражает подключение бота, а не только значение enabled в конфиге. Кнопки управления лотами в Telegram действуют 30 минут. После перезапуска бота или истечения этого времени запросите /lots либо /expired заново.