EssentialsX — konfiguracja, komendy i moduły krok po kroku

Czym jest EssentialsX i czemu jest „obowiązkowy"

EssentialsX to ~150 komend, które wypełniają luki w vanilla Minecrafcie:

• system domów i warpów,
• teleportacja między graczami (/tpa),
• prywatne wiadomości i komunikacja,
• system ekonomii (z Vault),
• kity startowe (/kit),
• moderacja: /mute, /kick, /ban,
• czat z formatowaniem, prefiksami, kanałami,
• spawn z auto-respawn,
• auto-detekcja AFK.

Większość pluginów ekonomicznych, sklepów i ankiet zakłada, że EssentialsX jest zainstalowany — to standardowa zależność polskiej i światowej sceny serwerów.

Modułowa struktura — instaluj tylko to, czego używasz

EssentialsX składa się z kilku osobnych JAR-ów. Trzeba je pobierać razem, ale wrzucić tylko te potrzebne:

• EssentialsX — rdzeń (komendy, /home, /tpa, eco),
• EssentialsXChat — formatowanie czatu z prefiksami,
• EssentialsXSpawn — system spawn'u + first-spawn,
• EssentialsXProtect — ochrona przed griefem (legacy, dziś częściej WorldGuard),
• EssentialsXAntiBuild — blokowanie budowania bez permisji,
• EssentialsXGeoIP — wykrywanie lokalizacji gracza,
• EssentialsXDiscord — most czat ↔ Discord,
• EssentialsXXMPP — most XMPP (rzadko używany).

Typowy nowoczesny stack to: EssentialsX + EssentialsXChat + EssentialsXSpawn + EssentialsXDiscord. Resztę pominąć — nowsze pluginy są lepsze.

Instalacja i pierwsze uruchomienie

1. Pobierz pliki z essentialsx.net (lub Modrinth),
2. Wrzuć JAR-y do plugins/,
3. Zrestartuj serwer — utworzy się plugins/Essentials/config.yml,
4. Edytuj konfigurację (omówiona niżej),
5. Wykonaj /reload confirm albo restart.

Konflikt z innymi pluginami komendowymi (CMI, OnTime) — w config.yml ustaw command-aliases i wyłącz duplikujące się komendy.

Najważniejsze komendy dla graczy

/home, /sethome, /delhome, /homes
/tpa, /tpaccept, /tpdeny, /tpahere
/spawn
/warp, /warps
/msg gracz wiadomość
/r odpowiedź
/seen gracz
/back              # powrót do miejsca śmierci
/afk
/help

Każda komenda ma swój permisję: essentials.home, essentials.tpa, essentials.sethome.multiple.vip (dla VIP'ów z większą liczbą domów). To pozwala precyzyjnie zarządzać uprawnieniami przez LuckPerms.

Komendy dla moderatorów i adminów

/kick gracz powód
/ban gracz powód
/tempban gracz 7d
/banip 1.2.3.4
/mute gracz 1h
/jail gracz cela 30m

/gamemode survival
/heal, /feed
/god
/fly
/invsee gracz
/echest gracz       # podgląd ender chest

Większość tych komend ma flagę „silent" (np. /sban, /skick) — moderator banuje, ale komunikat nie trafia do czatu. Przydaje się przy cichych moderacjach.

Kity — gotowe ekwipunki dla graczy

Konfiguracja w plugins/Essentials/kits.yml:

kits:
  starter:
    delay: 0
    items:
      - stone_sword
      - bread 16
      - leather_chestplate
      - leather_leggings
  vip-daily:
    delay: 86400          # 24h
    items:
      - diamond_sword 1 sharpness:3
      - golden_apple 5
      - cooked_beef 32

Permisje per kit: essentials.kits.starter, essentials.kits.vip-daily. W LuckPerms wpisz całą paczkę z wildcardami: /lp group vip permission set essentials.kits.vip-* true.

Warpy — publiczne teleporty

/setwarp shop
/setwarp arena
/warp shop
/warps             # lista
/delwarp arena

Warpy chronione permisją: essentials.warps.arena daje dostęp tylko do tego konkretnego warpa. Praktyczna konwencja: essentials.warps.* dla wszystkich publicznych, osobne dla VIP'owych.

Ekonomia — podstawa serwera survival

EssentialsX ma własną prostą ekonomię. Z Vault'em integruje się z innymi pluginami (sklepy, AH, casino).

/eco give Nick 1000
/eco take Nick 500
/eco set Nick 0
/balance
/baltop
/pay Nick 100

W config.yml:

currency-symbol: '$'
starting-balance: 100
min-money: -1000          # ujemne saldo (debet)
max-money: 1000000000
worth-yml-takes-precedence: true

Ceny przedmiotów w worth.yml — używane przez komendę /sell i niektóre sklepy.

Czat z prefiksami (EssentialsXChat + LuckPerms)

EssentialsXChat odczytuje prefiksy z LuckPerms. Konfiguracja w config.yml Essentials:

chat:
  format: '{PREFIX}&7{DISPLAYNAME}{SUFFIX}&8: &f{MESSAGE}'
  group-formats:
    Admin: '&4[Admin] {DISPLAYNAME}: &c{MESSAGE}'
    VIP: '&6[VIP] {DISPLAYNAME}: &f{MESSAGE}'

Kanały czatu (np. dla pracy w teamie):

/chat staff       # czat staff'u
/chat global      # ogólny
/local hi         # tylko gracze w promieniu

Spawn i first-spawn

Komendy /setspawn i /spawn obsługuje moduł EssentialsXSpawn. W spawns.yml można mieć osobne spawn'y per grupa LuckPerms.

respawn-at-home: false
respawn-listener-priority: high
spawn-on-join: true
new-players:
  kit: starter
  spawn-location: world,0,80,0,0,0

Pierwsze dołączenie gracza wykonuje skrypt: teleport na spawn, danie kit'u starter, wiadomość powitania na cały serwer.

AFK i ekonomia czasu

Plugin sam wykrywa, że gracz nie ruszał się przez X minut. Konfiguracja:

auto-afk: 300              # 5 min — auto-AFK
auto-afk-kick: -1          # nie kickuj
freeze-afk-players: true
disable-item-pickup-while-afk: true

Często łączone z pluginami płacącymi za czas online — przy AFK nagrody są wstrzymywane.

EssentialsXDiscord — most do Discorda

Sztandarowa funkcja: synchronizacja czatu Minecraft ↔ Discord.

token: 'BOT_TOKEN'
channels:
  primary: '123456789012345678'
  staff: '987654321098765432'
console:
  enabled: true
  predefined-permission-level: ADMINISTRATOR

Plus funkcje: powiadomienia o joinie/leave, kick z Discorda, sprawdzanie online z poziomu serwera Discord.

Alternatywy: CMI, AutorankPremium

• CMI — płatna alternatywa od Zrips, więcej funkcji, lepsze GUI, ale licencja per serwer,
• EssentialsX — darmowy, open source, najszerzej wspierany przez inne pluginy,
• Większość pluginów społeczności integruje się z EssentialsX. CMI wymaga konwerterów.

Zalecenie: EssentialsX, chyba że masz konkretny powód, dla którego CMI lepiej pasuje (np. własny system rang).

Podsumowanie

EssentialsX to plugin, którego nie da się „nie zainstalować" na serwerze publicznym. Komendy /home, /tpa, /spawn, /msg, system kitów i ekonomia tworzą minimum, którego oczekuje każdy gracz po dołączeniu. Zainstaluj cztery moduły (rdzeń + Chat + Spawn + Discord), skonfiguruj kity i ekonomię, dopnij prefiksy z LuckPerms — i masz fundament działającego serwera w godzinę.

Reszta to już dostrajanie pod konkretną wizję projektu: limit domów per grupa, kit cooldown'y, wiadomości powitań, balansowanie waluty. EssentialsX nigdy nie będzie najnowocześniejszym pluginem, ale działa stabilnie od dekady i będzie działał jeszcze następną.