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).

Zakładka Plugin: klucz pluginu i gotowy plik config.yml

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

Klucz pluginu

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ń.

Plik config.yml

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.

Pobranie pluginu

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.

Klucz pluginu

Sekcja oznaczona jako 1. Klucz pluginu. Tutaj jednym kliknięciem tworzysz tajny klucz, który łączy sklep z serwerem.

Plik config.yml

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

1. Wygeneruj klucz pluginu

   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ąć.

2. Wybierz serwer (opcjonalnie)

   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.

3. Skopiuj lub pobierz config.yml

   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.

4. Wgraj konfigurację na serwer

   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.

Adres sklepu i nazwa

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.

Klucz pluginu

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).

Lista serwerów

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.

Częstotliwość sprawdzania zamówień

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.