Discord
Wiki - Pluginy

EssentialsX - najważniejszy plugin serwerowy

EssentialsX to plugin numer jeden na serwerach Minecraft. Ponad 140 komend, system ekonomii, teleportacja, moderacja, kity i warpy - wszystko w jednym pakiecie. Obsluguje wersje od 1.8.8 do 1.21.x i działa na Spigot, Paper oraz Purpur.

Czas czytania: ~5 min Platforma: Paper / Spigot / Purpur

Co to jest EssentialsX

EssentialsX to darmowy, open-source plugin, który dostarcza podstawowy zestaw komend i funkcji niezbednych na każdym serwerze Minecraft. Jest kontynuacja legendarnego pluginu Essentials, rozwijana od 2014 roku przez niezalezny zespół po tym, jak oryginalny projekt został porzucony.

Plugin jest instalowany na szacunkowo 80-90% wszystkich publicznych serwerow Minecraft. Zastepuje kilkanascie mniejszych pluginow jednym pakietem: teleportacja, domy graczy, warpy, kity, wiadomosci prywatne, moderacja (mute, ban, kick, jail), spawn, ekonomia i wiele więcej. Dzięki temu admin nie musi szukac osobnych pluginow do każdej z tych funkcji i martwic sie o ich kompatybilność.

EssentialsX jest dostępny na oficjalnej stronie, SpigotMC oraz Modrinth. Kod źródłowy znajduje sie na GitHub.

Najważniejsze komendy

EssentialsX dodaje ponad 140 komend. Oto te, z których gracze korzystaja najczęściej:

Komenda Co robi Uprawnienie
/sethome [nazwa] Ustawia dom w obecnej lokalizacji essentials.sethome
/home [nazwa] Teleportuje do zapisanego domu essentials.home
/tpa Gracz Wysyla prosbe o teleportacje do gracza essentials.tpa
/tpaccept Akceptuje prosbe o teleportacje essentials.tpaccept
/spawn Teleportuje na spawn serwera essentials.spawn
/warp [nazwa] Teleportuje do warpu (admin tworzy przez /setwarp) essentials.warp
/kit [nazwa] Odbiera zestaw przedmiotow (np. starter kit) essentials.kit
/msg Gracz tekst Wysyla prywatna wiadomosc essentials.msg
/back Wraca do poprzedniej lokalizacji (np. po śmierci) essentials.back
/balance Sprawdza saldo w portfelu essentials.balance

Komendy administracyjne obejmuja: /ban, /mute, /kick, /jail, /vanish, /god, /fly, /gamemode, /tp, /weather, /time i wiele innych. Każda komenda ma oddzielne uprawnienie, które kontrolujesz przez LuckPerms.

System ekonomii

EssentialsX zawiera wbudowany silnik ekonomii kompatybilny z Vault. Obsluguje salda graczy, przelewy między nimi i ranking najbogatszych. Kluczowe komendy ekonomii:

  • /balance - sprawdzenie własnego salda
  • /pay Gracz kwota - przelew do innego gracza
  • /baltop - ranking najzamozniejszych graczy na serwerze
  • /eco give/take/set Gracz kwota - administracyjne zarzadzanie saldami

Ekonomia EssentialsX integruje sie z pluginami sklepow (ShopGUI+, QuickShop Hikari, AuctionHouse) przez Vault. Możesz tez ustawic koszty komend - na przyklad /home za 50$ czy /warp za 25$, co tworzy naturalny odpływ pieniedzy z obiegu i zapobiega inflacji.

Konfiguracja

Główny plik konfiguracyjny to plugins/Essentials/config.yml. Ma ponad 500 linii, ale najważniejsze sekcje to:

# Teleportacja
teleport-cooldown: 3          # opoznienie miedzy teleportacjami (sekundy)
teleport-delay: 3             # czas oczekiwania przed teleportacja
tpa-accept-cancellation: 120  # czas na zaakceptowanie /tpa (sekundy)

# Domy
sethome-multiple.default: 3   # ile domow może miec zwykly gracz
sethome-multiple.vip: 5       # ile domow dla rangi VIP

# Ekonomia
starting-balance: 500         # saldo startowe nowego gracza
currency-symbol: "$"          # symbol waluty
max-money: 10000000           # limit salda

# Spawn
spawn-on-join: true           # teleportacja na spawn po dolaczeniu
respawn-at-home: true         # respawn w domu gracza zamiast na spawnie

Kity definiujesz w pliku plugins/Essentials/kits.yml. Przyklad starter kitu:

kits:
  starter:
    delay: 86400  # 24h cooldown
    items:
      - IRON_SWORD 1
      - IRON_PICKAXE 1
      - BREAD 16
      - TORCH 32
      - OAK_LOG 32

Warpy tworzy sie komenda /setwarp nazwa w grze. Lista warpow wyswietla sie pod /warp lub /warps.

Moduly EssentialsX

Oprocz głównego pluginu, EssentialsX oferuje opcjonalne moduly jako osobne pliki .jar. Każdego możesz użyć niezaleznie:

  • EssentialsX Chat - formatowanie chatu, prefixe rang (integracja z LuckPerms), kanaly lokalne/globalne, placeholder
  • EssentialsX Spawn - zaawansowane zarzadzanie spawnem: spawn per grupa, spawn dla nowych graczy, newbie announce
  • EssentialsX GeoIP - wyswietla kraj gracza przy dolaczeniu na podstawie adresu IP. Przydatne na miedzynarodowych serwerach
  • EssentialsX AntiBuild - kontrola budowania per grupa: która ranga może stawiac/niszczyc jakie bloki
  • EssentialsX Protect - podstawowa ochrona świata: blokowanie creeperow, wybuchy TNT, płomienie, enderman pickup
  • EssentialsX Discord - most między chatem Minecraft a kanalem Discord. Wiadomosci synchronizuja sie w obie strony
  • EssentialsX XMPP - integracja z protokolem XMPP (Jabber) - niszowe, ale przydatne w zamkniętych spolecznosciach

Moduly Chat i Spawn sa używane na wiekszosci serwerow. Discord zyskuje na popularnosci od czasu gdy wiekszosc społeczności serwerowych przeniosla komunikacje na Discord.

Wskazówki dla adminow

  • Nie dawaj essentials.* nikomu - to uprawnienie daje dostep do WSZYSTKICH komend, włącznie z /eco give i /vanish. Zamiast tego przydzielaj konkretne nody, np. essentials.home, essentials.tpa
  • Uzyj override komend - jeśli inny plugin nadpisuje komendy EssentialsX (np. /tp), dodaj alias w config.yml w sekcji overridden-commands
  • Cooldowny zapobiegaja spamowi - ustaw teleport-cooldown na 3-5 sekund, zeby gracze nie spamowali /tpa
  • Koszty komend = sink ekonomii - ustawianie oplat za /home i /warp to prosty sposob na odpływ pieniedzy z obiegu
  • Znaki [Buy] i [Sell] - EssentialsX umożliwia tworzenie sklepow na szyldach. Przydatne jako alternatywa dla pełnego pluginu sklepowego na mniejszych serwerach

Powiązane poradniki: LuckPerms (uprawnienia do komend), Vault (ekonomia), serwer z ekonomia (pełna konfiguracja systemu ekonomii).