Discord
RYJON - nowy polski serwer KitPvP na Minecraft 1.21.4, graj na ryjon.pl
Wiki - Pluginy

EssentialsX - najważniejszy plugin serwerowy

EssentialsX

EssentialsX to plugin numer jeden na serwerach Minecraft. Ponad 140 komend, system ekonomii, teleportacja, moderacja, kity i warpy - wszystko w jednym pakiecie. Obsługuje 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 niezbędnych na każdym serwerze Minecraft. Jest kontynuacja legendarnego pluginu Essentials, rozwijana od 2014 roku przez niezależny zespół po tym, jak oryginalny projekt został porzucony.

Plugin jest instalowany na szacunkowo 80-90% wszystkich publicznych serwerów Minecraft. Zastępuje kilkanaście mniejszych pluginów jednym pakietem: teleportacja, domy graczy, warpy, kity, wiadomości prywatne, moderacja (mute, ban, kick, jail), spawn, ekonomia i wiele więcej. Dzięki temu admin nie musi szukać osobnych pluginów do każdej z tych funkcji i martwic się o ich kompatybilność.

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

Najważniejsze komendy

EssentialsX dodaje ponad 140 komend. Oto te, z których gracze korzystają 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 Wysyła prośbę o teleportacje do gracza essentials.tpa
/tpaccept Akceptuje prośbę 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 przedmiotów (np. starter kit) essentials.kit
/msg Gracz tekst Wysyła prywatna wiadomość 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. Obsługuje 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 zarządzanie saldami

Ekonomia EssentialsX integruje się z pluginami sklepów (ShopGUI+, QuickShop Hikari, AuctionHouse) przez Vault. Możesz tez ustawić koszty komend - na przykład /home za 50$ czy /warp za 25$, co tworzy naturalny odpływ pieniędzy 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          # opóźnienie 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 domów może mieć zwykły gracz
sethome-multiple.vip: 5       # ile domów 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 dołączeniu
respawn-at-home: true         # respawn w domu gracza zamiast na spawnie

Kity definiujesz w pliku plugins/Essentials/kits.yml. Przykład starter kitu:

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

Warpy tworzy się komenda /setwarp nazwa w grze. Lista warpow wyświetla się pod /warp lub /warps.

Moduły EssentialsX

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

  • EssentialsX Chat - formatowanie chatu, prefixe rang (integracja z LuckPerms), kanały lokalne/globalne, placeholder
  • EssentialsX Spawn - zaawansowane zarządzanie spawnem: spawn per grupa, spawn dla nowych graczy, newbie announce
  • EssentialsX GeoIP - wyświetla kraj gracza przy dołączeniu 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. Wiadomości synchronizują się w obie strony
  • EssentialsX XMPP - integracja z protokolem XMPP (Jabber) - niszowe, ale przydatne w zamkniętych społecznościach

Moduły Chat i Spawn sa używane na większości serwerow. Discord zyskuje na popularności od czasu gdy większość społeczności serwerowych przeniosła komunikacje na Discord.

Wskazówki dla adminów

  • Nie dawaj essentials.* nikomu - to uprawnienie daje dostęp do WSZYSTKICH komend, włącznie z /eco give i /vanish. Zamiast tego przydzielaj konkretne nody, np. essentials.home, essentials.tpa
  • Użyj override komend - jeśli inny plugin nadpisuje komendy EssentialsX (np. /tp), dodaj alias w config.yml w sekcji overridden-commands
  • Cooldowny zapobiegają spamowi - ustaw teleport-cooldown na 3-5 sekund, żeby gracze nie spamowali /tpa
  • Koszty komend = sink ekonomii - ustawianie opłat za /home i /warp to prosty sposób na odpływ pieniędzy z obiegu
  • Znaki [Buy] i [Sell] - EssentialsX umożliwia tworzenie sklepów 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).