Задачи чат-бота: информирование клиентов, интерактивное меню или каталог, приём текстовых заказов, автоматическое бронирование. Продукт: Авторизация через Discord для Minecraft-сервера (что-то вроде SMP). Техзадание есть. (Писал ТЗ не сам - его писала нейросеть, но вроде все в порядке.) (также можно использовать связку carl-bot и ticket-tool для упрощения разработки бота) ## ТЕХНИЧЕСКОЕ ЗАДАНИЕ ### Разработка комплексной системы управления SMP-сервером **(Paper плагин + Discord бот + клиентский мод Fabric/Forge/NeoForge)** --- ### 1. ОБЩАЯ АРХИТЕКТУРА | Компонент | Спецификация | |-----------|--------------| | Серверное ядро | Paper 1.21.11 | | Клиентский мод | Fabric 1.21.1, Forge 1.21.1, NeoForge 1.21.1 (3 сборки) | | База данных | SQLite (по умолчанию) + MySQL/PostgreSQL (опционально) | | Привязка | Discord ID ? Minecraft UUID (offline-режим) | | Язык бота | Java (JDA) / Node.js / Python — на усмотрение разработчика | | Мультиплатформа мода | Architectury (рекомендуется) | --- ### 2. СЕРВЕРНЫЙ ПЛАГИН (Paper 1.21.11) #### 2.1. Модуль авторизации - Полная замена AuthMe. Пароли не используются. - Вход только при наличии привязанного Discord-аккаунта. - Первичная привязка: игрок получает код в ЛС от бота ? вводит в игре (`/link <код>`). - Ограничение: **1 Discord = 1 игровой ник** (повторная привязка запрещена). - Перехват на этапе `AsyncPlayerPreLoginEvent` — игрок без привязки откидывается ДО спавна. - Смена IP: запрос повторного подтверждения через кнопку в ЛС от бота. #### 2.2. Система Session Token (для мода) - Генерация уникального токена (UUIDv4) после привязки Discord. - Хранение в БД: токен ? Minecraft UUID ? Discord ID. - Прием токена от мода через кастомный сетевой пакет или HTTP-эндпоинт. - Валидация токена при входе. Если валиден — пропуск без запросов к Discord. - Принудительная аннуляция токена: команда `/resettoken <ник>` или автоматически при бане. #### 2.3. Синхронизация банов (кросс-бан) **Игра ? Discord:** - Команда `/ban <ник> <причина>` ? плагин находит Discord ID ? бот выдает роль “Забанен“ или блокирует пользователя. **Discord ? Игра:** - Команда бота `/ban@пользователь <причина>` ? бот отправляет команду в консоль сервера ? плагин банит по UUID. **Разбан:** - Синхронизация в обе стороны через `/pardon` (игра) и `/unban` (Discord). #### 2.4. Whitelist (белый список) - Управляется через Discord-роли. - Наличие роли = автоматическое добавление в `whitelist.json`. - Снятие роли = мгновенное удаление из вайтлиста. --- ### 3. DISCORD БОТ #### 3.1. Система тикетов с анкетой - В канале создается сообщение с кнопкой **“Подать заявку“**. - При нажатии — модальное окно с полями: - Игровой ник - Возраст - Опыт игры на SMP - Почему хочет попасть на сервер - (поля настраиваются через конфиг) - После отправки создается приватный тикет-канал. - В канале публикуется анкета (embed) + тег администрации. - Администрация и игрок могут общаться внутри тикета. #### 3.2. Кнопки модерации | Кнопка | Действие | |--------|----------| | ?? **Принять** | Выдать роль “Игрок“ ? добавить в whitelist ? привязать Discord ID ? сгенерировать токен ? отправить токен в ЛС ? закрыть тикет с архивацией | | ?? **Отклонить** | Отправить ЛС с причиной отказа ? закрыть тикет | | ? **Забанить** | Бан в Discord ? бан в Minecraft по UUID ? внести в черный список (запрет повторных заявок) ? закрыть тикет | #### 3.3. Команды бота - `/ban @пользователь <причина>` — кросс-бан - `/unban @пользователь` — кросс-разбан - `/sync` — принудительная синхронизация банов и вайтлиста - `/stats @пользователь` — статус привязки, токена, роли --- ### 4. КЛИЕНТСКИЙ МОД (Fabric / Forge / NeoForge 1.21.1) #### 4.1. Назначение - Автоматическая авторизация на сервере без открытия Discord. - При первом запуске — ввод кода из Discord (через GUI мода или чат). - После привязки — получение и локальное сохранение Session Token. - Хранение токена в зашифрованном виде (папка `/config/ModName/`). #### 4.2. Механика работы - Перехват логина (`ClientLoginPacket`) — отправка токена на сервер ДО загрузки мира. - Сервер валидирует токен: - Успех ? мгновенный вход. - Ошибка ? запрос ввода кода (мод показывает окно ввода). - Все действия в фоне, игрок видит только сообщения в чате. #### 4.3. Требования к моду - Отдельные `.jar` для Fabric, Forge, NeoForge (единая кодовая база через Architectury). - Шифрование токена (AES или аналоги). - Кнопка в GUI мода “Сбросить токен“. - Обратная совместимость: если мода нет — работа по стандартной схеме (код из Discord). --- ### 5. ТРЕБОВАНИЯ К КОДУ | Пункт | Требование | |-------|------------| | Конфигурация | Все настройки (токены, ID каналов/ролей, сообщения, команды) — через `config.yml` (плагин) и `.env` (бот) | | Независимость | Без использования DiscordSRV, AuthMe и других сторонних плагинов | | Логирование | Все действия логируются в отдельный канал Discord + файловые логи | | Масштабируемость | Поддержка MySQL для работы на нескольких серверах с общим бан-листом | | Документация | Комментарии в коде + инструкция по установке и настройке | --- ### 6. РЕЗУЛЬТАТ РАБОТЫ (что получить на выходе) 1. Плагин `.jar` для Paper 1.21.11. 2. Discord-бот (исходный код + инструкция по запуску). 3. Три версии мода `.jar` (Fabric, Forge, NeoForge 1.21.1). 4. Исходный код всех компонентов. 5. Конфигурационные файлы с примерами. 6. Инструкция по установке (порядок запуска, настройка токенов, приглашение бота). --- ### 7. ВОПРОСЫ К ИСПОЛНИТЕЛЮ - Стоимость и сроки? - Опыт с Paper API, Discord JDA/Interactions, Fabric/Forge моддингом? - Промежуточные сборки для тестирования? - Поддержка после сдачи (баг-фиксы, обновления)? --- **Конец ТЗ.**.