> ## 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.
# Plugin Minecraft
> Połącz swój sklep z serwerem: wygeneruj klucz pluginu i gotowy plik config.yml.
Zakładka **Plugin** łączy Twój sklep ItemShop.dev z serwerem Minecraft. Dzięki pluginowi zamówienia z Twojego sklepu są realizowane automatycznie — gdy gracz zapłaci, plugin wykonuje na serwerze komendy przypisane do kupionego produktu (np. nadanie rangi, dodanie przedmiotu, wpłata na konto gracza).
Na tej stronie wykonasz dwie rzeczy: **wygenerujesz dedykowany klucz pluginu** oraz **pobierzesz gotowy plik config.yml**, który wkleisz na serwer. To wszystko, czego potrzeba, aby sklep „rozmawiał" z serwerem.
## Jak to działa
Unikalny, tajny ciąg znaków, który potwierdza, że to naprawdę Twój sklep łączy się z serwerem. Bez prawidłowego klucza serwer nie przyjmie zamówień.
Gotowa konfiguracja, którą wklejasz na serwer. Zawiera już Twój klucz oraz listę serwerów — nie musisz nic wpisywać ręcznie.
## Co widzisz na stronie
Strona jest podzielona na trzy części, ułożone od góry do dołu — przechodzisz przez nie po kolei.
Na samej górze jest sekcja z dodatkiem do serwera. Przycisk **Pobierz plugin** jest na razie nieaktywny i opisany jako „wkrótce" — sam plik dodatku przygotowujemy. Konfigurację możesz jednak przygotować już teraz.
Sekcja oznaczona jako **1. Klucz pluginu**. Tutaj jednym kliknięciem tworzysz tajny klucz, który łączy sklep z serwerem.
Sekcja oznaczona jako **2. config.yml**. Tu widzisz gotową konfigurację, którą skopiujesz lub pobierzesz na dysk.
Sekcja „Pobierz plugin" jest na razie wyłączona — to normalne. Wszystko, czego potrzebujesz, by przygotować połączenie ze sklepem, znajduje się w dwóch kolejnych krokach poniżej.
## Krok po kroku
W sekcji **1. Klucz pluginu** kliknij przycisk **Wygeneruj klucz pluginu**. Po chwili klucz pojawi się na ekranie, a w rogu zobaczysz potwierdzenie, że klucz został utworzony. Od tego momentu zostanie on automatycznie wstawiony do konfiguracji poniżej.
Klucz pokazujemy **tylko jeden raz** — zaraz po wygenerowaniu. Skopiuj go i zapisz w bezpiecznym miejscu (np. w menedżerze haseł). Po opuszczeniu strony nie zobaczysz go już w całości i jeśli go zgubisz, będziesz musiał wygenerować nowy.
Wygenerowany klucz to specjalny klucz typu „plugin". Działa tylko w zakresie potrzebnym do realizacji zamówień, więc jest bezpieczny w użyciu na serwerze. Pojawi się też na liście w sekcji **Klucze API** w ustawieniach, gdzie w razie potrzeby możesz go później usunąć.
W sekcji **2. config.yml**, nad gotową konfiguracją, znajduje się **selektor serwera**. Masz dwie możliwości:
* **Wszystkie serwery** — plik config.yml będzie zawierał listę wszystkich Twoich serwerów.
* **Jeden wybrany serwer** — plik zostanie ograniczony tylko do tego jednego serwera, który wskażesz.
Pod konfiguracją zobaczysz krótkie podsumowanie, które serwery znalazły się w pliku — dzięki temu od razu sprawdzisz, czy to te właściwe.
Jeśli prowadzisz tylko jeden serwer, zostaw ustawienie domyślne (**Wszystkie serwery**). Selektor przydaje się, gdy masz kilka serwerów i chcesz przygotować osobną konfigurację dla każdego z nich.
Jeśli nie masz jeszcze dodanego żadnego serwera, selektor się nie pokaże, a w konfiguracji lista serwerów będzie pusta. Najpierw dodaj serwer w sekcji **Serwery**, a potem wróć tutaj i przygotuj konfigurację ponownie.
Gotowy plik możesz **skopiować** jednym kliknięciem (przycisk **Kopiuj** — po skopiowaniu zmieni się na „Skopiowano") albo **pobrać** na dysk jako plik `config.yml`. Wybierz to, co Ci wygodniej — efekt jest taki sam.
Umieść plik **config.yml** w folderze pluginu na swoim serwerze (zgodnie z instrukcją obsługi serwera), a następnie zrestartuj serwer lub przeładuj plugin. Od tej chwili zamówienia z Twojego sklepu będą realizowane automatycznie.
## Co zawiera plik config.yml
Nie musisz nic w nim rozumieć ani wpisywać ręcznie — wszystko jest uzupełnione za Ciebie. Dla ciekawych: w pliku znajdziesz adres Twojego sklepu, jego nazwę, wklejony klucz pluginu, listę serwerów oraz jedno ustawienie odświeżania.
Plik wie, do którego sklepu należy — dzięki temu serwer pobiera zamówienia właśnie z Twojego sklepu, a nie z cudzego.
Tu wstawiany jest klucz z kroku 1. Jeśli jeszcze go nie wygenerowałeś, w tym miejscu zobaczysz napis `WKLEJ_TUTAJ_KLUCZ` — to znak, że trzeba uzupełnić klucz (sam go wygenerujesz lub wkleisz ręcznie).
Spis Twoich serwerów (lub jednego wybranego), na które plugin ma dostarczać zakupy. Każdy serwer ma swoją nazwę, taką jak w sekcji **Serwery**.
Ustawienie, które mówi, co ile sekund plugin pyta sklep o nowe zamówienia do zrealizowania. Domyślnie jest to wartość, która dobrze sprawdza się w większości sklepów — nie musisz jej zmieniać.
Jeśli pobierzesz lub skopiujesz konfigurację, **zanim wygenerujesz klucz**, w miejscu klucza znajdzie się napis `WKLEJ_TUTAJ_KLUCZ`. Taki plik nie będzie działał, dopóki nie wstawisz prawdziwego klucza. Nad konfiguracją zobaczysz wtedy żółtą informację przypominającą, że najpierw trzeba wygenerować klucz. Najprościej: najpierw klucz, potem kopiowanie pliku.
## Dobre praktyki
Jeśli zmienisz coś w ustawieniach serwerów w panelu (np. dodasz nowy serwer albo zmienisz jego nazwę), wygeneruj i wgraj plik config.yml ponownie, aby konfiguracja była aktualna.
**Trzymaj klucz pluginu w tajemnicy.** Nikomu go nie podawaj i nie publikuj w miejscach widocznych dla innych. Każdy, kto pozna Twój klucz, mógłby podszyć się pod Twój sklep. Jeśli masz wątpliwości, czy klucz nie wyciekł — po prostu wygeneruj nowy (a starego możesz pozbyć się w sekcji **Klucze API**), wtedy poprzedni przestanie działać.
* **Najpierw klucz, potem plik** — wygeneruj klucz, zanim skopiujesz lub pobierzesz config.yml, żeby nie wgrać na serwer pustej konfiguracji.
* **Jeden plik na serwer** — przy wielu serwerach przygotuj osobną konfigurację dla każdego z nich, korzystając z selektora serwera.
* **Zrób test po wgraniu** — wykonaj testowy zakup taniego produktu i sprawdź, czy nagroda poprawnie pojawia się na serwerze. To najszybszy sposób, by upewnić się, że wszystko działa.
* **Aktualizuj po zmianach** — po każdej zmianie serwerów odśwież i wgraj plik na nowo.