Jak nainstalovat pluginy na Minecraft server (Paper & Spigot)

Pluginy vs mody: jaký je rozdíl?

Než si cokoliv stáhnete, ujistěte se, že plugin je opravdu to, co chcete. Lidé slova plugin a mod používají zaměnitelně, ale na serveru jde o dvě zcela odlišné věci.

Pluginy se napojují na Bukkit API, které nabízejí Paper a Spigot. Fungují výhradně na serveru, takže se hráči připojují s běžným Minecraft klientem a nic nestahují — přesně proto se pluginové servery tak snadno provozují a rozšiřují.

Mody jsou úplně jiný svět: mění samotného herního klienta, takže server i každý jeden hráč musí používat stejný loader a stejný seznam modů, obvykle dodávaný společně jako modpack. Pokud hledáte tohle, jste u špatného návodu — přejděte na jak vytvořit modovaný Minecraft server. Kompletní srovnání loaderů a toho, kam se který hodí, najdete v nejlepší software pro Minecraft server.

Než začnete: spusťte Paper nebo Spigot

Pluginy se načtou jen na serveru, který mluví jazykem Bukkit API. Vanilla server.jar od Mojangu to neumí — vložíte vedle něj plugin a nic se nestane. Potřebujete jeden z těchto:

• Paper — standardní volba. Je nejrychlejší z celé rodiny, aktivně udržovaný a kompatibilní s obrovským ekosystémem pluginů Bukkit/Spigot. Začněte zde.
• Spigot — starší základ, na který stále cílí a testuje většina pluginů. Paper je jeho přímým nadřazeným rozšířením, takže plugin označený „pro Spigot" poběží i na Paperu.
• Purpur — fork Paperu s dalšími herními přepínači. Stejné pluginy, o pár možností navíc.

Pokud stále jedete na vanille, přechod je rychlý. Na Minecraft plánu HytHost má panel GameCP vestavěný přepínač verzí: vyberte Paper (nebo Spigot/Purpur) a verzi Minecraftu, klikněte jednou a správný build se nainstaluje sám — váš svět zůstane nedotčený. Provozujete si server sami? Stáhněte Paper jar a spusťte ho místo toho vanilla. S výběrem mezi vanillou, Paperem, Forge a Fabric pomůže nejlepší software pro Minecraft server; pokud jste server ještě nezaložili, začněte s jak vytvořit Minecraft server.

Jak nainstalovat plugin krok za krokem

Když už běží Paper nebo Spigot, instalace pluginu je pár krátkých kroků. Celé to zabere pár minut.

1. Stáhněte JAR pluginu z důvěryhodného zdroje. Ověřenými domovy pluginů jsou SpigotMC, Modrinth a Hangar (PaperMC). Stáhněte soubor .jar a ověřte, že stránka uvádí podporu pro vaši verzi Minecraftu — plugin postavený pro 1.20 se na 1.21 zpravidla odmítne načíst.
2. Nahrajte ho do složky plugins. Otevřete v panelu záložku Files, přejděte do adresáře plugins a nahrajte JAR — funguje i přetažení myší. Instalujete jich víc najednou? Připojte se přes SFTP pomocí přihlašovacích údajů z panelu a zkopírujte je rovnou do plugins. Provozujete si server sami? Složka plugins leží vedle vašeho server.jar.
3. Restartujte server. Pluginy se načítají jen při spuštění, takže klikněte v panelu na Restart — obyčejný reload nový plugin nezachytí. Sledujte konzoli při startu: každý plugin se při povolení ohlásí.
4. Ověřte, že se načetl. Do příkazového řádku konzole napište /plugins (nebo kratší /pl). Váš nový plugin by se měl objevit v seznamu, vypsaný zeleně. Zelená znamená načteno a běží, červená znamená selhalo — pokud ji uvidíte, přejděte na řešení problémů.
5. Nakonfigurujte ho. První úspěšné spuštění vytvoří plugins/<PluginName>/config.yml. Upravte tento soubor ve správci souborů, abyste plugin doladili, poté spusťte jeho reload příkaz nebo restartujte. YAML je citlivý na mezery — odsazujte mezerami, nikdy tabulátory, jinak se soubor nenačte.

Základní pluginy, které vyplatí nainstalovat jako první

Prohlížením pluginů byste mohli strávit celý víkend, ale téměř každý dobře vedený survival nebo SMP server stojí na stejném krátkém seznamu. Nainstalujte tyto jako první:

• EssentialsX — švýcarský nožík: /home, /spawn, /tpa, kity, warpy, základní ekonomika a desítky běžných příkazů. Pokud nainstalujete jen jeden plugin, ať je to tenhle.
• LuckPerms — správce oprávnění. Rozhoduje, kdo může spouštět jaké příkazy, a dává vám hodnosti a skupiny. Většina ostatních pluginů se na něj napojuje, takže je prakticky nutný ve chvíli, kdy máte víc než jednoho admina.
• WorldEdit + WorldGuard — WorldEdit umožňuje rychle stavět a upravovat terén; WorldGuard chrání oblasti (spawn, obchody, arény) před griefingem a řídí PvP zóny. Přicházejí jako dvojice.
• Vault — tichý přemosťovací plugin, díky němuž spolu mluví ekonomické, oprávňovací a chatové pluginy. Několik pluginů ho uvádí jako závislost; nainstalujte a zapomeňte.
• CoreProtect — logování bloků a rollback. Když griefer zasáhne váš spawn, CoreProtect přesně ukáže, kdo co udělal, a během vteřin to vrátí zpět. Nainstalujte ho dřív, než ho budete potřebovat.

Poznámka k oprávněním: hned po instalaci reaguje většina příkazových pluginů jen na operátory serveru. Aby běžná hodnost mohla používat něco jako /home, přidělíte odpovídající uzel oprávnění (zde essentials.home) její skupině v LuckPerms. Tady se skoro každý jednou chytí — když příkaz běžnému hráči „nic nedělá", je to skoro vždy chybějící oprávnění, ne rozbitý plugin.

Každý přidaný plugin spotřebuje trochu paměti, takže rušný pluginový server potřebuje víc rezervy než holá vanilla — počítejte s 4-6 GB na Paper serveru se základními pluginy výše. Pokud si nejste jistí, kolik nastavit, náš návod na kolik RAM Minecraft server potřebuje to rozebírá podle počtu hráčů a nastavení.

Aktualizace a odebírání pluginů

Pluginy jsou jen soubory v jedné složce, takže úklid je jednoduchý.

Aktualizace pluginu

Stáhněte novou verzi, smažte starý JAR ze složky plugins (nechte konfigurační složku pluginu na pokoji, ať vaše nastavení přežije), nahrajte nový JAR a restartujte. Udržovat pluginy aktuální je důležité: zastaralý plugin je obvyklý viník, když se server rozbije hned po zvýšení verze Minecraftu, takže pluginy aktualizujte pokaždé, když měníte verzi Minecraftu.

Odebrání pluginu

Restartujte nebo zastavte server, smažte JAR pluginu ze složky plugins a při dalším startu bude pryč. Jeho konfigurační složka pod plugins/<PluginName> zůstane, pokud ji nesmažete taky — nevadí ji nechat, ale je čistší ji odstranit, pokud s pluginem definitivně končíte.

Plugin se nenačítá? Jak to opravit

Když se plugin v /plugins zobrazí červeně nebo nedělá vůbec nic, důvod je téměř vždy jeden z několika málo. Projděte je popořadě:

1. Nesoulad verzí. Příčina číslo jedna. Zkontrolujte stránku pluginu proti verzi Minecraftu vašeho serveru — JAR postavený pro 1.20 se často nepovolí na 1.21, a naopak stejně tak. Stáhněte build, který odpovídá, nebo změňte verzi serveru tak, aby odpovídala pluginu.
2. Chybějící závislost. Řada pluginů potřebuje vedle sebe nainstalovaného pomocníka — Vault pro ekonomické pluginy, ekonomický plugin pro obchod, konkrétní knihovnu. Konzole vám to sama pojmenuje: hledejte řádek jako Unknown/missing dependency plugins: [Vault]. Nainstalujte, co žádá, a restartujte.
3. Špatný typ serveru. Pokud se nenačte vůbec nic, ověřte, že opravdu jedete na Paper nebo Spigot a ne na vanille — pluginy potřebují Bukkit API. Přepínač verzí ukáže, co máte spuštěné.
4. Poškozená konfigurace. Jediný špatně odsazený řádek v config.yml dokáže plugin úplně zastavit. Chyba v konzoli obvykle ukáže řádek a sloupec. Opravte YAML (mezery, nikdy tabulátory), nebo smažte konfigurační soubor a nechte plugin při dalším restartu vygenerovat čistý.

Konzole je tady váš nejlepší přítel. Ať selhalo cokoliv, server vypíše důvod při startu — červený řádek ERROR nebo WARN pojmenovávající plugin a problém. Čtěte odshora dolů; první chyba bývá ta skutečná.