Jak dać zestaw startowy Minecraft nowym graczom na serwerze Paper

Co robi zestaw startowy Minecraft przy pierwszym wejściu

Zestaw z tego poradnika to kamienny miecz, kamienny kilof i 16 chlebów, a do tego prywatna wiadomość na czacie, która mówi nowemu graczowi, co właśnie dostał. Jest wydawany automatycznie, gdy gracz pierwszy raz dołącza do twojego serwera. Nie trzeba wpisywać żadnej komendy ani ustawiać uprawnień.

„Pierwszy raz” oznacza tu to, co Paper już wie: gracza, którego serwer nigdy nie zapisał przed jego dołączeniem. Runtime nie prowadzi własnej listy ani licznika. Dlatego zestaw działa na serwerze, który już prowadzisz, i dlatego też nie potrafi kilku rzeczy, opisanych niżej.

Ten przepis korzysta z edytora bloków NimBlock i jego osobnego, darmowego runtime'u. Konto NimBlock pozwala zapisać regułę. Żeby ją uruchomić, potrzebujesz istniejącego serwera Minecraft Java, którego hosting pozwala wgrywać pluginy. Poniższe kroki dotyczą Paper 1.21.11 z Java 21. Nie potrzebujesz serwera hostowanego przez NimBlock.

Zbuduj regułę zestawu w studiu

1. Otwórz swoje pluginy w NimBlock i utwórz nowy plugin. Edytor startuje z regułą powitalną; możesz ją zostawić albo usunąć.
2. Z kategorii Reguły przeciągnij nową regułę do pluginu i nazwij ją Zestaw startowy.
3. Z kategorii Wyzwalacze wstaw Gracz dołącza w jej pole gdy.
4. Z kategorii Warunki wstaw Gracz jest tu pierwszy raz w jej pole jeśli.
5. Z kategorii Akcje dodaj trzy razy Daj graczowi przedmiot: STONE_SWORD w ilości 1, STONE_PICKAXE w ilości 1, BREAD w ilości 16.
6. Na końcu dodaj Wyślij wiadomość do gracza, na przykład Witaj {player}! Oto zestaw startowy na dobry początek. Zostaw {player} dokładnie tak, jak jest: runtime zamienia to na nick gracza.
7. Zapisz plugin. Na jego stronie skopiuj cały pokazany JSON do zwykłego pliku tekstowego o nazwie starter-kit.json, zapisanego w UTF-8.

Przedmioty wpisuje się ich nazwą z Minecrafta, na przykład IRON_AXE albo COOKED_BEEF. Zamień te trzy przedmioty na własny zestaw: jedna akcja na przedmiot, każda z własną ilością. Publiczna gramatyka wymienia wszystkie dostępne wyzwalacze, warunki i akcje.

Zainstaluj go na swoim serwerze Paper

1. Pobierz runtime NimBlock. Zatrzymaj serwer, wrzuć plik .jar runtime'u bezpośrednio do plugins/, a potem uruchom serwer.
2. Sprawdź komendą /plugins, czy NimBlock jest włączony. Poradnik instalacji pluginów od Paper wyjaśnia, jak zdiagnozować nieudane ładowanie.
3. Wgraj starter-kit.json do plugins/NimBlock/specs/. Zachowaj wielkie litery w nazwie folderu. W razie potrzeby najpierw utwórz folder.
4. Jako operator serwera wpisz /nimblock reload, a potem /nimblock list. Powinna pojawić się nazwa zapisanego pluginu. W konsoli serwera pomiń ukośnik na początku.

Popraw każdy błąd zgłoszony podczas przeładowania, zanim zaczniesz testować. Nieznana nazwa przedmiotu wychodzi na jaw dopiero wtedy, gdy reguła się wykonuje, więc przed pierwszym testem sprawdź pisownię każdego przedmiotu.

Przetestuj go kontem, które nigdy nie dołączyło

Twoje własne konto już grało na twoim serwerze, więc nie dostanie zestawu, i to znaczy, że reguła działa. Testuj kontem Minecraft Java, które nigdy nie dołączyło do tego serwera, na przykład kontem znajomego, albo na kopii serwera z nowym światem. Przy tym pierwszym wejściu konto powinno dostać miecz, kilof, chleb i wiadomość. Rozłącz się, odczekaj chwilę i połącz ponownie: nic więcej nie powinno zostać wydane.

Gracze, którzy dołączyli, zanim zainstalowałeś regułę, nie są nowi i nie dostaną zestawu. Załadowanie reguły nie odtwarza wcześniejszych wejść.

Ograniczenia zestawu przy pierwszym wejściu

• Raz na gracza, dopóki serwer go pamięta: warunek czyta dane gracza zapisane przez samego Paper. Jeśli zaczniesz nowy świat, wszyscy znów są nowi i znów dostają zestaw. Jeśli usuniesz dane gracza, tylko ten gracz znów jest nowy i znów dostaje zestaw.
• Spełniony przez całą pierwszą sesję: warunek jest spełniony nie tylko w chwili dołączenia nowego gracza, ale aż do jego rozłączenia, nawet jeśli serwer w międzyczasie go zapisze. Trzymaj go pod Gracz dołącza; pod innym wyzwalaczem, na przykład odrodzeniem, nowy gracz mógłby dostać zestaw drugi raz w tej pierwszej sesji.
• Bez dziennego zestawu, bez czasu odnowienia, bez licznika: runtime reaguje na zdarzenia i niczego nie pamięta, więc nie może dawać zestawu „raz dziennie” ani „trzy razy na gracza”.
• Zwykłe przedmioty: akcja daje rodzaj przedmiotu i ilość. Zaklęcia i własne nazwy nie wchodzą w grę.
• Pełny ekwipunek: to, co się nie zmieści, wypada na ziemię pod nogi gracza. Ekwipunek nowego gracza jest zwykle pusty, więc rzadko ma to znaczenie.

Zmień zestaw bez ponownej instalacji runtime'u

Edytuj regułę w studiu i zapisz nową wersję. Zastąp zawartość tego samego pliku starter-kit.json nowo zapisanym JSON-em, a potem wpisz /nimblock reload. Następny nowy gracz dostanie nowy zestaw; gracze, którzy dostali już stary, nie dostaną nic więcej. Jeśli zostawisz oba pliki, stary i nowy, załadują się obie reguły i zostaną wydane dwa zestawy.

Możesz używać runtime'u na własnym zgodnym serwerze Paper bez kupowania hostingu NimBlock. Twoja reguła pozostaje czytelnym plikiem JSON, który możesz przejrzeć i trzymać razem z kopią zapasową serwera.