Specyfikacja techniczna

Minecraft Launcher pod klucz (Windows, MVP)

Ogólny cel

Potrzebne jest opracowanie desktopowego launchera Minecraft pod klucz dla Windows z autoryzacją użytkowników, potwierdzeniem logowania przez Telegram oraz możliwością skalowania pod sieć serwerów.

Strona projektu obecnie nie jest gotowa.
Dlatego na etapie MVP należy stworzyć minimalny system kont (API + baza) + powiązanie z Telegramem, aby w przyszłości te same konta mogły być używane na stronie.

Platforma i wersja

• OS: Windows 10 / 11

• Minecraft: 1.7.10 + Forge

• Java: automatyczne wyszukiwanie 64-bit

Konta i autoryzacja (MVP bez strony)

Potrzebne jest wdrożenie minimalnego backendu (API + Baza Danych) dla kont:

Rejestracja

• Rejestracja może być:

  • w launcherze (formularz rejestracji) lub

  • prosty minimalny web endpoint/strona (bez pełnej strony)

• Dane: login (lub email) + hasło

• Hasła są przechowywane tylko w postaci haszowanej (bcrypt/argon2)

Logowanie do launchera

• Logowanie za pomocą loginu + hasła

• Po poprawnych danych:

  • logowanie musi być potwierdzone przez bota Telegram

  • przyciski: ✅ Potwierdź / ❌ Odrzuć

• Bez potwierdzenia — logowanie zabronione

“Zapamiętaj mnie”

• Launcher nie przechowuje hasła w postaci jawnej

• Autologin przez token/sesję (refresh_token)

Telegram

• Bot Telegram wysyła prośbę o potwierdzenie logowania (✅/❌)

• Powiązanie z Telegramem:

  • przez jednorazowy kod

  • użytkownik pisze do bota: /start CODE

• Czas na potwierdzenie: ~120 sekund

Wybór serwerów (obowiązkowo)

• W launcherze musi być wybór serwera

• Serwery są ładowane:

  • z pliku konfiguracyjnego lub

  • z API

• Dla każdego serwera:

  • nazwa

  • krótki opis

  • profil klienta (wersja)

• Dodawanie nowych serwerów bez aktualizacji launchera (przez konfigurację/API)

Pobieranie i aktualizacja klienta

• Launcher automatycznie:

  • pobiera klienta (mods/config/inne pliki)

  • aktualizuje przez manifest lub listę plików

• Pokazuje postęp (%)

Uruchamianie Minecraft

• Uruchamianie Minecraft 1.7.10 Forge

• Po naciśnięciu “Graj” uruchamia się wybrany serwer

Ustawienia

• RAM (min/max)

• Folder gry + przycisk “Otwórz folder”

UI (MVP)

• Ciemny, nowoczesny, schludny

• Ekrany:

  • Logowanie/rejestracja

  • Oczekiwanie na potwierdzenie Telegram

  • Główny ekran (serwery)

  • Pobieranie klienta

  • Ustawienia

Minimalne API (obowiązkowo)

• POST /api/auth/register

• POST /api/auth/login → zwraca 2fa_required + challenge_id

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

• POST /api/auth/refresh

• POST /api/auth/logout

• GET /api/servers (lub konfiguracja)

Co przekazuje wykonawca

• Gotowy .exe launcher

• Cały kod źródłowy (launcher + backend + bot)

• Instrukcja:

  • jak dodawać serwery

  • jak aktualizować wersję

  • jak uruchamiać backend/bota

Format pracy

• Pod klucz

• Etapowe oddanie

• Przez bezpieczną umowę

• Kod przekazywany zamawiającemu

Kryterium gotowości

Nowy użytkownik może:

1. zarejestrować się (w launcherze lub minimalnym formularzu webowym)

2. powiązać Telegram

3. zalogować się do launchera i potwierdzić w Telegramie

4. wybrać serwer

5. pobrać wersję i uruchomić Minecraft

Budżet

15 000 zł (MVP)
Dalsze rozszerzenie (pełna strona, panel, dotacje, role itp.) — oddzielnymi etapami.