Pluginy
Následující část obsahuje informace o Bukkit pluginech.
Základní informace
Plugin se zapne při startu serveru. Při prvním startu pluginu se u většiny pluginů ve složce /plugins/ vytvoří složka s názvem pluginu, kde se nachází konfigurační soubory a ostatní soubory pluginu (např. databáze pluginu).
Plugin je samotný .jar soubor, nikoli složka, ta pouze obsahuje konfiguraci a ostatní data.
Pokud je určen pro Bukkit nebo Spigot, plugin je kompatibilní se Spigotem i jeho forky (Paper, Pufferfish, Purpur). Všechno to jsou totiž Bukkit pluginy, které všechny tyto platformy podporují.
Pokud máte potíže s funkčností pluginu, podívejte se na tuto část](#how-to-deal-with-issues).
Struktura složky /plugins/
Ve složce /plugins/ se nachází .jar soubory, což jsou samotné pluginy a složky s názvy pluginů. Tyto složky obsahují konfigurační soubory a data samotných pluginů.
Jak plugin nainstalovat
Plugin nainstalujete nahráním .jar souboru do složky /plugins/ a následným zapnutím nebo restartem serveru (nikoli reloadem!). Server musí běžet na platformě, která pluginy podporuje. To je Spigot (nedoporučuje se používat) a jeho forky jako Paper, Pufferfish, nebo Purpur. Více se o konkrétních platformách dočtete zde.
Při stahování pluginů si přečtěte základní informace na stránce pluginu - dbejte na použití správné verze pluginu a stáhnutí případných závislostí viz zde!
Plugin nefunguje
Po nahrání pluginu je pro projevení změn potřeba server restartovat.
Pokud plugin po restartuje nefunguje, jak řešit nefunkční plugin se dočtete zde.
Jak plugin aktualizovat/Jak změnit verzi pluginu
Pokud chcete aktualizovat plugin na platformě Paper, nebo jeho forku (Pufferfish, Purpur), na nových verzích stačí do složky /plugins/update/ (pokud složka neexistuje, vytvořte ji manuálně) nahrát novou verzi pluginu a při dalším startu serveru bude plugin nahrazen. Pokud složka update ve složce plugins neexistuje, je potřeba ji manuálně vytvořit.
Pokud server běží na platformě Spigot, případně CraftBukkit (což se ale rozhodně nedoporučuje!), stačí starou verzi pluginu smazat a novou nahrát, a to ideálně při vypnutém serveru. Změny se aplikují při dalším startu serveru (tzn. pokud server běží, je zapotřebí server restartovat).
Hledání pluginů
V případě, kdy hledáte plugin, největším pomocníkem, a prakticky jediný nástroj, který potřebujete, je Google. Používat instalátor pluginu v administračních panelech pro hledání pluginů není ideální.
Pluginy se nachází na mnoha místech - SpigotMC, DevBukkit (zejména u starších pluginů které existují už opravdu dlouho), Hangar, Modrinth, některé autoři zveřejňují na GitHubu, Polymart, BuiltByBit (na některých marketech jako třeba BBB nebo Polymart se mimo jiné neprodávají pouze pluginy ale i věci jako předpřipravená konfigurace pluginů nebo dokonce celého serveru, stavby, modely a podobně)
Hledat přímo na těchto fórech však není ideální. Nejrelevantnější výsledky Vám vrátí Google (když jej používáte správně). (Jste-li začátečník, může se hodit projít seznam nejvíce stahovaných pluginů na těchto fórech, ať máte nějaký přehled o základních pluginech. Mějte však napaměti, že SpigotMC a zejména DevBukkit existují opravdu dlouho, takže tam budou i staré, často neaktualizované pluginy, které již nepoužijete. Naopak Hangar a Modrinth jsou nové platformy).
Tato část obsahuje pouze největší základy používání Google vyhledávače - umět správně Googlit je dovednost, s kterou se nikdo nenarodí. Pár tipů, jak Google používat, naleznete v této části, nicméně je to téma o dost komplexnější. Pro základní vyhledávání pluginů by však tato část měla být naprosto dostačující. Pokud nepoužíváte blokátor reklam, reklamy zobrazované ve výsledcích při hledání pluginů ignorujte.
Pokud hledáte konkrétní plugin, stačí v Google vyhledat “<jméno pluginu> plugin”, takže například “WorldEdit plugin”, nebo “WorldGuard plugin”.
Pokud hledáte plugin s určitou funkcí, obvykle stačí vyhledat “<klíčové slovo/slova> plugin”, tedy například “ban plugin”. Pokud je klíčové slovo příliš obecné a ve výsledcích se nevyskytují především Minecraft pluginy, můžete přidat klíčové slovo “minecraft”, tedy např. “ban minecraft plugin”.
Samozřejmě ne vždy jsou všechny výsledky relevantní, a proto je důležité umět ty nerelevantní odfiltrovat, a to včetně zastaralých pluginů (tzn. pokud vidíte, že plugin byl naposledy aktualizován v roce 2015, přičemž datum poslední aktualizace a podporované verze dané verze pluginu téměř vždy najdete, pravděpodobně tento plugin používat nechcete viz zde).
Pokud chcete odfiltrovat velké množství zasatralých výsledků, použijte ve vyhledávání verzi Vašeho serveru, např. “ban plugin 1.20” (pozn.: obecně je ve vyhledávání lepší použít “obecnou” verzi místo specifické “subverze”, tedy např. použijte jen 1.20 místo 1.20.6). Tak se objeví výsledky, na jejichž stránce bylo zaindexováno “1.20”. To automaticky neznamená, že plugin musí být aktualizovaný na 1.20, ale obecně se ve výsledcích objeví větší množství aktuálních pluginů.
Přečtěte si na stránce pluginu základí informace - při stahování pluginů dbejte na použití správné verze pluginu a stáhnutí případných závislostí viz zde!
Různé soubory ke stáhnutí
Jak je psáno v úvodu - Pokud je plugin určen pro Bukkit/Spigot, plugin bude fungovat i na jeho forcích jako Paper, Pufferfish, nebo Purpur. Pokud tedy název souboru ke stáhnutí obsahuje slovo “Bukkit”, daný soubor je plugin.
Naopak pokud soubor v názvu obsahuje “CLI” (např. zde), “sources”, nebo “javadocs” (např. zde), nejedná se o plugin.
Slovo “legacy” označuje verzi pluginu určenou pro zastaralou verzi Minecraftu (pro jakou verzi je “legacy” verze určena bude nejpravděpoodbněji někde na stránce napsáno).
Závislosti
Mnoho pluginů vyžaduje k fungování jiný plugin. Takový plugin (který je vyžadován) se nazývá dependency (závislost). Může se jednat o knihovnu, která sama o sobě nic nedělá (např. ProtocolLib nebo CMILib), nebo jakýkoli normální plugin.
Pokud závislost nainstalovaná není, plugin který ji potřebuje, nebude fungovat.
Existuje i tzv. “měkká závislost” (softdependency), což je plugin, který není nutně k samotné funkčnosti pluginu závísícího na něm potřeba, avšak jeho přítomnost umožňuje určité funkce.
Seznam pluginů
K zobrazení všech nainstalovaných pluginů jednoduše proveďte příkaz pl nebo plugins. Pluginy které jsou zelené fungují, pluginy které jsou červené ne (jak řešit nefunkční plugin se dočtete zde).
Jak plugin nastavit
Budete-li chtít plugin konfigurovat, můžete tak udělat buď pomocí příkazů, které naleznete v dokumentaci pluginu (abyste mohli některé příkazy vykonat, musíte mít práva, tedy OP nebo nastavené permise viz výše), nebo pomocí konfiguračních souborů.
Pokud plugin konfigurační soubory generuje, při prvním startu pluginu se vytvoří ve složce /plugins/<plugin>/. Pro projevení změn v konfiguračních souborech je třeba server restartovat, nebo provést reload příkaz, pokud plugin takový příkaz má. Pokud plugin takový reload příkaz má, naleznete jej v dokumentaci daného pluginu. Například u pluginu EssentialsX je reload příkaz essentials reload, samotný příkaz reload nepoužívejte!)
Více se o konfiguračních souborech můžete dočíst zde.
Všechny věci jako příkazy, nastavení apod. jsou vždy specifické pro plugin. Proto pokud nevíte jak něco udělat, vždy hledejte v dokumentaci daného pluginu.
Na co si dát pozor
Rozhodně není dobrý nápad bezhlavě instalovat pluginy pomocí instalátoru pluginů ve webové administraci.
Když plugin vyhledáte, otevřte si jeho stránku a přečtěte si základní informace, abyste věděli, zda vůbec můžete plugin použít (pokud něčemu nerozumíte, použijte překladač).
Dbejte zejména na:
- Správnou verzi pluginu
Vždy zkontrolujte, zda plugin, který chcete použít, je kompatibilní s verzí Vašeho serveru viz zde.
- Zda plugin nepotřebuje závislosti
Pokud plugin k fungování potřebuje jiný plugin (což je celkem časté), bude to na stránce pluginu uvedeno.
- Všechny ostatní důležité
(zvýrazněné) informace, například minimální požadovaná verze Javy
Pozor - na platformě DevBukkit tlačítko Download Latest File stáhne poslední stabilní verzi, tím pádem to automaticky nemusí být úplně poslední verze v seznamu. Z toho důvodu je lepší použít tlačítko Download (File) přímo u dané verze pluginu.
Pokud používáte Minecraft verzi, která je nová a pluginy ji ještě nepodporují, můžete se podívat, zda již není dostupný dev (experimentální) build. Pokud není, nic s tím nenaděláte a musíte počkat na novou verzi.
Rovněž se podívejte, že plugin dělá to, co očekáváte. To, že má plugin v názvu WorldEdit (např. WorldEditCUI) automaticky neznamená, že je daný plugin WorldEdit.
Jak plugin odstranit
Plugin odstraníte smazáním pluginu ve složce /plugins/. Pokud server běží, pro projevení změn je zapotřebí server restartovat.
Plugin nejde smazat
Pro projevení změn po smazání pluginu ze souborů je zapotřebí server restartovat (nikoli reloadnout!).
Pokud plugin nejde smazat, ujistěte se, že mažete .jar soubor a nikoli složku. Ve složce se nacházejí konfigurační soubory a data pluginu, nikoli samotný plugin. Pokud data pluginu, který chcete smazat, již nebudete potřebovat, smažte i složku pluginu.
Od verze 1.21 je plugin Spark vestavěn v Paperu a ve výchozím nastavení je zaplý. To lze vypnout v Paper configu, avšak pro to není důvod vzhledem k tomu, že výkon serveru není nijak ovlivněn. Ve starších verzích je Spark také vestavěn v Purpuru (což lze vypnout nastavením -DPurpur.IReallyDontWantSpark flagu na true, ale jak již bylo zmíněno, není pro to důvod).
Jak plugin vypnout
Aby se plugin pokusil zapnout, musí být splněny dvě podmínky
- Plugin musí být nahrán ve složce
/plugins/ - Plugin musí mít příponu
.jar
Chcete-li plugin “vypnout”, stačí jej tedy přemístit ze složky /plugins/, nebo změnit koncovku například na jar-disabled, jarda nebo jarr. Po restartu serveru se plugin nezapne. V moment, kdy soubor pluginu přemístíte zpět do složky /plugins/ nebo změníte příponu zpět na ‘jar’, plugin se při startu serveru opět zapne.
Chcete-li vypnout všechny pluginy na serveru, jednoduše stačí složku /plugins/ přejmenovat např. na /plugins-disabled/ a po restartu serveru budou všechny pluginy vypnuté. Po přejmenování složky zpět na /plugins/ se po restartu všechny pluginy zapnou a vše bude v původním stavu.
Nastavení pluginu
Plugin se konfiguruje buď pomocí příkazů, které naleznete v dokumentaci daného pluginu], nebo pomocí konfiguračních souborů, ke kterým se dodatečné info dočtete rovněž v dokumentaci pluginu.
Vše je specifické pro plugin
Ačkoli různé pluginy často sdílí mnoho principů, je důležité si uvědomit, že každá funkce, příkaz i permise je specifická pro daný plugin.
Proto jsou otázky typu “jak udělat x”, “jaký je příkaz pro x”, “jaká je permise pro x” bez dalších informací o jaký plugin se jedná nedostatečná, jelikož vždy záleží na konkrétním pluginu. Vše co potřebujete vědět se téměř vždy dočtete v dokumentaci pluginu.
Reload pluginu
Nepoužívejte příkaz reload ani pluginy na reload konkrétních pluginů. Více se dočtete zde.
Crackování
Nepoužívejte cracklé pluginy viz zde.
Placené pluginy
Některé pluginy nejsou zdarma a jde je používat až po zakoupení licence. Někteří lidé si myslí, že placený automaticky znamená lepší. To ale není pravda. Hezky se o tom rozepsala Maddy Miller na jejím blogu: https://madelinemiller.dev/blog/premium-free-minecraft-plugins/
Jak ve svém článku shrnuje: “Celkově vzato, placené pluginy nejsou nutně lepší než ty bezplatné. Ve skutečnosti mají ty bezplatné několik výhod. Nejlepší plugin pro vás je téměř vždy ten, který dělá to, co chcete. Neměli byste používat placený plugin jen proto, že je placený, ale pokud pouze prémiový plugin dělá to, co potřebujete, je to pravděpodobně plugin pro Vás.” (upraveno)
Nejčastější problémy
Špatná verze pluginu
V případě, kdy na server instalujete plugin, je nutno stáhnout takovou verzi pluginu, která verzi serveru podporuje.
Proto se při stahování pluginu vždy koukněte, pro jakou verzi serveru je verze pluginu určena, nestahujte pluginy bezhlavě bez toho abyste si na stránce pluginu přečetli základní informace viz zde.
O tom jak zjistit zda verze pluginu verze serveru podporuje se dočtete zde.
Není výjimkou, když lidé stahují Citizens na Bukkitu (poslední aktualizace v roce 2014), Residence Reloaded na Spigotu (2015), nebo Essentials na Bukkit (2015) místo EssentialsX.
Chybějící závislosti (UnknownDependencyException)
Této chybě se dá téměř vždy vyvarovat přečtením základních informací na stránce pluginu viz zde.
V případě, kdy pluginu chybí závislost (tj. plugin k fungování potřebuje jiný plugin), setkáte se s podobnou chybou:
Could not load 'plugins/worldeditcui.jar' in folder 'plugins'
org.bukkit.plugin.UnknownDependencyException: WorldEdit
org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [Essentials]. Please download and install these plugins to run 'EssentialsChat'.
at io.papermc.paper.plugin.entrypoint.strategy.modern.ModernPluginLoadingStrategy.loadProviders(ModernPluginLoadingStrategy.java:82) ~[paper-1.20.4.jar:git-Paper-496]
at io.papermc.paper.plugin.storage.SimpleProviderStorage.enter(SimpleProviderStorage.java:38) ~[paper-1.20.4.jar:git-Paper-496]
at io.papermc.paper.plugin.entrypoint.LaunchEntryPointHandler.enter(LaunchEntryPointHandler.java:36) ~[paper-1.20.4.jar:git-Paper-496]
at org.bukkit.craftbukkit.v1_20_R3.CraftServer.loadPlugins(CraftServer.java:507) ~[paper-1.20.4.jar:git-Paper-496]
at net.minecraft.server.dedicated.DedicatedServer.initServer(DedicatedServer.java:274) ~[paper-1.20.4.jar:git-Paper-496]
at net.minecraft.server.MinecraftServer.runServer(MinecraftServer.java:1131) ~[paper-1.20.4.jar:git-Paper-496]
at net.minecraft.server.MinecraftServer.lambda$spin$0(MinecraftServer.java:319) ~[paper-1.20.4.jar:git-Paper-496]
at java.lang.Thread.run(Unknown Source) ~[?:?]
Chybu jednoduše opravíte nainstalováním potřebného pluginu