Техническое задание

Minecraft Launcher под ключ (Windows, MVP)

Общая цель

Необходимо разработать десктопный лаунчер Minecraft под ключ для Windows с авторизацией пользователей, Telegram-подтверждением входа и возможностью масштабирования под сеть серверов.

Сайт проекта в настоящее время не готов.
Поэтому на этапе MVP нужно сделать минимальную систему аккаунтов (API + база) + Telegram-привязку, чтобы в будущем эти же аккаунты можно было использовать на сайте.

Платформа и версия

• ОС: Windows 10 / 11

• Minecraft: 1.7.10 + Forge

• Java: автопоиск 64-bit

Аккаунты и авторизация (MVP без сайта)

Необходимо реализовать минимальный бэкенд (API + БД) для аккаунтов:

Регистрация

• Регистрация может быть:

  • в лаунчере (форма регистрации) или

  • простой минимальный веб-эндпоинт/страница (без полного сайта)

• Данные: логин (или email) + пароль

• Пароли хранятся только в хеше (bcrypt/argon2)

Вход в лаунчер

• Вход по логину + паролю

• После правильных данных:

  • вход обязательно подтверждается через Telegram-бота

  • кнопки: ✅ Подтвердить / ❌ Отклонить

• Без подтверждения — вход запрещен

“Запомнить меня”

• Лаунчер не хранит пароль открыто

• Автологин через токен/сессию (refresh_token)

Telegram

• Telegram-бот отправляет запрос на подтверждение входа (✅/❌)

• Привязка Telegram:

  • через одноразовый код

  • пользователь пишет боту: /start CODE

• Время на подтверждение: ~120 секунд

Выбор серверов (обязательно)

• В лаунчере должен быть выбор сервера

• Серверы загружаются:

  • из конфиг-файла или

  • из API

• Для каждого сервера:

  • название

  • короткое описание

  • профиль клиента (сборка)

• Добавление новых серверов без обновления лаунчера (через конфиг/API)

Загрузка и обновление клиента

• Лаунчер автоматически:

  • загружает клиент (mods/config/другие файлы)

  • обновляет через manifest или список файлов

• Показывает прогресс (%)

Запуск Minecraft

• Запуск Minecraft 1.7.10 Forge

• После нажатия “Играть” запускается выбранный сервер

Настройки

• RAM (мин/макс)

• Папка игры + кнопка “Открыть папку”

UI (MVP)

• Темный, современный, аккуратный

• Экраны:

  • Логин/регистрация

  • Ожидание Telegram-подтверждения

  • Главный экран (сервера)

  • Загрузка клиента

  • Настройки

Минимальный API (обязательно)

• POST /api/auth/register

• POST /api/auth/login → возвращает 2fa_required + challenge_id

• GET  /api/auth/2fa/status?challenge_id=...

• POST /api/auth/refresh

• POST /api/auth/logout

• GET /api/servers (или конфиг)

Что передает исполнитель

• Готовый .exe лаунчер

• Весь исходный код (launcher + backend + bot)

• Инструкция:

  • как добавлять серверы

  • как обновлять сборку

  • как запускать бэкенд/бот

Формат работы

• Под ключ

• Поэтапная сдача

• Через безопасную сделку

• Код передается заказчику

Критерий готовности

Новый пользователь может:

1. зарегистрироваться (в лаунчере или минимальной веб-форме)

2. привязать Telegram

3. войти в лаунчер и подтвердить в Telegram

4. выбрать сервер

5. загрузить сборку и запустить Minecraft

Бюджет

15 000 грн (MVP)
Дальнейшее расширение (полный сайт, кабинет, донат, роли и т.д.) — отдельными этапами.