Instalace pluginů na Minecraft server (Paper, Purpur)

Pluginy přidávají serveru příkazy, ochranu staveb, ekonomiku, minihry a mnoho dalšího. Hráči si nic neinstalují. Ukážeme instalaci jedním kliknutím přímo v zákaznické zóně i ruční nahrání souboru, nastavení pluginu, aktualizace a řešení nejčastějších chyb.

Než začnete#

• Pluginy fungují jen na Paperu, Purpuru a Folii. Na Fabricu, Forge a NeoForge se místo pluginů používají módy a záložka se jmenuje Módy, viz Módy a modpacky. Vanilla nepodporuje ani jedno. Rozdíl vysvětluje článek Pluginy, nebo módy?.
• Plugin musí podporovat vaši verzi Minecraftu. Plugin pro starší verzi se často nenačte nebo se chová nepředvídatelně.
• Na Folii funguje jen menšina pluginů. Plugin musí podporu Folie výslovně uvádět.
• Plugin smí na serveru všechno. Dokumentace Paperu upozorňuje, že pluginy mají plný a neomezený přístup k serveru. Instalujte jen pluginy z důvěryhodných zdrojů.

Instalace přes zákaznickou zónu#

1. Otevřete Moje služby, klikněte na server a přejděte na záložku Pluginy.

2. Klikněte na podzáložku Procházet. Bez hledání uvidíte nejstahovanější pluginy pro váš typ a verzi serveru.

3. V přepínači Zdroj zvolte katalog (vysvětlení níže). Začněte s Modrinth.

4. Do pole „Hledat pluginy“ napište název, například LuckPerms, a klikněte na Hledat.

5. U pluginu klikněte na Instalovat. Pokud chcete jinou než nejnovější verzi, klikněte nejdřív na Verze a vyberte ji ze seznamu.

6. Prohlédněte si dialog Instalace …:

   • Hlavní soubor – soubor pluginu, který se nahraje do složky plugins.
   • Povinné závislosti – další pluginy, bez kterých se plugin nespustí. Zákaznická zóna je nainstaluje s ním. Odškrtněte jen ty, které už na serveru máte nahrané ručně.
   • Upozornění na soubory se stejným názvem, které instalace přepíše, a na pluginy, se kterými podle autora nefunguje.
   • Ke stažení – celková velikost.

7. Klikněte na Nainstalovat.

   Po dokončení uvidíte hlášku Nainstalováno: se seznamem souborů a upozornění „Změny se projeví po restartu serveru“.

8. Klikněte na Restartovat a potvrďte. Pluginy se načítají jen při startu serveru.

Zdroje pluginů#

Kontrolní součet potvrzuje, že soubor na server dorazil přesně takový, jaký autor zveřejnil. Plugin, který je jen na SpigotMC nebo na webu autora, nahrajte ručně, viz Ruční instalace.

Další štítky ve výsledcích:

• Jen externě – autor soubor hostuje jinde (často placené pluginy). Automaticky ho nainstalovat nejde, stáhněte ho z autorovy stránky a nahrajte ručně.
• Netestováno na … – autor u verze neuvádí podporu vaší verze Minecraftu. Může fungovat, ale není to zaručené.
• Stabilní, Beta, Alpha – kanál vydání. Na server s hráči instalujte stabilní verze.

Ruční instalace#

Ruční nahrání použijte pro pluginy, které v katalogu nejsou, například placené pluginy.

1. Stáhněte plugin do počítače z oficiální stránky autora nebo z katalogu (Modrinth, Hangar, SpigotMC). Soubor musí mít příponu .jar. Pokud jste stáhli .zip, rozbalte ho v počítači a hledejte .jar uvnitř.
2. V zákaznické zóně přejděte na záložku Soubory a otevřete složku plugins.
3. Klikněte na Nahrát a vyberte soubor .jar. Můžete ho do seznamu i přetáhnout myší. Jeden soubor smí mít nejvýš 100 MB.
4. Restartujte server v záložce Konzole tlačítkem Restartovat.

Plugin musí ležet přímo ve složce plugins. Podsložky server nečte. V záložce Pluginy se ručně nahraný plugin zobrazí se štítkem Ručně nahráno. U takového pluginu zákaznická zóna nesleduje verzi ani aktualizace.

Ověření#

1. Po restartu sledujte konzoli. Úspěšně načtený plugin se ohlásí řádkem podobným tomuto:

   [12:00:08 INFO]: [LuckPerms] Enabling LuckPerms v<VERZE>

   Místo <VERZE> uvidíte číslo verze pluginu.

2. Zadejte v konzoli příkaz plugins. Vypíše seznam pluginů. Ve hře uvidíte barvy: zeleně pluginy, které běží, červeně pluginy, které se nepodařilo zapnout.

3. Podrobnosti o konkrétním pluginu ukáže příkaz version <NAZEV_PLUGINU>, například version LuckPerms.

Nastavení pluginu (config.yml)#

Většina pluginů si při prvním startu vytvoří složku plugins/<NAZEV_PLUGINU> a v ní soubor config.yml. Například LuckPerms má nastavení v plugins/LuckPerms/config.yml.

1. V záložce Konzole server vypněte tlačítkem Vypnout. Některé pluginy při vypnutí přepisují svůj soubor a vaše změny by se ztratily.
2. V záložce Soubory otevřete plugins/<NAZEV_PLUGINU>/config.yml a klikněte na Upravit.
3. Upravte hodnoty a uložte (Ctrl+S).
4. Server spusťte.

Soubory .yml jsou ve formátu YAML. Ten je citlivý na drobnosti:

# Řádek s mřížkou je komentář, server ho ignoruje.
nastaveni:
  zprava: "&aVítej na serveru!"
  max-domovu: 3
  zapnuto: true
  zakazane-svety:
    - world_nether
    - world_the_end

• Odsazení jen mezerami, nikdy tabulátorem. Tabulátor způsobí chybu načtení. Odsazení určuje, co patří pod co (zprava patří pod nastaveni).
• Za dvojtečkou vždy mezera: max-domovu: 3, ne max-domovu:3.
• Text se speciálními znaky dávejte do uvozovek. Hlavně text začínající &, obsahující : nebo #.
• Seznam je řada řádků začínajících pomlčkou a mezerou, odsazených pod klíčem.
• true a false znamenají zapnuto a vypnuto.

Aktualizace pluginů#

1. V záložce Pluginy zůstaňte na podzáložce Nainstalované.
2. Klikněte na Zkontrolovat aktualizace. Uvidíte buď „Všechno je aktuální.“, nebo „Dostupné aktualizace:“ s počtem.
3. U pluginu klikněte na Aktualizovat na …, zkontrolujte dialog a potvrďte Aktualizovat.
4. Restartujte server.

Před aktualizací si přečtěte seznam změn na stránce projektu (odkaz Stránka projektu). Hlavní verze (například z 2.x na 3.x) mohou změnit konfiguraci. Před větší aktualizací udělejte zálohu, viz Zálohy herních serverů. Ručně nahrané pluginy aktualizujete tak, že starý .jar smažete a nahrajete nový. Dva soubory stejného pluginu v jedné složce způsobí chybu.

Vypnutí a odebrání pluginu#

• Vypnout – plugin se při dalším startu nenačte, ale zůstane na disku i s nastavením. Soubor se přejmenuje na <soubor>.jar.disabled. Tlačítkem Zapnout ho vrátíte.
• Odebrat – smaže soubor pluginu ze složky plugins. Nastavení a data pluginu ve složce plugins/<NAZEV_PLUGINU> zůstanou, takže je po opětovné instalaci plugin najde.

Změny se projeví po restartu serveru.

Bezpečnost#

• Stahujte pluginy jen z katalogů (Modrinth, Hangar, SpigotMC) nebo z oficiální stránky autora.
• Nikdy neinstalujte „cracknuté“ nebo „leaknuté“ placené pluginy. Bývají upravené tak, aby útočník získal kontrolu nad serverem nebo operátorská práva.
• Neinstalujte pluginy, které už roky nikdo neaktualizoval. Často nefungují s novými verzemi a mají známé chyby.
• Pluginy, které dělají totéž, neinstalujte vedle sebe (například dva pluginy na oprávnění).

Ověřené tipy na pluginy najdete v článku Doporučené pluginy.

Když něco nefunguje#

Chyby pluginů hledejte v konzoli při startu serveru. Celý záznam je v souboru logs/latest.log (záložka Soubory).

Could not load 'plugins/….jar' in folder 'plugins' a UnknownDependencyException#

[00:00:00] [Server thread/WARN] Could not load 'plugins/MyAwesomePlugin-1.0.0.jar' in folder 'plugins'
[00:00:00] [Server thread/WARN] org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [Vault]. Please download and install these plugins to run 'MyAwesomePlugin'.

Pluginu chybí jiný plugin, na kterém závisí. V hranatých závorkách je jeho název (tady Vault). Nainstalujte ho a restartujte server.

Invalid plugin.yml#

Soubor není plugin pro Paper. Nejčastěji jde o mód pro Fabric nebo Forge, nebo o nedostažený soubor. Stáhněte správný soubor znovu.

Ambiguous plugin name#

Ve složce plugins jsou dvě verze stejného pluginu. Starší soubor smažte.

UnsupportedClassVersionError … class file version 69.0#

Plugin vyžaduje novější Javu, než na které server běží. Číslo verze třídy odpovídá Javě: 65 = Java 21, 69 = Java 25. Plugin je nejspíš určený pro novější verzi Minecraftu. Stáhněte verzi pluginu pro svou verzi Minecraftu, nebo server aktualizujte, viz Změna verze a softwaru.

Error occurred while enabling … (Is it up to date?)#

Plugin se načetl, ale při zapnutí spadl. Pod touto řádkou je výpis chyby. Nejčastější příčiny jsou nepodporovaná verze Minecraftu, chybějící závislost nebo chyba v jeho konfiguraci. Ověřte verzi pluginu a projděte jeho config.yml.

Plugin hlásí chybu v config.yml#

V konzoli uvidíte chybu YAML s číslem řádku, často InvalidConfigurationException, mapping values are not allowed here nebo zmínku o tabulátoru. Otevřete soubor a zkontrolujte daný řádek: tabulátor místo mezer, chybějící mezeru za dvojtečkou nebo text se speciálními znaky bez uvozovek.

Server po instalaci pluginu nenastartuje a nevíte, který to je#

Pluginy vypínejte po skupinách. V záložce Pluginy vypněte polovinu, restartujte a podle výsledku pokračujte s polovinou, ve které je problém. Ručně jde plugin vypnout přejmenováním souboru, například na Plugin.jar.disabled.

„Na serveru právě probíhá změna softwaru nebo instalace modpacku“#

Počkejte, až změna v záložce Software doběhne. Pak půjde pluginy upravovat.

Pokud chybu nevyřešíte, pošlejte nám soubor logs/latest.log, viz kontakt na podporu.

Další zdroje#

• Paper: přidání pluginů (otevře se v novém okně)
• Paper: základní řešení problémů (otevře se v novém okně)
• Hangar (otevře se v novém okně)
• Modrinth: pluginy (otevře se v novém okně)