Komendy admina Palworld: RCON, REST API i automatyzacja serwera

Kto prowadzi serwer Palworld, szybko zauważa, że prawdziwa praca zaczyna się po instalacji: moderowanie graczy, zapisywanie świata na czas i planowanie restartów tak, żeby pół społeczności nie wyleciało z gry w środku walki z bossem. Palworld daje ci do tego trzy narzędzia: komendy administratora w grze, stary protokół RCON i REST API. Wokół tych dwóch ostatnich panuje w sieci spore zamieszanie, bo spora część poradników wciąż poleca RCON — podczas gdy oficjalna dokumentacja serwera uznała już RCON za przestarzały (deprecated) i zapowiada, że w jednej z przyszłych aktualizacji przestanie on działać. W tym poradniku porządkujemy aktualny stan rzeczy, sprawdzony pod kątem składni 1.0.

Najpierw: ustaw hasło administratora

Wszystko zaczyna się od hasła administratora. Otwórz PalWorldSettings.ini na swoim serwerze i wpisz przy AdminPassword silne hasło:

AdminPassword="kies-iets-sterks"

Zrestartuj serwer, żeby zmiana się załadowała. Następnie otwórz czat w grze i zaloguj się jako administrator:

/AdminPassword kies-iets-sterks

Od tego momentu serwer akceptuje twoje komendy administratora. Potraktuj to hasło poważnie: to samo hasło będzie za chwilę także twoim dostępem do REST API, a każdy, kto je zna, może położyć twój serwer. Twój serwer działa jeszcze na starszej wersji? W naszej bazie wiedzy przeczytasz, jak zaktualizować serwer Palworld do 1.0.

Wszystkie komendy w grze w jednym miejscu (1.0)

To pełny oficjalny zestaw komend. Wpisujesz je na czacie w grze po zalogowaniu się komendą /AdminPassword:

Steam ID potrzebne do kickowania, banowania i teleportacji pobierzesz komendą /ShowPlayers. Dwie praktyczne wskazówki: wiadomości ze spacjami nie zawsze dochodzą poprawnie, więc w razie potrzeby użyj podkreślników (/Broadcast Herstart_over_5_minuten). A /DoExit zostaw na sytuacje awaryjne; przy normalnym zatrzymaniu /Shutdown z porządnym odliczaniem to zawsze lepszy wybór.

Dlaczego nie ma /give?

Najczęściej googlowane pytanie nowych adminów: jak oddać graczowi przedmioty po crashu albo jak zespawnować Pala? Szczera odpowiedź: nie da się. Palworld na serwerach dedykowanych nie ma /give, komend spawnowania ani żadnego sposobu na rozdawanie XP czy przedmiotów. Oficjalny zestaw komend to czyste narzędzie do zarządzania serwerem — moderowanie, zapisywanie, wyłączanie — a nie konsola cheatów znana z niektórych innych gier survivalowych.

Jeśli mimo to chcesz pokręcić gałkami, masz dwie drogi. Ustawienia świata, takie jak drop rate'y i mnożniki XP, zmienisz w PalWorldSettings.ini; w ten sposób sterujesz całą ekonomią serwera. A do prawdziwego spawnowania przedmiotów istnieją mody, które jednak niosą ze sobą własne utrzymanie i ryzyko crashy. Nie obiecuj więc graczom rekompensaty w przedmiotach po wypadku: środkami, które daje ci gra, po prostu się nie da. Dobry harmonogram backupów zapobiegnie większej frustracji, niż komenda give kiedykolwiek by to zrobiła.

RCON jest oficjalnie przestarzały

RCON to klasyczny protokół zdalnej konsoli, który możesz znać z innych serwerów gier. Palworld wciąż go obsługuje (domyślnie na porcie 25575, włączany przez RCONEnabled=True), ale oficjalna dokumentacja serwera mówi wprost: RCON jest przestarzały, używaj REST API, a RCON ma w jednej z nadchodzących aktualizacji całkowicie przestać działać.

Do tego dochodzi fakt, że implementacja RCON w Palworld nigdy nie została w pełni dokończona. Zawiera znany błąd, przez który nazwy graczy ze znakami wielobajtowymi (na przykład japońskie czy chińskie) docierają zniekształcone, co czyni moderowanie po nazwie zawodnym. Rada jest więc prosta: nie buduj niczego nowego na RCON, a jeśli masz istniejące skrypty lub narzędzia, które na nim polegają, przenieś je na REST API, zanim jakaś aktualizacja je zepsuje. Jeśli trafisz w sieci na poradnik, który każe ci szczegółowo konfigurować RCON, spójrz na datę publikacji — spora szansa, że powstał przed pojawieniem się REST API.

REST API: nowy standard

REST API to oficjalna droga do zarządzania serwerem spoza gry. Włączasz je w PalWorldSettings.ini:

RESTAPIEnabled=True
RESTAPIPort=8212

Po restarcie API nasłuchuje na porcie 8212 i używa uwierzytelniania HTTP Basic: nazwa użytkownika admin, hasło to twoje AdminPassword. Wszystkie endpointy znajdują się pod /v1/api/. Pierwszy test z samego serwera:

curl -u admin:kies-iets-sterks http://localhost:8212/v1/api/info

W odpowiedzi dostajesz JSON, między innymi z wersją i nazwą serwera. API potrafi wszystko to, co komendy w grze — announce (broadcast), kick, ban, unban, save i shutdown — ale ma dodatkowo trzy funkcje, które istnieją tylko przez API:

• /v1/api/settings — pobranie aktywnych ustawień serwera;
• /v1/api/metrics — dane serwera na żywo, takie jak framerate, uptime i liczba graczy;
• world actor snapshot — migawka obiektów w świecie, ciekawa głównie dla zewnętrznych narzędzi.

Szczególnie metrics jest na wagę złota: dzięki niemu monitorujesz zdrowie serwera bez logowania się do gry. Spadający framerate serwera to na przykład pierwszy sygnał, że znany wyciek pamięci znowu daje o sobie znać.

Automatyzacja: zapisy i planowane restarty

Wielka zaleta API po HTTP: wszystko, co potrafi wywołać curl, może zarządzać twoim serwerem. Dwa przykłady, których chce praktycznie każdy administrator. Najpierw automatyczne zapisy, tutaj co 30 minut przez crona:

*/30 * * * * curl -s -u admin:kies-iets-sterks -X POST http://127.0.0.1:8212/v1/api/save

I porządny restart: najpierw ostrzeżenie, potem wyłączenie z odliczaniem. Twój menedżer procesów (albo panel hostingowy) potem automatycznie uruchomi serwer ponownie:

curl -u admin:kies-iets-sterks -X POST http://127.0.0.1:8212/v1/api/announce \
  -H "Content-Type: application/json" \
  -d '{"message": "Server herstart over 5 minuten"}'

curl -u admin:kies-iets-sterks -X POST http://127.0.0.1:8212/v1/api/shutdown \
  -H "Content-Type: application/json" \
  -d '{"waittime": 300, "message": "Herstart over 5 minuten"}'

Zwróć uwagę, że wiadomości przez API normalnie radzą sobie ze spacjami. Na koniec jedna ważna uwaga: nigdy nie wystawiaj portu 8212 do internetu. API mówi zwykłym HTTP, a twoje hasło administratora podróżuje z każdym żądaniem; sama dokumentacja pisze, że API nie jest przeznaczone do publicznego dostępu. Trzymaj je na localhost albo wewnątrz własnej sieci i osłoń firewallem.

Tak to działa w panelu MC-Node

Jeśli twój serwer działa w MC-Node, do codziennego zarządzania nie musisz samodzielnie kombinować z cronem i curlem. W panelu edytujesz PalWorldSettings.ini przez menedżer plików (wpisujesz hasło administratora, włączasz REST API), śledzisz logi na żywo i uruchamiasz, zatrzymujesz lub restartujesz serwer jednym kliknięciem. Planowane restarty i automatyczne backupy ustawisz w panelu — a właśnie przy Palworld, z jego osławionym zużyciem pamięci przy długich uptime'ach, chcesz mieć te restarty włączone od pierwszego dnia. API pozostaje przy tym normalnie dostępne dla każdego, kto chce automatyzować dalej albo monitorować z zewnątrz.

Nie masz jeszcze własnego serwera? W sklepie Palworld MC-Node zaczynasz od € 6,00 miesięcznie, na własnym sprzęcie z dyskami NVMe w centrum danych Previder w Hengelo, z ochroną DDoS w cenie i możliwością rezygnacji co miesiąc.

Czytaj dalej

• Hosting serwera Palworld: dlaczego warto planować restarty
• PalWorldSettings.ini: ustawienia, które naprawdę mają znaczenie
• Wyciek pamięci w Palworld: dlaczego twój serwer robi się coraz wolniejszy
• Awakening i Radiant Gems: tak działa nowy endgame Palworld
• Najlepsze miejsca na bazę w Palworld 1.0 — według surowców i stylu gry