EssentialsX: kompletny przewodnik po konfiguracji serwera Minecraft 2026

Jeśli stawiasz Paper albo Spigot i chcesz, żeby /home, /sethome, /spawn, warpy, prywatne wiadomości i ekonomia po prostu działały, to bez EssentialsX się nie obejdzie. To podstawowy plugin pokrywający około 80% potrzeb typowego serwera survival lub mini-gier. Przejdźmy przez instalację, moduły, konfigurację, uprawnienia i te miejsca, w których admini regularnie psują ekonomię albo łapią laga.

Czym jest EssentialsX i dlaczego właśnie on

EssentialsX to aktywny fork starego Essentials, który został porzucony w 2014 roku. Cały rozwój od tego czasu odbywa się w organizacji EssentialsX na GitHubie, a plugin nadal jest najczęściej pobieranym na SpigotMC z ponad 50 milionami pobrań.

Wspiera Paper, Spigot, Purpur i częściowo Folia. Na Folii działają tylko Core i Spawn w osobnym branchu EssentialsXSpigotFolia, reszta modułów nie została jeszcze przeportowana ze względu na regionalny model ticków Folii. Wersje Minecrafta od 1.8 do 1.21, branch dla 1.21 jest stabilny od release 2.21.0.

Alternatywy są: CMI (płatny, monolityczny), HuskHomes, ChestCommands. Ale jeśli chcesz "postawić i zapomnieć", EssentialsX wygrywa stosunkiem funkcji do zera złotych.

Moduły: co ściągać z GitHub releases

EssentialsX jest podzielony na kilka jarów. Bazę pobierasz obowiązkowo, resztę według potrzeb:

• EssentialsX.jar - rdzeń. Domy, warpy, teleporty, kity, prywatne wiadomości, podstawowa ekonomia
• EssentialsXChat.jar - formatowanie czatu, kanały, czat lokalny
• EssentialsXSpawn.jar - własny punkt spawnu, respawn na spawnie dla nowych
• EssentialsXAntiBuild.jar - prosta ochrona bloków przez uprawnienia
• EssentialsXProtect.jar - ochrona przed creeperami, ogniem, rozlewaniem wody
• EssentialsXGeoIP.jar - wykrywanie kraju gracza po IP, wymaga bazy MaxMind
• EssentialsXXMPP.jar - rzadko używany moduł, powiadomienia w Jabberze
• EssentialsXDiscord.jar - dwukierunkowy most czatu z Discordem
• EssentialsXDiscordLink.jar - linkowanie kont i synchronizacja ról z LuckPerms

W praktyce większość serwerów stawia Core, Chat, Spawn i Discord. Reszta jest albo zbędna, albo zastępowana przez wyspecjalizowane pluginy (WorldGuard zamiast Protect, DiscordSRV zamiast EssentialsXDiscord jeśli potrzebujesz embedów).

Pobieraj tylko z oficjalnej strony releases na GitHubie. Lewe buildy z YouTube'a często zawierają zaobfuskowane backdoory.

Instalacja i zależności

Wrzucasz potrzebne jary do plugins/, restartujesz serwer. EssentialsX sam stworzy folder plugins/Essentials/ z config.yml, kits.yml, worth.yml i kilkoma innymi plikami.

Zależności:

• Vault - potrzebny jeśli planujesz używać ekonomii z innymi pluginami (Shop, ChestShop, AuctionHouse). Bez Vault EssentialsX Economy działa w izolacji
• LuckPerms - nie jest obowiązkowy, ale bez systemu uprawnień nie ogarniesz grup i limitów domów. SuperPerms z pudełka obsługuje tylko podstawowe flagi operatora
• PlaceholderAPI - potrzebny do rozszerzonego formatowania czatu przez placeholdery %essentials_*%

Kolejność ładowania jest poprawna od początku, EssentialsX deklaruje softdepend: [Vault, LuckPerms, PlaceholderAPI] w swoim plugin.yml.

Komendy dla graczy

Te node'y trafiają do grupy default i są używane codziennie:

/sethome [name]      # ustawia dom, domyślny limit to 1
/home [name]         # teleport do domu
/delhome <name>      # usuń dom
/spawn               # na spawn świata
/warp [name]         # do warpa jeśli masz uprawnienia
/tpa <player>        # prośba o teleport do gracza
/tpaccept            # akceptuj prośbę
/tpdeny              # odrzuć
/back                # wróć do miejsca śmierci lub ostatniego tp
/msg <player> <msg>  # prywatna wiadomość
/r <message>         # odpowiedź na ostatnie pw
/mail send <p> <m>   # wiadomość offline
/balance             # saldo
/pay <player> <sum>  # przelew pieniędzy
/afk                 # oznacz siebie jako AFK

/back po śmierci to kwestia smaku. Na anarchii zwykle się go wyłącza odbierając essentials.back.ondeath, żeby PvP miało sens.

Komendy moderatora i admina

Minimum do moderacji:

/vanish              # niewidoczność dla graczy
/tempban <p> <time>  # bana czasowy, np. 7d lub 2h
/mute <p> <time>     # mute z timerem
/jail <p> <jail>     # wyślij do jaila
/kick <p> [reason]   # kick
/broadcast <msg>     # wiadomość do wszystkich
/feed                # nakarm
/heal                # ulecz
/gamemode <mode>     # zmień tryb gry
/invsee <player>     # zobacz inwentarz
/seen <player>       # ostatnie logowanie

Jail tworzysz komendą /setjail <name> stojąc w docelowym miejscu. Gracz w jailu nie może niszczyć bloków, pisać na czacie (zależy od jail-mute-on-jail) i używać komend.

config.yml: kluczowe parametry

plugins/Essentials/config.yml to serce pluginu. Parametry, które warto przejrzeć:

# Limity domów per grupa
sethome-multiple:
  default: 1
  vip: 3
  vip+: 5
  staff: 10

# Cooldown między teleportami w sekundach
teleport-cooldown: 60

# Opóźnienie przed teleportem, ruch anuluje
teleport-delay: 3

# Bezpieczny teleport: sprawdza blok pod nogami
teleport-safety: true
force-disable-teleport-safety: false

# Ekonomia
currency-symbol: '$'
starting-balance: 100
min-money: 0
max-money: 10000000000

# AFK
auto-afk: 300        # 5 min do auto-AFK
auto-afk-kick: 1800  # kick po 30 min AFK

# Social spy: staff widzi prywatne wiadomości
social-spy:
  available-on-vanish: true

Częsta pułapka: sethome-multiple działa tylko jeśli gracz ma node essentials.sethome.multiple.<group>. Sama zmiana liczby w configu nie wystarczy.

Ekonomia: Vault, /shop, tabliczki

EssentialsX Economy to przechowywanie sald w pamięci z backupem do plików. Dla serwera do 200 graczy online to spoko, dla większych warto patrzeć na CoinsEngine albo zmostkować EssentialsX na MySQL przez zewnętrzny adapter.

Żeby sklepy działały, instalujesz Vault i EssentialsX automatycznie zarejestruje się jako Economy provider. Sprawdzenie przez /vault-info.

EssentialsX ma natywne sklepy na tabliczkach. Tworzysz tabliczkę:

[Buy]
1
64
100

To znaczy "kup 1 stack (64 sztuki) wskazanego materiału za 100 monet". Pełna lista typów tabliczek w sekcji signs::

enabled-signs:
  - balance
  - buy
  - sell
  - free
  - disposal
  - heal
  - mail
  - trade
  - warp

Do prawdziwego sklepu z GUI lepiej wziąć ChestShop albo DeluxeMenus, tabliczki to bardziej nostalgia.

Kity: kits.yml

Plik plugins/Essentials/kits.yml przechowuje paczki przedmiotów. Przykład kitu dla nowego gracza:

kits:
  starter:
    delay: -1
    items:
      - bread 16
      - wooden_sword
      - wooden_pickaxe
      - wooden_axe
      - leather_helmet
      - leather_chestplate
      - leather_leggings
      - leather_boots
      - torch 32
  daily:
    delay: 86400
    items:
      - cooked_beef 32
      - iron_pickaxe unbreaking:1
      - golden_apple 4

delay: -1 znaczy "dawaj raz na zawsze", 86400 znaczy "raz dziennie w sekundach". Gracz odbiera kit komendą /kit starter, uprawnienie to essentials.kits.starter.

Dla zaklęć używasz składni material enchantment:level, np. diamond_sword sharpness:5 unbreaking:3. Pełna lista nazw zaklęć jest w API Bukkit.

Spawn i warpy

Ustawienie spawnu:

/setspawn          # domyślny dla wszystkich grup
/setspawn default  # jawnie dla grupy default

Można skonfigurować różne spawny dla różnych grup przez respawn-listener-priority i grupy uprawnień. Świat tutorialowy dla nowych zwykle robi się w osobnym wymiarze.

Warpy:

/setwarp shop      # utwórz
/warp shop         # teleport
/delwarp shop      # usuń
/warps             # lista dostępnych warpów

Każdy warp wymaga uprawnienia essentials.warp.warps.<name> lub ogólnego essentials.warp.*. Jeśli masz 50 warpów i nie chcesz dawać każdego osobno, dajesz wszystkim essentials.warps.*.

AntiBuild i Protect: kiedy ich nie używać

EssentialsX AntiBuild to prosta ochrona bloków po uprawnieniach. Działa, ale jest sztywna: nie da się pozwolić na budowanie tylko w jednym regionie. Do poważnej ochrony spawnu instalujesz WorldGuard i AntiBuild zostawiasz wyłączony.

EssentialsX Protect zajmuje się creeperami i fizyką. Też podstawa. Jeśli prowadzisz survival ze strefami PvE, znowu lepszy jest WorldGuard z flagami creeper-explosion deny.

Zasada: używaj Core + Spawn + Chat + Economy, inne moduły włączaj tylko jak wiesz że ich potrzebujesz.

Czat i PlaceholderAPI

EssentialsXChat wspiera formatowanie przez chatformat w configu. Przykład z grupami:

chat:
  format: '{DISPLAYNAME}&7: &f{MESSAGE}'
  group-formats:
    default: '&7[Gracz] {DISPLAYNAME}&7: &f{MESSAGE}'
    vip: '&6[VIP] {DISPLAYNAME}&7: &f{MESSAGE}'
    staff: '&c[Staff] {DISPLAYNAME}&7: &f{MESSAGE}'
  radius: 0

radius: 0 to czat globalny, każda liczba większa od 0 robi czat lokalny w tym promieniu bloków.

Z PlaceholderAPI można wbić prefix z LuckPerms wprost:

format: '%luckperms_prefix% {DISPLAYNAME}&7: &f{MESSAGE}'

Nie zapomnij włączyć parsowania PlaceholderAPI w EssentialsXChat, inaczej placeholdery przelatują jako surowy tekst.

Wydajność na dużych serwerach

Na serwerze z 500+ graczami online EssentialsX może stać się wąskim gardłem. Co wyłączyć:

• GeoIP - ładuje bazę do pamięci i robi lookup przy każdym joinie. Jeśli nie pokazujesz kraju w czacie, wyłącz
• Magazyn /seen - last-seen jest zapisywane do userdata przy każdym disconnect. Na dużych serwerach ustaw last-seen-write: false
• AFK auto-kick - przelatuje po wszystkich graczach co tick. Postaw auto-afk-kick: -1 jeśli kick nie jest potrzebny
• Timery zależne od TPS - EssentialsX ma okresowe taski zapisu userdata. Ustaw userdata-saving-interval między 60 a 300 sekund

Userdata leży w plugins/Essentials/userdata/ jako jeden plik .yml na gracza. Na dużych serwerach to dziesiątki tysięcy plików, a /baltop albo /seen skanuje całe drzewo. Rozwiązanie: przenieść na MySQL przez zewnętrzny most albo regularnie czyścić stare userdata skryptem.

Uprawnienia przez LuckPerms

Minimalny zestaw dla grupy default:

lp group default permission set essentials.home true
lp group default permission set essentials.sethome true
lp group default permission set essentials.sethome.multiple.default true
lp group default permission set essentials.delhome true
lp group default permission set essentials.spawn true
lp group default permission set essentials.warp true
lp group default permission set essentials.tpa true
lp group default permission set essentials.tpaccept true
lp group default permission set essentials.tpdeny true
lp group default permission set essentials.msg true
lp group default permission set essentials.mail true
lp group default permission set essentials.balance true
lp group default permission set essentials.pay true
lp group default permission set essentials.kits.starter true
lp group default permission set essentials.afk true
lp group default permission set essentials.back true

Dla VIP dodajesz essentials.sethome.multiple.vip i w configu wpisujesz ile domów ma mieć. Dla moderatorów essentials.vanish, essentials.kick, essentials.mute, essentials.tempban, essentials.broadcast, essentials.invsee, essentials.seen.

Niebezpieczne node'y, których NIGDY nie dajesz zwykłym graczom: essentials.god, essentials.fly, essentials.gamemode, essentials.give, essentials.eco (to ostatnie steruje ekonomią serwera).

FAQ

Czy EssentialsX działa na Folii?

Częściowo. Jest osobny branch EssentialsXSpigotFolia z Core i Spawn. Większość pozostałych modułów nie została przeportowana na regionalny model ticków Folii. Jeśli wybierasz Folię, musisz liczyć się z zastąpieniem części funkcji EssentialsX.

Jak sprawić, żeby /home działało tylko w overworld?

Przez uprawnienia i Multiverse. Dajesz essentials.home.bed tylko w docelowym świecie przez konteksty LuckPerms: lp group default permission set essentials.home true world=world. W innych światach komenda nie zadziała. Alternatywa: parametr world-teleport-permissions: true w configu.

Po co mi Vault skoro EssentialsX już ma ekonomię?

Vault to most API między pluginami. Sama EssentialsX Economy działa tylko wewnątrz komend EssentialsX (/balance, /pay). Wszystkie zewnętrzne sklepy, aukcje, pluginy z zakupami chodzą przez Vault API. Bez Vault nie zobaczą sald EssentialsX.

Czy mogę zwiększyć liczbę domów powyżej 3?

Tak, przez essentials.sethome.multiple.<group> i sekcję sethome-multiple w configu. Tworzysz grupę np. vip+ z 10 domami w configu i dajesz node przez LuckPerms. Twardych limitów technicznych nie ma, ogranicza tylko wydajność systemu plików.

Jak chronić /spawn przed griefem?

Przez WorldGuard, nie przez AntiBuild. Tworzysz region wokół spawnu komendą //wand plus /region define spawn, potem /region flag spawn build deny i /region flag spawn pvp deny. AntiBuild od EssentialsX jest zbyt prymitywny do częściowych wyjątków.

Jak zresetować domy wszystkich graczy?

Bezpośredniej drogi nie ma, ale można usunąć sekcję homes: w każdym pliku userdata przez skrypt, albo zresetować konkretnego gracza komendą /delhome <player>:<name> z konsoli. Na dużych serwerach prościej napisać skrypt bash z yq lub sed po plugins/Essentials/userdata/.

Czy EssentialsX kłóci się z innymi pluginami od domów i warpów?

Tak, jeśli stoi też HuskHomes albo CMI. Komendy /home, /warp, /tpa będą się nakładać i Bukkit odda komendę temu pluginowi, który zarejestrował ją pierwszy. Rozwiązanie: usunąć duplikaty w commands.yml lub wyłączyć zbędny moduł przez disabled-commands w configu EssentialsX.

Co dalej

EssentialsX zamyka podstawy, nic więcej. Do poważnego serwera od początku planuj stack: WorldGuard do regionów, LuckPerms do uprawnień, PlaceholderAPI do integracji, plus coś do inwentarzy z GUI (ChestShop albo DeluxeMenus). Configi trzymaj w git, backupy userdata rób raz dziennie, i nie zapomnij osłonić serwera przed DDoS - jeden SYN flood i twoja pięknie nastrojona konfiguracja zostanie bez graczy.