# Podłącz serwer

Plugin StillShop łączy się z panelem po HTTPS i podpisuje każde zapytanie. **Nie potrzebujesz RCON ani otwartych portów** — działa też na hostingach, które blokują porty.

## Wymagania

- **Paper, Purpur albo Spigot 1.20 lub nowszy**, uruchomiony na **Javie 21**.
- Serwer musi mieć dostęp do internetu (połączenie wychodzące do `stillshop.pl` na porcie 443).
- Opcjonalnie: [LuckPerms](https://luckperms.net) do rang i [PlaceholderAPI](/plugin/konfiguracja.md#placeholderapi).

!!!danger Nieobsługiwane
Folia, Velocity i BungeeCord nie są obsługiwane. W sieci serwerów zainstaluj plugin na **każdym serwerze gry** (np. Survival, SkyBlock), a nie na proxy — i dodaj każdy z nich osobno w panelu.
!!!

## Krok 1: dodaj serwer w panelu

1. W panelu sklepu otwórz **Serwery → Dodaj serwer**.
2. Wpisz nazwę (np. `Survival`) i wybierz silnik: **Paper / Purpur** albo **Spigot**.
3. Kliknij **Utwórz i pokaż klucze**.

Panel pokaże trzy linijki konfiguracji:

```yaml
endpoint: "https://stillshop.pl"
api-key: "ssk_…"
server-secret: "sss_…"
```

!!!danger Sekret widzisz tylko raz
Skopiuj go od razu. Kto zna `server-secret`, może podszyć się pod Twój serwer — nie wrzucaj go na Discorda ani do publicznego repozytorium. Jeśli go zgubisz, wygeneruj nowy przyciskiem **Nowy sekret**.
!!!

## Krok 2: zainstaluj plugin

1. Pobierz plugin: [StillShop-1.0.0.jar](https://stillshop.pl/downloads/StillShop-1.0.0.jar) (ten sam link jest w panelu: **Pobierz plugin**).
2. Wrzuć plik do folderu `plugins/` na serwerze.
3. Uruchom serwer raz — plugin utworzy plik `plugins/StillShop/config.yml`.

## Krok 3: wklej klucze

1. Otwórz `plugins/StillShop/config.yml`.
2. Podmień wartości `endpoint`, `api-key` i `server-secret` na te z panelu.
3. W konsoli serwera wpisz:

```
stillshop reload
```

W konsoli zobaczysz `Connected to StillShop store '…'`, a w panelu przy serwerze pojawi się zielony status **Online**.

!!!tip Sprawdź połączenie
Komenda `/stillshop status` pokazuje stan połączenia, ostatni kontakt z panelem i liczbę komend czekających na graczy. Szczegóły: [Plugin → Konfiguracja](/plugin/konfiguracja.md).
!!!

## Kilka serwerów

Do jednego sklepu podłączysz **do 10 serwerów**. Każdy dostaje własne klucze. Przy każdej komendzie produktu wybierzesz, czy ma się wykonać na wszystkich serwerach, czy tylko na jednym (np. tylko na Survivalu).

Gdy sklep ma serwery z produktami, strona główna sklepu pokazuje kafelki trybów („Wybierz tryb”), a gracz przechodzi do produktów danego serwera.

## Odłączanie i zmiana kluczy

| Przycisk | Co robi |
| --- | --- |
| **Nowy sekret** | Generuje nowy `server-secret`. Stary przestaje działać od razu — trzeba podmienić go w `config.yml` i zrobić `stillshop reload`. Klucz API zostaje ten sam. |
| **Odłącz** | Na stałe wyłącza serwer. Niewysłane komendy dla tego serwera zostają anulowane. |

## Co dalej?

[!ref text="Dodaj pierwszy produkt"](/pierwsze-kroki/pierwszy-produkt.md)