Inštalácia pluginov na Minecraft server (Paper, Purpur)

Pluginy pridávajú serveru príkazy, ochranu stavieb, ekonomiku, minihry a mnoho ďalšieho. Hráči si nič neinštalujú. Ukážeme inštaláciu jedným kliknutím priamo v zákazníckej zóne aj ručné nahranie súboru, nastavenie pluginu, aktualizácie a riešenie najčastejších chýb.

Skôr než začnete#

• Pluginy fungujú iba na Paperi, Purpure a Folii. Na Fabricu, Forge a NeoForge sa namiesto pluginov používajú mody a záložka sa volá Mody, pozrite Mody a modpacky. Vanilla nepodporuje ani jedno. Rozdiel vysvetľuje článok Pluginy, alebo mody?.
• Plugin musí podporovať vašu verziu Minecraftu. Plugin pre staršiu verziu sa často nenačíta alebo sa správa nepredvídateľne.
• Na Folii funguje iba menšina pluginov. Plugin musí podporu Folie výslovne uvádzať.
• Plugin smie na serveri všetko. Dokumentácia Paperu upozorňuje, že pluginy majú plný a neobmedzený prístup k serveru. Inštalujte iba pluginy z dôveryhodných zdrojov.

Inštalácia cez zákaznícku zónu#

1. Otvorte Moje služby, kliknite na server a prejdite na záložku Pluginy.

2. Kliknite na podzáložku Prechádzať. Bez hľadania uvidíte najsťahovanejšie pluginy pre váš typ a verziu servera.

3. V prepínači Zdroj zvoľte katalóg (vysvetlenie nižšie). Začnite s Modrinth.

4. Do poľa „Hľadať pluginy“ napíšte názov, napríklad LuckPerms, a kliknite na Hľadať.

5. Pri plugine kliknite na Inštalovať. Ak chcete inú než najnovšiu verziu, kliknite najprv na Verzie a vyberte ju zo zoznamu.

6. Prezrite si dialóg Inštalácia …:

   • Hlavný súbor – súbor pluginu, ktorý sa nahrá do priečinka plugins.
   • Povinné závislosti – ďalšie pluginy, bez ktorých sa plugin nespustí. Zákaznícka zóna ich nainštaluje s ním. Odškrtnite iba tie, ktoré už na serveri máte nahrané ručne.
   • Upozornenia na súbory s rovnakým názvom, ktoré inštalácia prepíše, a na pluginy, s ktorými podľa autora nefunguje.
   • Na stiahnutie – celková veľkosť.

7. Kliknite na Nainštalovať.

   Po dokončení uvidíte hlášku Nainštalované: so zoznamom súborov a upozornenie „Zmeny sa prejavia po reštarte servera“.

8. Kliknite na Reštartovať a potvrďte. Pluginy sa načítavajú iba pri štarte servera.

Zdroje pluginov#

Kontrolný súčet potvrdzuje, že súbor na server dorazil presne taký, aký autor zverejnil. Plugin, ktorý je iba na SpigotMC alebo na webe autora, nahrajte ručne, pozrite Ručná inštalácia.

Ďalšie štítky vo výsledkoch:

• Len externe – autor súbor hostuje inde (často platené pluginy). Automaticky ho nainštalovať nejde, stiahnite ho z autorovej stránky a nahrajte ručne.
• Netestované na … – autor pri verzii neuvádza podporu vašej verzie Minecraftu. Môže fungovať, ale nie je to zaručené.
• Stabilná, Beta, Alpha – kanál vydania. Na server s hráčmi inštalujte stabilné verzie.

Ručná inštalácia#

Ručné nahranie použite pre pluginy, ktoré v katalógu nie sú, napríklad platené pluginy.

1. Stiahnite plugin do počítača z oficiálnej stránky autora alebo z katalógu (Modrinth, Hangar, SpigotMC). Súbor musí mať príponu .jar. Ak ste stiahli .zip, rozbaľte ho v počítači a hľadajte .jar vnútri.
2. V zákazníckej zóne prejdite na záložku Súbory a otvorte priečinok plugins.
3. Kliknite na Nahrať a vyberte súbor .jar. Môžete ho do zoznamu aj pretiahnuť myšou. Jeden súbor smie mať najviac 100 MB.
4. Reštartujte server v záložke Konzola tlačidlom Reštartovať.

Plugin musí ležať priamo v priečinku plugins. Podpriečinky server nečíta. V záložke Pluginy sa ručne nahraný plugin zobrazí so štítkom Ručne nahrané. Pri takom plugine zákaznícka zóna nesleduje verziu ani aktualizácie.

Overenie#

1. Po reštarte sledujte konzolu. Úspešne načítaný plugin sa ohlási riadkom podobným tomuto:

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

   Namiesto <VERZE> uvidíte číslo verzie pluginu.

2. Zadajte v konzole príkaz plugins. Vypíše zoznam pluginov. V hre uvidíte farby: nazeleno pluginy, ktoré bežia, načerveno pluginy, ktoré sa nepodarilo zapnúť.

3. Podrobnosti o konkrétnom plugine ukáže príkaz version <NAZEV_PLUGINU>, napríklad version LuckPerms.

Nastavenie pluginu (config.yml)#

Väčšina pluginov si pri prvom štarte vytvorí priečinok plugins/<NAZEV_PLUGINU> a v ňom súbor config.yml. Napríklad LuckPerms má nastavenia v plugins/LuckPerms/config.yml.

1. V záložke Konzola server vypnite tlačidlom Vypnúť. Niektoré pluginy pri vypnutí prepisujú svoj súbor a vaše zmeny by sa stratili.
2. V záložke Súbory otvorte plugins/<NAZEV_PLUGINU>/config.yml a kliknite na Upraviť.
3. Upravte hodnoty a uložte (Ctrl+S).
4. Server spustite.

Súbory .yml sú vo formáte YAML. Ten je citlivý na drobnosti:

# Riadok s mriežkou je komentár, server ho ignoruje.
nastaveni:
  zprava: "&aVitaj na serveri!"
  max-domovu: 3
  zapnuto: true
  zakazane-svety:
    - world_nether
    - world_the_end

• Odsadenie iba medzerami, nikdy tabulátorom. Tabulátor spôsobí chybu načítania. Odsadenie určuje, čo patrí pod čo (zprava patrí pod nastaveni).
• Za dvojbodkou vždy medzera: max-domovu: 3, nie max-domovu:3.
• Text so špeciálnymi znakmi dávajte do úvodzoviek. Hlavne text začínajúci &, obsahujúci : alebo #.
• Zoznam je rad riadkov začínajúcich pomlčkou a medzerou, odsadených pod kľúčom.
• true a false znamenajú zapnuté a vypnuté.

Aktualizácia pluginov#

1. V záložke Pluginy zostaňte na podzáložke Nainštalované.
2. Kliknite na Skontrolovať aktualizácie. Uvidíte buď „Všetko je aktuálne.“, alebo „Dostupné aktualizácie:“ s počtom.
3. Pri plugine kliknite na Aktualizovať na …, skontrolujte dialóg a potvrďte Aktualizovať.
4. Reštartujte server.

Pred aktualizáciou si prečítajte zoznam zmien na stránke projektu (odkaz Stránka projektu). Hlavné verzie (napríklad z 2.x na 3.x) môžu zmeniť konfiguráciu. Pred väčšou aktualizáciou urobte zálohu, pozrite Zálohy herných serverov. Ručne nahrané pluginy aktualizujete tak, že starý .jar zmažete a nahráte nový. Dva súbory rovnakého pluginu v jednom priečinku spôsobia chybu.

Vypnutie a odobratie pluginu#

• Vypnúť – plugin sa pri ďalšom štarte nenačíta, ale zostane na disku aj s nastaveniami. Súbor sa premenuje na <soubor>.jar.disabled. Tlačidlom Zapnúť ho vrátite.
• Odobrať – zmaže súbor pluginu z priečinka plugins. Nastavenia a dáta pluginu v priečinku plugins/<NAZEV_PLUGINU> zostanú, takže ich plugin po opätovnej inštalácii nájde.

Zmeny sa prejavia po reštarte servera.

Bezpečnosť#

• Sťahujte pluginy iba z katalógov (Modrinth, Hangar, SpigotMC) alebo z oficiálnej stránky autora.
• Nikdy neinštalujte „cracknuté“ alebo „leaknuté“ platené pluginy. Bývajú upravené tak, aby útočník získal kontrolu nad serverom alebo operátorské práva.
• Neinštalujte pluginy, ktoré už roky nikto neaktualizoval. Často nefungujú s novými verziami a majú známe chyby.
• Pluginy, ktoré robia to isté, neinštalujte vedľa seba (napríklad dva pluginy na oprávnenia).

Overené tipy na pluginy nájdete v článku Odporúčané pluginy.

Keď niečo nefunguje#

Chyby pluginov hľadajte v konzole pri štarte servera. Celý záznam je v súbore logs/latest.log (záložka Súbory).

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 chýba iný plugin, od ktorého závisí. V hranatých zátvorkách je jeho názov (tu Vault). Nainštalujte ho a reštartujte server.

Invalid plugin.yml#

Súbor nie je plugin pre Paper. Najčastejšie ide o mod pre Fabric alebo Forge, alebo o nedostiahnutý súbor. Stiahnite správny súbor znova.

Ambiguous plugin name#

V priečinku plugins sú dve verzie rovnakého pluginu. Starší súbor zmažte.

UnsupportedClassVersionError … class file version 69.0#

Plugin vyžaduje novšiu Javu, než na akej server beží. Číslo verzie triedy zodpovedá Jave: 65 = Java 21, 69 = Java 25. Plugin je najskôr určený pre novšiu verziu Minecraftu. Stiahnite verziu pluginu pre svoju verziu Minecraftu, alebo server aktualizujte, pozrite Zmena verzie a softvéru.

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

Plugin sa načítal, ale pri zapnutí spadol. Pod týmto riadkom je výpis chyby. Najčastejšie príčiny sú nepodporovaná verzia Minecraftu, chýbajúca závislosť alebo chyba v jeho konfigurácii. Overte verziu pluginu a prejdite jeho config.yml.

Plugin hlási chybu v config.yml#

V konzole uvidíte chybu YAML s číslom riadku, často InvalidConfigurationException, mapping values are not allowed here alebo zmienku o tabulátore. Otvorte súbor a skontrolujte daný riadok: tabulátor namiesto medzier, chýbajúcu medzeru za dvojbodkou alebo text so špeciálnymi znakmi bez úvodzoviek.

Server po inštalácii pluginu nenaštartuje a neviete, ktorý to je#

Pluginy vypínajte po skupinách. V záložke Pluginy vypnite polovicu, reštartujte a podľa výsledku pokračujte s polovicou, v ktorej je problém. Ručne možno plugin vypnúť premenovaním súboru, napríklad na Plugin.jar.disabled.

„Na serveri práve prebieha zmena softvéru alebo inštalácia modpacku“#

Počkajte, kým zmena v záložke Softvér dobehne. Potom pôjde pluginy upravovať.

Ak chybu nevyriešite, pošlite nám súbor logs/latest.log, pozrite kontakt na podporu.

Ďalšie zdroje#

• Paper: pridanie pluginov (otvorí sa v novom okne)
• Paper: základné riešenie problémov (otvorí sa v novom okne)
• Hangar (otvorí sa v novom okne)
• Modrinth: pluginy (otvorí sa v novom okne)