Instalacja i pierwsze uruchomienie

Instalacja

1. Zatrzymaj serwer.
2. Wrzuć AdminControl.jar do folderu plugins/.
3. Uruchom serwer. Przy pierwszym starcie tej wersji serwer pobiera z Maven Central bibliotekę tekstu, której używa AdminControl (Adventure), do swojego folderu libraries/, więc potrzebuje wtedy dostępu do internetu; Paper, Purpur i Folia dalej używają własnej kopii, Spigot korzysta z pobranej. AdminControl tworzy plugins/AdminControl/ z plikami config.yml, messages_en.yml, messages_pl.yml, a przy domyślnej bazie SQLite także data.db.

Panel domyślnie nasłuchuje na porcie 8080 wszystkich adresów (web.host, web.port w config.yml). Na panelu hostingu użyj portu, który daje ci hosting.

Zwykłe HTTP nie jest szyfrowane. Otwarty bezpośrednio na swoim porcie panel mówi zwykłym HTTP: każdy w tej samej sieci (publiczne Wi-Fi, wspólny hosting) może odczytać twoje hasło i przejąć zalogowaną sesję. Zanim użyjesz panelu spoza swojego komputera, schowaj go za HTTPS (Panel przez HTTPS albo tunel, np. Cloudflare Tunnel). Jeśli nie możesz, przynajmniej ogranicz go do swoich adresów białą listą IP i nigdy nie loguj się przez publiczne Wi-Fi.

Utworzenie konta Ownera

Dopóki nie ma konta Ownera, konsola pokazuje link ważny 30 minut:

<public-url or http://host:port><base-path>setup/<token>

1. Otwórz go w przeglądarce.
2. Wybierz nazwę użytkownika i hasło (co najmniej 10 znaków, nie popularne hasło).
3. Zeskanuj kod QR aplikacją uwierzytelniającą (Google Authenticator, Authy, 2FAS, ...) i wpisz jej kod.
4. Panel raz pokazuje 10 kodów zapasowych. Schowaj je w bezpiecznym miejscu: każdy loguje cię jeden raz bez aplikacji.

Po restarcie bez Ownera konsola pokazuje nowy link; stary przestaje działać.

Utracony dostęp

• Zgubiona aplikacja uwierzytelniająca, kody zapasowe są: zaloguj się kodem zapasowym, a potem ustaw aplikację ponownie w Ustawienia → Moje konto.
• Zgubione jedno i drugie: wpisz /ac resetowner w konsoli serwera (nie w grze, nie z konsoli panelu, nie przez RCON). Pokaże nowy link konfiguracji. Obecne konta Ownera wyłączają się dopiero wtedy, gdy nowe konto skończy konfigurację 2FA.
• Zablokowany przez białą listę IP: wpisz /ac whitelist off w konsoli serwera.

Na Folii

Wszystko działa jak na Paperze. Dwie rzeczy różnią się, bo Folia obsługuje każdy region świata na osobnym wątku:

• TPS na pulpicie: kafelek TPS pokazuje najsłabszy region, w którym jest gracz (gdy nikogo nie ma: region globalny), i pisze to pod liczbą. MSPT pokazuje „–”: Folia nie podaje go dla regionów.
• Konsola panelu: komendy wykonują się w globalnym regionie Folii. Komendy vanilla działające na byty w innej części świata mogą zostać odrzucone przez samą Folię.

Na Spigocie

Wszystko działa jak na Paperze, z tymi różnicami:

• Pierwszy start: Spigot nie ma Adventure, biblioteki tekstu używanej przez AdminControl, więc przy pierwszym starcie serwer pobiera ją z Maven Central do folderu libraries/ (lista libraries pluginu). Serwer potrzebuje wtedy dostępu do internetu; bez niego AdminControl się nie ładuje (zobacz Rozwiązywanie problemów). Paper, Purpur i Folia pobierają te same pliki, ale dalej używają własnego Adventure.
• Pulpit: TPS pochodzi z własnego licznika ticków AdminControl (ostatnia minuta). MSPT pokazuje „–”: Spigot nie podaje, jak długo trwa tick.
• Za Velocity: Spigot nie ma nowoczesnego przekazywania (modern forwarding). Użyj bungeecord: true w spigot.yml, trybu przekazywania bungeeguard w Velocity i BungeeGuard na serwerze (zobacz Sieć Velocity).

Folder libraries/ skopiowany z innego serwera jest uznawany za zaufany taki, jaki jest. Zanim uruchomisz z nim serwer, sprawdź każdy plik z tabeli z tymi sumami SHA-256 (to te same pliki co na Maven Central):

Za proxy Velocity

Wrzuć ten sam jar także na proxy i daj wszystkim jedną bazę MySQL lub MariaDB: zobacz Sieć Velocity. Za BungeeCord lub Waterfall: zobacz Sieć BungeeCord.

Aktualizacja

Zatrzymaj serwer, podmień jar, uruchom serwer. Baza aktualizuje się przy starcie; ustawienia i dane zostają. Po aktualizacji, która dodaje bibliotekę, pierwszy start pobiera ją z Maven Central (zobacz „Instalacja” wyżej). Przed dużymi aktualizacjami zrób kopię plugins/AdminControl/.