Dokumentacja StaffKit

StaffKit to zestaw dla administracji serwerów Minecraft: launcher, klient (mod do gry) i plugin serwera, które działają razem. Tu znajdziesz wszystko — od instalacji po uprawnienia, konfigurację i API dla twórców.

Wersja Alpha. StaffKit szybko się rozwija — niektóre ekrany mogą wyglądać trochę inaczej niż na zrzutach. Coś jest nieaktualne? Zgłoś to w launcherze: żarówka u góry → Zgłoś pomysł.

Z czego składa się StaffKit

Część	Dla kogo	Co robi
Launcher	każdy gracz i admin	Uruchamia Minecraft 26.3 z klientem StaffKit, konta Microsoft, mody, znajomi i czat, skiny, zrzuty, panel serwera (mapa, czat, zgłoszenia, konsola, pliki) i Workshop.
Klient StaffKit (mod Fabric)	gracze z launcherem	Nowy wygląd gry (menu, HUD, ekwipunek, czat) i narzędzia admina: panel graczy, zgłoszenia, X-ray, freecam, WorldEdit w oknie, regiony WorldGuard, minimapa i więcej.
Plugin StaffKit (Paper)	właściciele serwerów	Uprawnienia do narzędzi admina, kary, zgłoszenia, czat administracji, dziennik działań, harmonogram restartów, połączenie z launcherem przez StaffKit Network.
StaffKit Network	działa w tle	Łączy launchery i serwery bez otwierania portów: znajomi, wiadomości, panel serwera w launcherze, lista serwerów i rekrutacje na staffkit.pl.

Klient działa na każdym serwerze — także bez pluginu (wygląd, minimapa, mapa, WorldEdit w oknie, edytor tabliczek). Narzędzia administracji (panel graczy, X-ray, freecam, regiony itd.) potrzebują pluginu StaffKit na serwerze i odpowiednich uprawnień — dzięki temu gracz bez rangi nie użyje ich na Twoim serwerze.

Od czego zacząć

Zainstaluj launcherWindows i macOS, logowanie kontem Microsoft, pierwsze uruchomienie. Dodaj plugin na serwerPaper 26.3, pierwsze uruchomienie i nadanie uprawnień administracji. Poznaj klawiszePrawy Shift, H, B, N, K, V, P, M… — wszystkie skróty w jednym miejscu. Zarządzaj serwerem z launcheraMapa na żywo, czat, zgłoszenia, konsola i pliki bez wchodzenia do gry. Uprawnienia i komendyPełna lista z opisem — gotowa do LuckPerms. Twórz dodatkiAPI pluginu: własny HUD, okna i powiadomienia w kliencie StaffKit.

Wymagania

Gra: Minecraft: Java Edition w wersji 26.3 (klient StaffKit jest na razie tylko dla tej wersji). Launcher sam pobiera grę, Fabric i Javę.
Komputer: Windows 10/11 albo macOS 11+ (Intel i Apple Silicon).
Serwer: Paper 26.3 (albo zgodny fork). LuckPerms zalecany do nadawania uprawnień.
Konto: konto Microsoft z Minecraftem. Konta offline działają tylko na serwerach non-premium i nie mogą zarządzać serwerami z launchera, chyba że właściciel na to pozwoli.

Pomoc i pomysły

Pomysły i błędy zgłaszasz w launcherze (żarówka → Zgłoś pomysł) — trafiają na listę z głosowaniem w zakładce Pomysły. Odpowiedzi na częste problemy są w Pytaniach i problemach.