# KBLK Client — modpack Minecraft 1.21.11 (Fabric)

Conține modul **kblkclient-1.3.1.jar**: auto-conectare la serverul KBLK
(`mc.kblk.space`),
butonul „Intră pe KBLK" pe ecranul principal, reconectare automată după
deconectări accidentale (până la 6 încercări) și titlu de
fereastră „KBLK Client".

Necesită **Java 21** și Minecraft **1.21.11**.

## Instalare cu launcherul oficial (Minecraft Launcher)

1. Deschide launcherul oficial și creează o instalare Fabric: descarcă
   installerul Fabric de pe https://fabricmc.net/use/installer/, rulează-l,
   alege versiunea **1.21.11** și instalează.
2. Pornește o dată jocul cu profilul Fabric 1.21.11 (se creează folderul
   `mods`), apoi închide jocul.
3. Copiază `kblkclient-1.3.1.jar` în folderul `.minecraft/mods/`
   (Windows: `%appdata%\.minecraft\mods`; Linux: `~/.minecraft/mods`).
4. Opțional: pentru „Quick Play" direct pe server, deschide
   `launcher_profiles.json` din `.minecraft` și adaugă în profilul Fabric
   câmpul `"quickPlayMultiplayer": "mc.kblk.space"` (vezi șablonul
   `official-launcher-profile-template.json`).
5. Pornește jocul cu profilul Fabric 1.21.11 — clientul se va conecta
   automat la server la prima deschidere a meniului principal.

## Instalare cu Prism Launcher

1. Deschide Prism Launcher → **Add Instance** → **Import** → alege fișierul
   `kblkclient-prism-instance.zip`. Instanța „KBLK Client" apare în listă.
2. Asigură-te că instanța are Java 21 (Settings → Java → auto-detect).
3. Apasă **Play** — Minecraft 1.21.11 cu Fabric Loader 0.20.1 pornește cu
   modul deja instalat și se conectează automat la serverul KBLK.

## Actualizare automată (auto-update)

Clientul își verifică singur actualizarea la fiecare pornire, pe fundal,
fără să blocheze jocul. Fluxul:

1. La prima afișare a ecranului principal se descarcă manifestul de la
   `https://kblk.space/client/version.json` (cu timeout de 5 secunde).
2. Dacă versiunea din manifest este mai mare decât versiunea curentă
   a modului, jarul nou este descărcat **în același folder `mods/`**,
   cu numele `kblkclient-<versiune>.jar`.
3. Lângă el se scrie un fișier-marker `kblkclient.update` care conține
   numele jarului vechi; la următoarea pornire jarul vechi este șters
   automat, iar apoi jocul rulează doar versiunea nouă.
4. Pe ecranul principal apare mesajul
   „KBLK Client X.Y.Z disponibil — repornește jocul pentru actualizare"
   împreună cu butonul **„Restart acum"**, care închide jocul curat.
   Actualizarea se aplică la repornire.

Dacă manifestul principal nu răspunde, se încearcă fallback-ul GitHub
(`https://api.github.com/repos/kblkmc/kblk-client/releases/latest`):
un release cu un asset numit `kblkclient-X.Y.Z.jar` este echivalent cu
manifestul. Dacă nici fallback-ul nu funcționează (ex. repo inexistent),
verificarea eșuează silențios — jocul continuă fără actualizare.

Siguranță: se acceptă doar adrese `http(s)`, jarul maxim ~20 MB,
fișierul descărcat trebuie să înceapă cu semnătura `PK` de fișier zip,
iar un download întrerupt este șters.

## Fișiere

Toate se descarcă de pe https://kblk.space/#client

- `kblkclient-prism-instance.zip` — instanță de importat în Prism Launcher
- `kblkclient-1.3.1.jar` — modul, se pune direct în `.minecraft/mods/`
- `official-launcher-profile-template.json` — șablon de profil cu Quick Play

Întrebări sau probleme: contact@kblk.space