AucSocial

​

Требования

• Paper 1.16.5+ (или совместимые форки Paper)
• CakeAuction 2.0.0+
• Java 17+
• MySQL 5.7+ или MariaDB 10.3+

​

Режимы работы

• LOCAL — боты Discord (JDA 5) и Telegram запускаются внутри процесса сервера Minecraft. Оптимально для одиночных серверов.
• REMOTE — боты запускаются в независимом фоновом демоне AucSocial-Standalone.jar (на отдельном VPS). Серверы Minecraft связываются с ним по защищённому протоколу WebSocket RPC (WSS/TLS). Оптимально для мультисерверных сетей (BungeeCord / Velocity).

Архитектура режима REMOTE:
[Сервер Anarchy 1] ──(WSS/TLS)──┐
[Сервер Anarchy 2] ──(WSS/TLS)──┼──> [AucSocial Standalone] <──> Discord / Telegram
[Сервер Anarchy N] ──(WSS/TLS)──┘           │
      │                                     │
      └──────────── Общая MySQL ────────────┘

​

Безопасность REMOTE (WSS / TLS)

[!IMPORTANT] В производственной среде (Production) при передаче данных через публичную сеть Интернет категорически запрещено использовать незашифрованный транспорт ws://. Передача токена авторизации и RPC-пакетов должна быть защищена протоколом WSS (TLS 1.2+).

​

Рекомендуемая схема: Reverse Proxy с TLS-терминацией (Nginx)

server {
    server_name auction-bot.yourdomain.com;
    listen 443 ssl http2;

    ssl_certificate /etc/letsencrypt/live/auction-bot.yourdomain.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/auction-bot.yourdomain.com/privkey.pem;
    ssl_protocols TLSv1.2 TLSv1.3;
    ssl_ciphers HIGH:!aNULL:!MD5;

    location /aucsocial {
        proxy_pass http://127.0.0.1:8085;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_read_timeout 120s;
        proxy_send_timeout 120s;
    }
}

remote:
  ws-url: "wss://auction-bot.yourdomain.com/aucsocial"
  auth-token: "ваш_сложный_криптографический_токен"
  heartbeat-interval-seconds: 30

​

Установка

​

Режим LOCAL

1. Поместите AucSocial-1.0.0.jar в plugins/CakeAuction/addons/.
2. Запустите сервер для генерации config.yml.
3. Укажите параметры подключения к MySQL, токен бота Discord и/или Telegram.
4. Перезапустите сервер или перезагрузите аддон.

​

Режим REMOTE

1. Серверы Minecraft:
   • Установите AucSocial-1.0.0.jar на каждый сервер сети в папку аддонов.
   • В config.yml установите mode: "REMOTE".
   • Настройте remote.ws-url на ваш WSS адрес и укажите auth-token.
   • Укажите единую для всей сети базу данных MySQL.
2. Standalone Daemon:
   • Загрузите AucSocial-Standalone-1.0.0.jar на VPS.
   • Настройте standalone-config.yml (порт WebSocket, секретный токен, токены ботов, MySQL).
   • Запустите процесс через systemd или screen/tmux:
     java -jar AucSocial-Standalone-1.0.0.jar
     

​

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

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

​

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

​

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

​

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