Jak nainstalovat pluginy na Minecraft server

Než začnete

Pluginy fungují jen na serverovém softwaru s Bukkit API — tedy na Paper, Spigot nebo jejich odnožích (např. Purpur). Na čistém Vanilla serveru ani na Fabricu, Forgi či NeoForgi se pluginy nenačtou — tam se používají módy (viz návod Fabric, Forge a modpacky).

Jaký software a jaká verze na serveru běží, zjistíte v konzoli panelu (záložka Console / Terminal) příkazem:

version

Příkazy do konzole panelu se píšou bez lomítka. Ve hře je stejný příkaz /version (vyžaduje oprávnění).

Kde pluginy stahovat

Stahujte jen z oficiálních katalogů nebo přímo od autora. Plugin je spustitelný Java kód se stejnými právy jako server — upravené nebo „zdarma odemčené“ placené pluginy z neoficiálních webů jsou častým zdrojem malwaru a backdoorů.

Stahujete vždy soubor s příponou .jar. Pokud autor nabízí více souborů, vyberte ten pro Paper/Spigot/Bukkit, ne pro Fabric, Forge nebo Velocity/BungeeCord (proxy).

Kompatibilita s verzí serveru

Na stránce pluginu zkontrolujte tři věci:

• Verze hry — plugin musí podporovat verzi, na které server běží (např. 1.21.x). Plugin pro starší verzi se často načte, ale nemusí fungovat správně; plugin pro novější verzi se obvykle nenačte vůbec.
• Závislosti — některé pluginy potřebují jiný plugin (typicky Vault, ProtocolLib nebo PlaceholderAPI). Závislosti nahrajte do stejné složky.
• Verze Javy — Minecraft 1.20.5 a novější vyžaduje Javu 21, verze 1.18 až 1.20.4 Javu 17. Javu vybíráte v záložce Startup v poli Docker Image, pokud jich šablona nabízí více.

1Zastavení serveru

V panelu klikněte na Stop a počkejte, až se stav změní na Offline. Pluginy se načítají při startu serveru; nahrávat je za běhu a pak používat příkaz /reload se nedoporučuje — Paper i Spigot na to samy upozorňují, protože to často vede k únikům paměti a chybám.

2Nahrání pluginu do složky /plugins

Varianta A: správce souborů v panelu

1. Otevřete záložku Files.
2. Klikněte na složku plugins. Pokud neexistuje, server ještě nebyl s Paperem/Spigotem spuštěn — spusťte ho jednou, složka se vytvoří sama.
3. Klikněte na Upload a vyberte stažený soubor .jar, případně ho do okna přetáhněte myší.

Varianta B: SFTP (více souborů najednou)

Přihlašovací údaje najdete v záložce Settings v sekci SFTP Details. Heslo je stejné jako heslo k panelu. Připojit se můžete třeba programem FileZilla nebo WinSCP:

Po připojení nahrajte soubory .jar do složky /plugins.

/
├── plugins/
│   ├── LuckPerms-Bukkit-5.x.jar
│   ├── Vault.jar
│   └── EssentialsX-2.x.jar
├── world/
├── server.properties
└── server.jar

3Spuštění a kontrola v konzoli

Spusťte server tlačítkem Start a sledujte konzoli. Úspěšně načtený plugin se ohlásí řádkem podobným tomuto:

[Server thread/INFO]: [LuckPerms] Enabling LuckPerms v5.4.x

Po startu vypište seznam pluginů:

plugins

Zeleně zobrazené pluginy běží, červené se nenačetly nebo se vypnuly kvůli chybě. U červeného pluginu vyhledejte v konzoli (nebo v souboru logs/latest.log) jeho název — chybová hláška bývá těsně nad ním.

4Konfigurace pluginu

Při prvním spuštění si většina pluginů vytvoří vlastní složku, např. plugins/Essentials/ se souborem config.yml. Upravit ho můžete přímo ve správci souborů v panelu. Soubory YAML jsou citlivé na odsazení — používejte mezery, ne tabulátory.

Aby se změny projevily, restartujte server, nebo použijte vlastní reload příkaz pluginu, pokud ho má (např. lp reloadconfig u LuckPerms). Obecný /reload nepoužívejte.

Aktualizace a odebrání pluginu

1. Zastavte server.
2. Ve složce plugins smažte starý soubor .jar a nahrajte nový. Dvě verze stejného pluginu vedle sebe způsobí chybu „Ambiguous plugin name“.
3. Konfigurační složku pluginu nechte — nová verze ji většinou převezme. Před velkou aktualizací si ji zálohujte (stáhnout ji můžete přes SFTP).
4. Spusťte server a zkontrolujte konzoli.

Odebrání pluginu: zastavte server a smažte jeho .jar. Složku s konfigurací a daty smažte jen tehdy, když ji už nebudete potřebovat.

Časté chyby