Přejít na hlavní obsah

EssentialsX: instalace a nastavení na Minecraft serveru

Kompletní návod na instalaci a nastavení EssentialsX: konfigurace, příkazy pro home, warp, teleportaci, ekonomiku i kity.

EssentialsX je nejrozšířenější administrátorský plugin pro Minecraft servery. Přidává přes 130 příkazů pro správu hráčů, teleportaci, ekonomiku, kity, warpy a desítky dalších funkcí, které vanilla Minecraft postrádá. Bez EssentialsX (nebo jeho ekvivalentu) se neobejde prakticky žádný survival, RPG ani veřejný server.

Rychlý přehled

  1. Stáhněte EssentialsX JAR z essentialsx.net
  2. Nahrajte soubor do složky plugins/ na vašem serveru
  3. Restartujte server - plugin se automaticky inicializuje
  4. Upravte plugins/Essentials/config.yml podle potřeby
  5. Volitelně nainstalujte doplňkové moduly (EssentialsX Chat, Spawn, AntiBuild)

Instalace EssentialsX

1. Stažení pluginu

Stáhněte nejnovější verzi EssentialsX ze stránky essentialsx.net/downloads.html. Stáhněte soubor EssentialsX-X.X.X.jar (hlavní plugin).

Upozornění: Nepoužívejte starý plugin Essentials - ten není udržovaný a nepodporuje moderní verze Minecraftu. Správný plugin je EssentialsX (s velkým X).

2. Nahrání na server

Nahrajte stažený JAR soubor do složky plugins/ v kořenovém adresáři serveru. Pokud složka plugins/ neexistuje, server musí být typu Paper, Spigot nebo Purpur - vanilla server pluginy nepodporuje.

3. Restart serveru

Restartujte server. EssentialsX při prvním spuštění automaticky vytvoří složku plugins/Essentials/ s konfiguračním souborem config.yml a dalšími soubory.

Po restartu ověřte, že plugin běží příkazem v konzoli:

plugins

EssentialsX by měl být v seznamu zvýrazněn zeleně.

Doplňkové moduly

EssentialsX se dodává ve více modulech. Hlavní plugin stačí pro většinu funkcí, ale pro některé možnosti potřebujete doplňkové JAR soubory (nahrajte je stejně do složky plugins/):

ModulCo přidává
EssentialsXHlavní plugin, základní příkazy
EssentialsXChatFormátování chatu, prefix/suffix hráčů
EssentialsXSpawnSpráva spawn pointu, první připojení hráčů
EssentialsXAntiBuildOchrana stavění podle oprávnění

Pro většinu serverů stačí EssentialsX + EssentialsXSpawn + EssentialsXChat.

Základní konfigurace (config.yml)

Konfigurační soubor najdete v plugins/Essentials/config.yml. Níže jsou nejdůležitější nastavení, která budete pravděpodobně chtít upravit.

Jazyk pluginu

locale: cs

EssentialsX podporuje češtinu. Pokud chcete zprávy v češtině, nastavte locale: cs. Případně sk pro slovenštinu nebo en pro angličtinu.

Výchozí herní mód pro nové hráče

default-gamemode: survival

Zpráva při připojení a odpojení

join-message: '&a+ {DISPLAYNAME}'
quit-message: '&c- {DISPLAYNAME}'

Výchozí maximální počet domovů (homes)

sethome-multiple:
  default: 3
  vip: 10

Hráči s oprávněním essentials.sethome.multiple.vip budou mít 10 domovů, ostatní 3.

Teleportační zpoždění

teleport-delay: 3

Počet sekund, po které hráč nesmí hýbat před teleportací. Nastavte 0 pro okamžitou teleportaci.

Ochrana příkazů pro nové hráče

new-player-commands:
  - kit starter
  - spawn

Příkazy, které se automaticky spustí při prvním připojení hráče.

Po každé změně v config.yml načtěte konfiguraci příkazem:

/essentials reload

Přehled nejpoužívanějších příkazů

Teleportace

PříkazPopis
/tpa <nick>Požádat hráče o teleportaci k němu
/tpacceptPřijmout žádost o teleportaci
/tpdenyOdmítnout žádost o teleportaci
/tp <nick>Teleportovat se k hráči (OP/admin)
/tphere <nick>Teleportovat hráče k sobě (OP/admin)

Domovy (homes)

PříkazPopis
/sethome [název]Nastavit domov na aktuální pozici
/home [název]Teleportovat se domů
/delhome [název]Smazat domov
/homesZobrazit seznam domovů

Warpy

PříkazPopis
/setwarp <název>Vytvořit warp na aktuální pozici
/warp <název>Teleportovat se na warp
/delwarp <název>Smazat warp
/warpsZobrazit seznam všech warpů

Správa hráčů

PříkazPopis
/kick <nick> [důvod]Vykopnout hráče ze serveru
/mute <nick>Umlčet hráče v chatu
/unmute <nick>Zrušit mute
/fly <nick>Zapnout/vypnout létání
/heal <nick>Vyléčit hráče
/feed <nick>Nakrmit hráče
/gamemode <režim> <nick>Změnit herní mód hráče

Ekonomika

EssentialsX obsahuje základní ekonomiku, ale pro fungování potřebuje plugin Vault. Vault stáhněte ze stránky dev.bukkit.org/projects/vault a nainstalujte stejně jako EssentialsX.

PříkazPopis
/eco give <nick> <částka>Přidat peníze hráči
/eco take <nick> <částka>Odebrat peníze hráči
/eco set <nick> <částka>Nastavit zůstatek hráče
/balanceZobrazit vlastní zůstatek
/pay <nick> <částka>Poslat peníze jinému hráči

Kity

Kity jsou sady předmětů, které hráči mohou vyžádat s nastaveným cooldownem. Definují se v souboru plugins/Essentials/kits.yml:

kits:
  starter:
    delay: 0
    items:
      - stone_sword 1
      - bread 16
      - wooden_pickaxe 1

Hráč kit vyžádá příkazem:

/kit starter

Oprávnění (permissions)

EssentialsX nepoužívá OP pro přidělování příkazů - používá permissions systém. Pro správné fungování doporučujeme nainstalovat LuckPerms a přiřadit skupinám oprávnění jako:

  • essentials.tpa - použití /tpa
  • essentials.home - použití /home
  • essentials.warp.* - přístup ke všem warpům
  • essentials.fly - použití /fly

Hráčům bez příslušného oprávnění se příkaz neukáže a při pokusu o použití dostanou chybovou hlášku.

Časté problémy a otázky

EssentialsX se načetl, ale příkazy nefungují

Zkontrolujte verzi Minecraftu a verzi EssentialsX - plugin musí podporovat vaši verzi serveru. Ověřte také, zda server běží na Paper nebo Spigot, ne na vanilla.

Hráči mají OP, ale EssentialsX jim některé příkazy nedovolí

EssentialsX respektuje permissions systém i pro OP hráče pokud je nainstalovaný LuckPerms nebo jiný permissions plugin. Přidejte OP hráčům skupinu s wildcard oprávněním essentials.* nebo použijte přímo OP oprávnění v LuckPerms.

Ekonomika nefunguje, příkaz /balance vrací chybu

EssentialsX ekonomika vyžaduje plugin Vault. Nainstalujte Vault do složky plugins/ a restartujte server.

Jak zakázat konkrétní příkaz EssentialsX?

V souboru config.yml přidejte příkaz do sekce disabled-commands:

disabled-commands:
  - nick
  - me

Po uložení spusťte /essentials reload.

Jak nastavit prefix hráče v chatu?

Prefixy v chatu se nastavují přes LuckPerms (doporučeno) v kombinaci s modulem EssentialsXChat. V LuckPerms přiřaďte skupině prefix příkazem:

/lp group <skupina> meta setprefix <priorita> "<prefix>"