Notatki operatora
EssentialsX: konfiguracja, komendy i kity na serwerze Minecraft
Praktyczny przewodnik po EssentialsX: od instalacji właściwych modułów na Paper i Spigot, przez config.yml i kits.yml, po komendy /home, /spawn, /warp, /tpa, kity, ekonomię z Vault i permisje spięte z LuckPerms. Pisany przez kogoś, kto nieraz tłumaczył graczowi, dlaczego „wpisuję komendę, a serwer mówi brak uprawnień”.
W skrócie: EssentialsX to plugin dający komplet podstawowych komend, których brakuje w czystym serwerze: /home, /spawn, /warp, /tpa, prywatne wiadomości, kity startowe, ekonomię i narzędzia moderacji. Instalujesz rdzeń plus moduły, których faktycznie używasz (Chat, Spawn), wrzucasz pliki .jar do katalogu plugins i restartujesz. Ustawienia globalne trzymasz w config.yml, kity w kits.yml. EssentialsX nie nadaje uprawnień sam z siebie, więc do rozdania permisji typu essentials.home potrzebujesz LuckPerms, a do spięcia ekonomii ze sklepami przyda się Vault.
Czym jest EssentialsX i co daje
EssentialsX to najpopularniejszy zestaw komend gospodarczych dla serwerów Minecraft opartych na Bukkit, Spigot i Paper. Czysty serwer Vanilla nie ma komend takich jak /home czy /tpa; to właśnie EssentialsX je dokłada. Można powiedzieć, że to fundament, na którym stawia się prawie każdy serwer survival, skyblock czy creative. Jest następcą dawnego pluginu Essentials, który już od lat nie jest rozwijany i nie działa na nowych wersjach gry. Jeśli ktoś podsuwa Ci „Essentials”, prawie na pewno chodzi o EssentialsX.
Co konkretnie dostajesz po instalacji:
- Komendy podstawowe i teleportacja.
/home,/sethome,/spawn,/setspawn,/warp,/tpai/back. To codzienny chleb gracza i pierwsza rzecz, o którą pytają, gdy ich brakuje. - Kity. Gotowe zestawy przedmiotów, które gracz odbiera komendą
/kit. Kit startowy dla nowych, kit dzienny dla VIP-ów, kit narzędziowy dla ekipy. - Ekonomia. Wbudowana waluta z saldem gracza, komendami
/balance,/payi sklepem znakowym. Spięta z Vault obsługuje też zewnętrzne sklepy i pluginy zarobkowe. - Prywatne wiadomości.
/msg,/r(odpowiedz), ignorowanie graczy, mailboksy offline przez/mail. - Moderacja.
/kick,/ban,/tempban,/mute,/jailoraz wyciszanie czatu. Lekki zestaw, który wystarcza małym i średnim serwerom bez dedykowanego pluginu kar.
EssentialsX jest podzielony na moduły, więc nie instalujesz całego monolitu. Bierzesz rdzeń i dokładasz tylko to, czego potrzebujesz, dzięki czemu serwer nie ładuje funkcji, których i tak nie włączysz.
Instalacja
EssentialsX działa na serwerach Bukkit, czyli w praktyce na Spigot i Paper. Paper polecam mocniej, bo jest wydajniejszy i lepiej radzi sobie z większą liczbą graczy. Plugin pobierasz z oficjalnej strony projektu jako paczkę zawierającą kilka osobnych plików .jar, po jednym na moduł.
Najważniejsze moduły i to, do czego służą:
- EssentialsX to rdzeń. Daje wszystkie komendy podstawowe, kity i ekonomię. Bez niego pozostałe moduły się nie uruchomią, więc instalujesz go zawsze.
- EssentialsXChat odpowiada za formatowanie czatu: prefiksy, sufiksy i kolory. Odczytuje meta z LuckPerms, więc to on sprawia, że przed nazwą gracza pojawia się
[VIP]. - EssentialsXSpawn obsługuje spawn i miejsce pierwszego pojawienia nowego gracza. Bez niego komenda
/setspawnnie zadziała tak, jak się spodziewasz. - EssentialsXAntiBuild blokuje budowanie i niszczenie wybranym grupom, przydatne na spawnie albo w trybie lobby.
- EssentialsXGeoIP, EssentialsXProtect, EssentialsXDiscord to moduły opcjonalne, dokładasz je tylko, gdy faktycznie ich potrzebujesz.
Sama instalacja sprowadza się do trzech kroków: wrzuć wybrane pliki .jar do katalogu plugins, zrestartuj serwer i sprawdź w konsoli oraz komendą /ess version, czy wszystkie moduły wstały bez błędów. Przy pierwszym starcie EssentialsX wygeneruje sobie katalog plugins/Essentials z plikami config.yml, kits.yml i resztą konfiguracji. Na typowy serwer survival w zupełności wystarczą rdzeń, Chat i Spawn; resztę dokładaj w miarę potrzeb.
Jedna uwaga, która oszczędza nerwów: nie instaluj EssentialsX razem ze starym, nierozwijanym Essentials ani z innymi pluginami dublującymi te same komendy. Dwa pluginy walczące o /home czy /spawn dają nieprzewidywalne wyniki i błędy w konsoli przy starcie.
Konfiguracja
Po pierwszym uruchomieniu cała konfiguracja siedzi w katalogu plugins/Essentials. Najważniejsze pliki to config.yml i kits.yml.
config.yml
To główny plik ustawień. Nie musisz go przepisywać od zera; domyślne wartości są sensowne, a Ty zmieniasz tylko to, co chcesz dostosować. Rzeczy, które najczęściej rusza się na starcie:
- Limity domów. Sekcja
home-limitz domyślną liczbą i nadpisaniami per grupa, np.default: 1,vip: 5. Limit działa razem z uprawnieniami, o czym za chwilę. - Opóźnienie i koszt teleportacji.
teleport-delaywymusza odczekanie kilku sekund przed teleportem (gracz nie może uciec z walki przez/home), a w sekcji ekonomii ustawisz koszt komend. - Waluta i saldo startowe.
starting-balanceto ile pieniędzy dostaje nowy gracz, acurrency-symbolto symbol waluty wyświetlany przy kwotach. - Tryb czatu. Jeśli używasz EssentialsXChat, tu ustawiasz format wiadomości, w którym zwykle wstawiasz znaczniki prefiksu i sufiksu z LuckPerms.
Po każdej ręcznej edycji pliku przeładuj konfigurację komendą /ess reload, żeby nie restartować całego serwera. Jeśli plugin zgłosi błąd po reloadzie, najczęściej to literówka albo błędne wcięcie w YAML; tu obowiązuje ta sama zasada co wszędzie, czyli spacje zamiast tabulatorów i pilnowanie wcięć.
kits.yml
Kity definiujesz w osobnym pliku kits.yml. Każdy kit ma nazwę, czas odnowienia (delay w sekundach, gdzie -1 oznacza jednorazowy) i listę przedmiotów. Po dodaniu albo zmianie kitu wykonujesz /ess reload i kit jest od razu dostępny przez /kit nazwa. Pamiętaj, że do każdego kitu dochodzi uprawnienie essentials.kits.nazwa, które gracz musi mieć, żeby go odebrać. O tym niżej.
Warpy
Warpy to nazwane punkty teleportacji wspólne dla całego serwera, np. /warp sklep czy /warp pvp. Nie definiujesz ich ręcznie w pliku; stajesz w docelowym miejscu i wpisujesz /setwarp nazwa. EssentialsX zapisze go sam, a gracze z uprawnieniem essentials.warps.nazwa będą mogli się tam teleportować komendą /warp nazwa.
Ekonomia i Vault
EssentialsX ma ekonomię wbudowaną i może działać samodzielnie, ale w praktyce niemal zawsze dokłada się Vault. Vault to cienka warstwa pośrednia: sam nie zarządza pieniędzmi, tylko spina ekonomię EssentialsX z innymi pluginami, takimi jak sklepy, znaki kupna/sprzedaży, plugin pracy czy aukcje. Bez Vault te pluginy nie zobaczą salda gracza i będą prowadzić własną, oddzielną walutę, co kończy się chaosem. Schemat jest prosty: instalujesz EssentialsX (ekonomia), instalujesz Vault (most), a pozostałe pluginy automatycznie korzystają z jednej, wspólnej waluty.
Najważniejsze komendy i permisje
EssentialsX nie nadaje uprawnień samodzielnie. Każda komenda ma swoją permisję, a o tym, kto ją ma, decyduje plugin uprawnień, czyli najczęściej LuckPerms. W praktyce nadajesz permisje grupom: default dostaje komendy podstawowe, vip bonusy, admin resztę. Poniżej najczęściej używane komendy z odpowiadającymi im uprawnieniami.
| Komenda | Co robi | Uprawnienie |
|---|---|---|
/sethome [nazwa] | Zapisuje punkt domu. | essentials.sethome |
/home [nazwa] | Teleportuje do domu. | essentials.home |
/spawn | Teleportuje na spawn serwera. | essentials.spawn |
/setspawn | Ustawia spawn (moduł Spawn). | essentials.setspawn |
/warp <nazwa> | Teleportuje do warpa. | essentials.warps.<nazwa> |
/tpa <gracz> | Prosi gracza o teleport do niego. | essentials.tpa |
/tpaccept | Akceptuje prośbę o teleport. | essentials.tpaccept |
/back | Wraca do poprzedniej pozycji. | essentials.back |
/msg <gracz> <treść> | Wysyła prywatną wiadomość. | essentials.msg |
/kit <nazwa> | Odbiera kit. | essentials.kits.<nazwa> |
/balance | Pokazuje saldo gracza. | essentials.balance |
/pay <gracz> <kwota> | Przelewa pieniądze innemu graczowi. | essentials.pay |
/kick <gracz> | Wyrzuca gracza z serwera. | essentials.kick |
/ess reload | Przeładowuje konfigurację bez restartu. | essentials.reload |
Najwygodniej nadać te uprawnienia grupom przez LuckPerms, np. lp group default permission set essentials.home true. Limity domów spina się z permisjami typu essentials.sethome.multiple.vip w połączeniu z sekcją home-limit w config.yml. Pełną mechanikę grup, dziedziczenia i wag opisałem w osobnym poradniku LuckPerms: konfiguracja uprawnień; tu wystarczy zapamiętać, że to LuckPerms rozdaje to, co EssentialsX tylko sprawdza.
Ekonomia i kity krok po kroku
Złożmy działającą ekonomię z kitami od zera. Zakładam, że masz już EssentialsX, Vault i LuckPerms.
- Ustaw walutę. W
config.ymlustawstarting-balance(np. 100) i symbol waluty. Sprawdź w grze/balance, że nowy gracz dostaje saldo startowe. - Nadaj komendy ekonomii. Grupie
defaultdajessentials.balanceiessentials.pay, żeby gracze widzieli saldo i mogli przelewać. Sprawdź/paymiędzy dwoma kontami. - Postaw sklep znakowy (opcjonalnie). EssentialsX obsługuje znaki kupna/sprzedaży. Włącz odpowiednie znaki w
config.yml, postaw tabliczkę i nadaj graczom uprawnienie do korzystania z niej. - Zdefiniuj kit startowy. W
kits.ymldodaj kitstarterz czasem odnowienia-1(jednorazowy) i kilkoma przedmiotami. Wykonaj/ess reload. - Nadaj uprawnienie do kitu. Daj grupie
defaultpermisjęessentials.kits.starter. Bez niej gracz dostanie komunikat o braku dostępu mimo istniejącego kitu. - Dołóż kit dla VIP. Zdefiniuj kit
vipz czasem odnowienia np. 86400 sekund (raz na dobę) i nadajessentials.kits.viptylko grupievip. Tym sposobem VIP-y mają codzienną premię, a reszta nie.
Po tych krokach masz działającą gospodarkę: gracze startują z saldem, przelewają pieniądze, odbierają kity zależne od rangi, a sklepy korzystają z tej samej waluty dzięki Vault. To samo podejście rozbudowujesz później o plugin pracy czy aukcje, które również przez Vault widzą saldo z EssentialsX.
Z doświadczenia: zanim zaczniesz masowo rozdawać kity i pieniądze, zrób kopię katalogu plugins/Essentials wraz z config.yml, kits.yml i podkatalogiem userdata. To w userdata siedzą salda, domy i odebrane kity wszystkich graczy. Jeden nieostrożny /ess reload po błędnej edycji nie skasuje danych, ale uszkodzony plik gracza albo pomyłka w kitach potrafią narobić bałaganu, a backup pozwala wrócić do stanu sprzed zmian w minutę.
Typowe problemy
- Komenda zwraca brak uprawnień. EssentialsX nie nadaje permisji samodzielnie. Sprawdź
lp user gracz info, do jakich grup należy gracz, i czy grupa ma faktycznie nadane np.essentials.home. Testuj na koncie bez OP, bo status OP omija sprawdzanie uprawnień i wszystko „działa” fałszywie. - Brak uprawnień mimo nadania w grupie. Upewnij się, że nie masz dwóch pluginów uprawnień naraz i że nie ma gdzieś wpisu
set ... falsewygrywającego przez wagę grupy. Po zmianie permisji w LuckPerms zmiana działa od razu, restart nie jest potrzebny. - Konflikt z innym pluginem. Jeśli inny plugin też rejestruje
/home,/warpalbo/spawn, dochodzi do kolizji i nie wiadomo, który wygra. Sprawdź w konsoli ostrzeżenia o zdublowanych komendach. Rozwiązaniem jest aliasowanie komend wcommands.ymlserwera albo wyłączenie funkcji w jednym z pluginów. - /home nie zapisuje punktów domu. Najczęściej brak uprawnienia
essentials.sethomealbo limit domów ustawiony na zero. Sprawdź sekcjęhome-limitwconfig.ymli czy grupa ma odpowiednią permisję limitu. Zerknij też do konsoli, czy nie ma błędu zapisu danych gracza, bo brak praw do katalogu albo uszkodzony plikuserdatablokuje zapis. - Prefiks nie pokazuje się na czacie. Upewnij się, że masz moduł EssentialsXChat, a format czatu w
config.ymlzawiera znaczniki prefiksu i sufiksu odczytywane z LuckPerms. Sam EssentialsX bez modułu Chat nie sformatuje czatu.
Jeśli wolisz nie pilnować samodzielnie wersji Javy, kompatybilności pluginów i kopii zapasowych, gotowy zarządzany hosting Minecrafta (Java) z obsługą pluginów pozwala wgrać EssentialsX, Vault i LuckPerms przez panel i menedżer plików, bez stawiania serwera od zera.
Najczęstsze pytania
Czym EssentialsX różni się od starego Essentials?
EssentialsX to utrzymywany następca dawnego Essentials, który nie jest już rozwijany i nie działa na nowych wersjach gry. EssentialsX dostaje aktualizacje, jest podzielony na moduły i działa na Paper oraz Spigot. Pliki konfiguracyjne są w dużej mierze zgodne, więc migracja ze starego Essentials przenosi większość ustawień bez zmian.
Czy do ekonomii potrzebuję osobnego pluginu?
EssentialsX ma ekonomię wbudowaną, ale do spięcia jej ze sklepami i innymi pluginami dokładasz Vault. Vault to most, który sam nie zarządza pieniędzmi, tylko pozwala pozostałym pluginom widzieć saldo z EssentialsX. Bez niego każdy plugin prowadziłby własną walutę.
Gracz dostaje brak uprawnień. Co sprawdzić?
Permisje rozdaje plugin uprawnień, najczęściej LuckPerms, a nie EssentialsX. Sprawdź lp user gracz info oraz czy grupa ma nadane konkretne uprawnienie, np. essentials.tpa. Testuj na koncie bez OP, bo operator omija sprawdzanie permisji.
Dlaczego /home nie zapisuje domów?
Zwykle brak essentials.sethome albo limit domów równy zero w config.yml. Limity działają razem z uprawnieniami w sekcji home-limit. Sprawdź też konsolę pod kątem błędu zapisu danych gracza w katalogu userdata.
Które moduły są mi potrzebne?
Zawsze rdzeń EssentialsX. Do tego EssentialsXChat (formatowanie czatu z prefiksami z LuckPerms) i EssentialsXSpawn (spawn). Pozostałe moduły dokładasz tylko, gdy faktycznie ich używasz. Na typowy survival wystarczą rdzeń, Chat i Spawn.