Hogyan telepíts pluginokat egy Minecraft szerverre (Paper és Spigot)

Pluginok kontra modok: mi a különbség?

Mielőtt bármit letöltenél, győződj meg róla, hogy valóban pluginra van szükséged. Az emberek gyakran szinonimaként használják a plugin és a mod szavakat, de egy szerveren ez két teljesen különböző dolog.

A pluginok a Bukkit API-hoz kapcsolódnak, amelyet a Paper és a Spigot biztosít. Kizárólag a szerveren futnak, így a játékosaid egy sima Minecraft klienssel csatlakoznak, és soha nem töltenek le semmit — pontosan ezért olyan könnyű futtatni és növelni egy pluginos szervert.

A modok egészen más világ: magát a játékklienst változtatják meg, így a szervernek és minden egyes játékosnak ugyanazt a loadert és ugyanazt a modlistát kell futtatnia, amit általában modpackként adnak ki együtt. Ha ezt keresed, ez nem a megfelelő útmutató — nézd meg inkább, hogyan készíts modolt Minecraft szervert. A loaderek teljes összehasonlításáért és hogy melyik mire való, lásd a legjobb Minecraft szerver szoftver útmutatót.

Mielőtt elkezdenéd: futtass Papert vagy Spigotot

A pluginok csak olyan szerveren töltődnek be, amely támogatja a Bukkit API-t. A Mojang vanilla server.jar fájlja nem ilyen — tegyél mellé egy plugint, és semmi nem történik. Az alábbiak egyikére van szükséged:

• Paper — a szokásos választás. Ez a leggyorsabb a családban, aktívan fejlesztik, és kompatibilis a hatalmas Bukkit/Spigot plugin ökoszisztémával. Innen érdemes kezdeni.
• Spigot — a régebbi alap, amelyhez a legtöbb plugin még mindig igazodik és amely ellen tesztelik. A Paper ennek egy kibővített, kompatibilis változata, így egy „Spigothoz" jelölt plugin Paperen is fut.
• Purpur — a Paper egy forkja extra játékmenet-kapcsolókkal. Ugyanazok a pluginok, néhány extra beállítással.

Ha még vanillán vagy, a váltás gyors. Egy HytHost Minecraft csomagon a GameCP panel beépített verzióváltóval rendelkezik: válaszd ki a Papert (vagy Spigotot/Purpurt) és a Minecraft verziót, kattints egyet, és a megfelelő build magától települ — a világod érintetlen marad. Inkább saját magad üzemeltetnéd? Töltsd le a Paper jart, és indítsd el a vanilla helyett. Ha segítségre van szükséged a vanilla, Paper, Forge és Fabric közti választáshoz, olvasd el a legjobb Minecraft szerver szoftver útmutatót; ha még nem hoztál létre szervert, kezdd a hogyan készíts Minecraft szervert cikkel.

Hogyan telepíts egy plugint, lépésről lépésre

Ha a Paper vagy Spigot már fut, egy plugin telepítése néhány rövid lépésből áll. Az egész pár percet vesz igénybe.

1. Töltsd le a plugin JAR fájlját megbízható forrásból. A pluginok elismert forrásai a SpigotMC, a Modrinth és a Hangar (PaperMC). Töltsd le a .jar fájlt, és győződj meg róla, hogy az oldal jelzi a támogatást a Minecraft verziódhoz — az 1.20-hoz készült plugin általában nem töltődik be 1.21-en.
2. Töltsd fel a plugins mappába. Nyisd meg a panel Files fülét, lépj be a plugins könyvtárba, és töltsd fel a JAR-t — a drag and drop is működik. Egyszerre sokat telepítenél? Csatlakozz SFTP-n keresztül a panelben található hitelesítő adatokkal, és másold be őket közvetlenül a plugins mappába. Saját üzemeltetés esetén a plugins mappa a server.jar mellett található.
3. Indítsd újra a szervert. A pluginok csak induláskor töltődnek be, ezért kattints a Restart gombra a panelben — egy egyszerű reload nem veszi észre az újonnan hozzáadott plugint. Figyeld a konzolt indulás közben: minden plugin jelzi magát, amint bekapcsol.
4. Ellenőrizd, hogy betöltődött-e. A konzol parancssorába írd be a /plugins parancsot (vagy a rövidebb /pl formát). Az új pluginnak meg kell jelennie a listában, zöld színnel kiírva. A zöld azt jelenti, betöltődött és fut; a piros azt, hogy hibás — ha ezt látod, ugorj a hibaelhárítás részhez.
5. Állítsd be. Az első sikeres indítás létrehozza a plugins/<PluginName>/config.yml fájlt. Szerkeszd ezt a fájlt a fájlkezelőben a plugin finomhangolásához, majd futtasd a reload parancsát, vagy indítsd újra a szervert. A YAML kényes a szóközökre — mindig szóközzel tagolj, soha ne tabbal, különben a fájl nem lesz értelmezhető.

Alap pluginok, amiket érdemes elsőként telepíteni

Egy egész hétvégét eltölthetsz pluginok böngészésével, de szinte minden jól vezetett survival vagy SMP szerver ugyanarra a rövid listára épül. Ezeket telepítsd először:

• EssentialsX — a svájci bicska: /home, /spawn, /tpa, kitek, warpok, egy induló gazdaság és tucatnyi mindennapi parancs. Ha csak egy plugint telepítesz, ezt telepítsd.
• LuckPerms — a jogosultságkezelő. Ez dönti el, ki milyen parancsokat futtathat, és rangokat, csoportokat ad neked. A legtöbb más plugin ehhez kapcsolódik, így gyakorlatilag kötelező, amint egynél több adminod van.
• WorldEdit + WorldGuard — a WorldEdit gyors terepépítést és -szerkesztést tesz lehetővé; a WorldGuard régiókat (spawn, boltok, arénák) véd a griefeléstől, és PvP zónákat szabályoz. Párban jönnek.
• Vault — egy csendes híd-plugin, amely lehetővé teszi, hogy a gazdasági, jogosultsági és chat pluginok kommunikáljanak egymással. Több plugin is függőségként sorolja fel; telepítsd, és felejtsd el.
• CoreProtect — blokknaplózás és visszaállítás. Ha egy griefer eltalálja a spawnodat, a CoreProtect pontosan megmutatja, ki mit tett, és másodpercek alatt visszaállítja. Telepítsd, mielőtt szükséged lenne rá.

Megjegyzés a jogosultságokról: alapból a legtöbb parancs-plugin csak a szerver operátoraira reagál. Ahhoz, hogy egy normál rang használhasson valamit, mint például a /home-ot, meg kell adnod a megfelelő jogosultsági node-ot (itt essentials.home) a csoportjuknak a LuckPermsben. Ez szinte mindenkit egyszer megfog — amikor egy parancs „nem csinál semmit" egy sima játékosnál, szinte mindig hiányzó jogosultságról van szó, nem hibás pluginról.

Minden hozzáadott plugin egy kis memóriát használ, ezért egy forgalmas pluginos szervernek több tartalékra van szüksége, mint a sima vanillának — számolj 4-6 GB-tal egy Paper szerverhez, amely a fenti alapokat futtatja. Ha nem vagy biztos benne, mennyit adj neki, a mennyi RAM kell egy Minecraft szervernek útmutatónk játékosszám és beállítás szerint lebontva mutatja.

Pluginok frissítése és eltávolítása

A pluginok csupán fájlok egyetlen mappában, ami egyszerűvé teszi a karbantartást.

Plugin frissítése

Töltsd le az új verziót, töröld a régi JAR-t a plugins mappából (hagyd érintetlenül a plugin konfigurációs mappáját, hogy a beállításaid megmaradjanak), töltsd fel az új JAR-t, majd indítsd újra a szervert. Fontos, hogy a pluginok naprakészek legyenek: egy elavult plugin a szokásos bűnös, amikor egy szerver közvetlenül egy Minecraft verzióváltás után elromlik, ezért frissítsd a pluginjaidat, amikor a Minecraft verziót módosítod.

Plugin eltávolítása

Indítsd újra vagy állítsd le a szervert, töröld a plugin JAR-ját a plugins mappából, és a következő indításnál már el is tűnt. A konfigurációs mappája a plugins/<PluginName> alatt megmarad, hacsak azt is nem törlöd — nem baj, ha ott hagyod, de ha véglegesen végeztél a pluginnal, érdemes rendet tenni.

Nem töltődik be a plugin? Így javítsd meg

Amikor egy plugin pirosan jelenik meg a /plugins listában, vagy egyáltalán nem csinál semmit, az ok szinte mindig néhány dolog egyike. Haladj végig rajtuk sorban:

1. Verzió-eltérés. A legfőbb ok. Ellenőrizd a plugin oldalát a szervered Minecraft verziójával szemben — az 1.20-hoz készült JAR gyakran nem kapcsol be 1.21-en, és fordítva is igaz. Töltsd le a megfelelő buildet, vagy állítsd a szerver verzióját a pluginhoz igazodóra.
2. Hiányzó függőség. Sok pluginnak szüksége van egy mellé telepített segédre — Vault a gazdasági pluginokhoz, egy gazdasági plugin egy bolthoz, egy adott könyvtár. A konzol megnevezi neked: keresd az ilyen sort: Unknown/missing dependency plugins: [Vault]. Telepítsd, amit kér, és indítsd újra.
3. Rossz szerver típus. Ha egyáltalán semmi nem töltődik be, ellenőrizd, hogy valóban Paperen vagy Spigoton vagy-e, nem vanillán — a pluginoknak szükségük van a Bukkit API-ra. A verzióváltó megmutatja, mit futtatsz.
4. Hibás konfiguráció. Egyetlen rosszul behúzott sor a config.yml-ben leállíthatja a plugint. A konzol hibaüzenete általában megmutatja a sort és az oszlopot. Javítsd ki a YAML-t (szóközök, soha ne tabok), vagy töröld a konfigurációs fájlt, és hagyd, hogy a plugin újragenerálja a tiszta változatot a következő újraindításkor.

A konzol itt a legjobb barátod. Bármi is hibázott, a szerver indításkor kiírja az okot — egy piros ERROR vagy WARN sor, amely megnevezi a plugint és a problémát. Olvasd felülről lefelé; az első hiba általában a valódi ok.