> ## Documentation Index
> Fetch the complete documentation index at: https://andcze.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Serwery

> Podłącz swoje serwery Minecraft do sklepu i przypisuj do nich produkty.

W zakładce **Serwery** zarządzasz wszystkimi serwerami Minecraft powiązanymi z Twoim sklepem. To tutaj dodajesz serwery, na których gracze realizują zakupione przedmioty, ustawiasz ich opcje i porządkujesz je tak, jak mają być widoczne.

<Frame caption="Lista serwerów w panelu sklepu">
  <img src="https://mintcdn.com/andcze/6Qp9zwUm8VUzRssf/images/panel/servers.png?fit=max&auto=format&n=6Qp9zwUm8VUzRssf&q=85&s=46c0e675328d535248e470c0891a14d9" alt="Galeria kart serwerów z możliwością przeciągania" width="1280" height="720" data-path="images/panel/servers.png" />
</Frame>

## Po co dodaje się serwery

Każdy produkt w Twoim sklepie jest przypisany do konkretnego serwera. Dzięki temu, gdy gracz coś kupi, sklep wie, na którym serwerze ma zostać dostarczony zakup. Specjalny dodatek (plugin), który instalujesz na serwerze, łączy się ze sklepem i automatycznie realizuje zamówienia — wręcza graczom przedmioty, rangi czy inne nagrody bez Twojego udziału.

<Note>
  Zanim zaczniesz dodawać produkty, warto najpierw dodać przynajmniej jeden serwer. Bez serwera nie będzie do czego przypisać sprzedawanych przedmiotów.
</Note>

## Jak wygląda lista

Serwery prezentowane są jako lista kart — każdy serwer to osobny wiersz. Na karcie widzisz:

* **nazwę** serwera,
* **wersję Minecraft** (jeśli ją podałeś),
* **liczbę graczy online** (np. `12/100`), o ile serwer ją udostępnia,
* **status** — kolorową plakietkę „Aktywny" albo „Wyłączony",
* przyciski **edycji** (ołówek) i **usuwania** (kosz).

Liczba przy słowie **Serwery** w menu pokazuje, ile serwerów masz aktualnie dodanych, więc jednym spojrzeniem wiesz, ile ich jest.

<Tip>
  Karty możesz dowolnie przeciągać za uchwyt (⠿) po lewej stronie, zmieniając ich kolejność. Ustaw najważniejszy lub najpopularniejszy serwer na początku, aby był najbardziej widoczny. Uchwyt do przeciągania pojawia się, gdy masz więcej niż jeden serwer.
</Tip>

<Note>
  Jeśli nie masz jeszcze żadnego serwera, zobaczysz prosty komunikat zachęcający do dodania pierwszego serwera Minecraft. To normalny widok na samym początku — wystarczy kliknąć dodawanie serwera, aby zacząć.
</Note>

## Dodawanie serwera

Nowy serwer możesz dodać na dwa wygodne sposoby — obie drogi proszą o te same dane, więc wybierz tę, która Ci bardziej odpowiada:

<Columns cols={2}>
  <Card title="Kreator krok po kroku" icon="wand-sparkles">
    Prowadzi Cię etap po etapie: **Podstawy → Opis → Funkcje → Podsumowanie**. Na końcu zobaczysz przejrzyste podsumowanie wszystkich ustawień, zanim cokolwiek zapiszesz. Idealny, gdy dodajesz serwer pierwszy raz.
  </Card>

  <Card title="Klasyczny formularz" icon="list">
    Wszystkie pola na jednym ekranie, pogrupowane w sekcje **Podstawowe**, **Opis** i **Funkcje**. Szybszy, gdy wiesz już, co gdzie wpisać.
  </Card>
</Columns>

<Steps>
  <Step title="Otwórz zakładkę Serwery">
    W menu panelu kliknij **Serwery**. Zobaczysz listę kart z już dodanymi serwerami (jeśli jakieś masz).
  </Step>

  <Step title="Kliknij dodawanie nowego serwera">
    Wybierz opcję dodania serwera. Otworzy się kreator lub formularz z polami do wypełnienia.
  </Step>

  <Step title="Wpisz nazwę serwera">
    To nazwa, po której rozpoznasz serwer w panelu, np. „Survival" albo „SkyBlock". Powinna być krótka i czytelna. To jedyne **wymagane** pole — bez niego nie zapiszesz serwera.
  </Step>

  <Step title="Podaj adres serwera (opcjonalnie)">
    Wpisz adres, pod którym gracze łączą się z serwerem, np. `play.twoj-sklep.pl`. To pole jest **opcjonalne** — możesz je zostawić puste. Jeśli je podasz, musi mieć poprawny format adresu (np. `play.twoj-sklep.pl`).
  </Step>

  <Step title="Podaj wersję Minecraft (opcjonalnie)">
    Wpisz wersję gry obsługiwaną przez serwer, np. `1.21`. Pomaga to graczom dobrać właściwą wersję klienta, a w panelu od razu widzisz, na jakiej wersji działa dany serwer.
  </Step>

  <Step title="Dodaj opis (opcjonalnie)">
    Krótko opisz, czym jest dany serwer lub co go wyróżnia. Opis pomaga Tobie odróżniać serwery, gdy masz ich więcej.
  </Step>

  <Step title="Ustaw funkcje serwera">
    Włącz lub wyłącz przełączniki: vouchery, kody rabatowe i wymaganie gracza online (opisane niżej). Możesz zostawić ustawienia domyślne i zmienić je później.
  </Step>

  <Step title="Zapisz">
    Zatwierdź kreator lub formularz. W kreatorze najpierw zobaczysz **Podsumowanie** z nazwą, adresem, wersją i włączonymi funkcjami. Nowy serwer pojawi się jako kolejna karta na liście, a Ty zobaczysz krótki komunikat „Serwer dodany".
  </Step>
</Steps>

## Co oznaczają poszczególne pola

<Columns cols={2}>
  <Card title="Nazwa (wymagane)">
    Nazwa serwera widoczna w panelu i w sklepie. Ułatwia Ci odnalezienie właściwego serwera przy przypisywaniu produktów. Maksymalnie 100 znaków.
  </Card>

  <Card title="Adres serwera (opcjonalne)">
    Adres, pod którym gracze łączą się z serwerem, np. `play.twoj-sklep.pl`. Możesz go pominąć. Jeśli go podasz, musi być w poprawnym formacie adresu.
  </Card>

  <Card title="Wersja Minecraft (opcjonalne)">
    Wersja gry obsługiwana przez serwer, np. `1.21`. Ułatwia graczom dobranie właściwego klienta i porządkuje serwery w panelu.
  </Card>

  <Card title="Opis (opcjonalne)">
    Dodatkowa informacja o serwerze. Pomaga rozróżniać serwery i porządkować je w panelu. Maksymalnie 1000 znaków.
  </Card>
</Columns>

## Funkcje serwera (przełączniki)

W sekcji **Funkcje** decydujesz, jakie możliwości są dostępne dla zamówień składanych na danym serwerze. Każda funkcja to prosty przełącznik — włączony lub wyłączony.

<Columns cols={2}>
  <Card title="Zezwól na vouchery" icon="ticket">
    Gdy włączysz tę opcję, gracze mogą realizować **vouchery** przy zakupach kierowanych na ten serwer. Wyłącz ją, jeśli na danym serwerze nie chcesz honorować voucherów.
  </Card>

  <Card title="Zezwól na kody rabatowe" icon="percent">
    Pozwala stosować **kody rabatowe** przy zamówieniach z tego serwera. Wyłącz, jeśli na danym serwerze zniżki mają nie obowiązywać.
  </Card>

  <Card title="Wymagaj gracza online" icon="user-check">
    Komendy zakupu wykonają się **tylko wtedy, gdy gracz jest aktualnie na serwerze**. Przydatne, gdy nagroda musi trafić do gracza będącego w grze. Jeśli wyłączysz tę opcję, zakup zrealizuje się także wtedy, gdy gracz jest offline (o ile Twój serwer to obsługuje).
  </Card>
</Columns>

<Tip>
  Vouchery i kody rabatowe ustawiasz osobno dla każdego serwera. Dzięki temu możesz np. pozwolić na zniżki na serwerze Survival, a wyłączyć je na innym trybie. Jeśli zniżki „nie działają" na konkretnym serwerze, sprawdź najpierw te przełączniki.
</Tip>

## Status serwera: Aktywny czy Wyłączony

Na karcie każdego serwera widnieje plakietka statusu:

<Columns cols={2}>
  <Card title="Aktywny">
    Serwer jest włączony i normalnie obsługuje przypisane do niego produkty oraz zamówienia.
  </Card>

  <Card title="Wyłączony">
    Serwer jest oznaczony jako nieaktywny. Wykorzystaj ten stan, gdy serwer jest chwilowo wyłączony lub w przebudowie i nie chcesz, by trafiały na niego nowe zamówienia.
  </Card>
</Columns>

## Liczba graczy online

Jeśli serwer ją udostępnia, na jego karcie zobaczysz licznik graczy w formacie `online/maks`, np. `12/100`. To wygodny podgląd „na żywo", który pokazuje, ilu graczy jest aktualnie na serwerze. Jeśli licznik się nie pojawia, oznacza to po prostu, że dany serwer nie podaje tej informacji — nie wpływa to na działanie sklepu ani realizację zamówień.

## Edytowanie i usuwanie serwera

<Steps>
  <Step title="Edycja">
    Na karcie serwera kliknij ikonę **ołówka**. Otworzy się ten sam zestaw pól co przy dodawaniu — zmień, co potrzebujesz, i zapisz zmiany. Zobaczysz komunikat „Serwer zaktualizowany".
  </Step>

  <Step title="Usuwanie">
    Kliknij ikonę **kosza**. Pojawi się pytanie z potwierdzeniem („Usunąć serwer?"). Po zatwierdzeniu serwer zostanie **trwale usunięty** z listy.
  </Step>
</Steps>

<Warning>
  Usunięcie serwera jest nieodwracalne. Zanim usuniesz serwer, upewnij się, że nie masz na nim aktywnych produktów, które miałyby gdzie się realizować. Bezpieczniej jest najpierw przenieść produkty na inny serwer lub oznaczyć serwer jako **Wyłączony**.
</Warning>

<Note>
  Dodawanie, edycja i usuwanie serwerów zależą od Twoich uprawnień. Jeśli pracujesz w zespole z ograniczoną rolą, niektóre przyciski (np. edycji lub usuwania) mogą być dla Ciebie niewidoczne. W razie potrzeby poproś właściciela sklepu o nadanie odpowiednich uprawnień.
</Note>

## Przypisywanie produktów do serwera

Po dodaniu serwera możesz kierować na niego sprzedaż. Podczas tworzenia lub edycji produktu wskazujesz, do którego serwera ma on trafiać. Dzięki temu zakup zostanie zrealizowany dokładnie tam, gdzie gracz tego oczekuje.

<Warning>
  Jeśli podajesz adres serwera, upewnij się, że jest wpisany poprawnie. Błędny adres może sprawić, że plugin nie połączy się z serwerem, a zamówienia nie zostaną zrealizowane.
</Warning>

<Tip>
  Masz kilka serwerów (np. Survival i SkyBlock)? Dodaj każdy z nich osobno i przypisuj produkty do właściwego serwera. Gracze kupią dokładnie to, co działa na ich ulubionym trybie gry.
</Tip>

## Dobre praktyki

<Tip>
  * **Czytelna nazwa** — nazwij serwer tak, jak nazywają go gracze (np. „Survival", „SkyBlock"), żeby łatwo było przypisywać do niego produkty.
  * **Sprawdź adres** — jeśli go podajesz, wpisz dokładnie ten sam adres, którego używają gracze w grze.
  * **Funkcje pod tryb gry** — włączaj vouchery i kody rabatowe tylko tam, gdzie naprawdę mają obowiązywać.
  * **Najpierw serwer, potem produkty** — dodaj serwer, zanim zaczniesz tworzyć produkty, aby było do czego je przypisać.
  * **Uporządkuj kolejność** — przeciągnij najważniejszy serwer na początek listy.
  * **Wyłączaj zamiast usuwać** — gdy serwer jest chwilowo niedostępny, ustaw go jako „Wyłączony" zamiast usuwać. Łatwo go wtedy przywrócić.
</Tip>