Útmutató
Hogyan telepíts Minecraft-plugint
Frissítve: 2026. október 18.
Egy plugin telepítése egy perc: bedobsz egy .jar fájlt a szerver plugins/ mappájába, és újraindítasz. A legtöbb probléma a körülötte lévő lépésekből adódik: a szerver nem tud pluginokat futtatni, a plugin másik verzióhoz készült, vagy hiányzik egy függőség. Ez az útmutató mindegyiket sorra veszi.
Előbb próbáld ki egy tesztszerveren, aztán telepítsd a .jar fájlt.
Generáld ezt a Codexe-szelLépésről lépésre
1.Ellenőrizd, hogy a szervered tud-e pluginokat futtatni
A pluginokhoz Bukkit-alapú szerverszoftver kell: Paper, Spigot, Purpur vagy Folia játékszerverekhez, BungeeCord vagy Velocity proxykhoz. Egy vanilla szerver, illetve egy Fabric- vagy Forge-szerver nem tölt be pluginokat.
2.Ellenőrizd a plugin verzióját
A plugin oldala vagy fájlja megadja, mely Minecraft-verziókat támogatja. Egy, a szerverednél újabb verzióhoz készült plugin általában nem hajlandó betöltődni.
3.Állítsd le a szervert, és másold át a .jar fájlt
Tedd a .jar fájlt a szerver .jar mellett lévő
plugins/mappába. Hosztingpanelen töltsd fel a fájlkezelővel vagy SFTP-vel. Ne csomagold ki.4.Telepítsd a függőségeit
Ha a pluginnak más pluginok kellenek (Vault, PlaceholderAPI, ProtocolLib, LuckPerms), az ő .jar fájljaikat is tedd a
plugins/mappába.5.Indítsd el a szervert, és olvasd a konzolt
Keresd a plugin nevét az indítási naplóban. Az „Enabling <Plugin>” sor utána következő hiba nélkül azt jelenti, hogy betöltődött.
6.Ellenőrizd játékban, és konfiguráld
Futtasd a
/pluginsparancsot: a betöltött pluginok zöldek, a bekapcsolni nem sikerült pluginok pirosak. A beállításai aplugins/<PluginName>/config.ymlfájlban jelennek meg; szerkeszd őket, és indíts újra.
Hová kerülnek a fájlok
Egy tipikus szervermappa így néz ki az első indítás után egy pluginnal:
paper.jar(vagyspigot.jar): maga a szerver.plugins/MyPlugin.jar: a plugin, amelyet hozzáadtál.plugins/MyPlugin/: a plugin által létrehozott mappa aconfig.ymlfájllal, az üzenetekkel és a mentett adataival.logs/latest.log: az aktuális futás naplója, ide kerülnek a betöltési hibák.
Indíts újra, ne használd a /reload parancsot
A /reload a szerver újraindítása nélkül tölti ki és be újra az összes plugint. Sok plugin nem támogatja: a figyelők kétszer regisztrálódnak, adatok vesznek el, vagy memóriaszivárgás lép fel. Plugin hozzáadása, eltávolítása vagy frissítése után mindig indítsd újra a szervert. Egyes pluginoknak saját újratöltő parancsuk van (például /myplugin reload) csak a saját configjukhoz: azt nyugodtan használhatod.
Mielőtt az éles szerverre telepítenél
- Készíts biztonsági mentést a szervermappáról, vagy legalább a
plugins/mappáról és a világokról. - Előbb próbáld ki egy másolaton: ugyanazzal a szoftverrel, verzióval és más pluginokkal, mint a valódi szerver. Lásd: hogyan tesztelj plugint.
- Egyszerre egy plugint: ha valami elromlik, tudod, melyik okozta.
- A szerző oldaláról töltsd le (SpigotMC, Hangar, Modrinth, GitHub), ne újrafeltöltésekből.
Codexe-szel készült pluginok
A Codexe-en készült plugin a projektről elnevezett, buildelt .jar fájlként érkezik, amelyet átadás előtt ellenőrzünk: tartalmaznia kell a lefordított osztályokat és egy plugin.yml fájlt. Kipróbálhatod egy privát tesztszerveren, mielőtt bárhová telepítenéd, minden csomagban ingyen; a tesztszerver telepíti helyetted a függőségként felsorolt pluginokat. A .jar letöltéséhez a saját szerveredre csomag vagy letöltéscsomag kell.
Kérdések
Telepíthetek pluginokat vanilla szerverre?
Nem. Cseréld le a szerver .jar fájlját ugyanannak a Minecraft-verziónak a Paper (vagy Spigot) változatára; a világod tovább működik. Vanilla szerverekhez a datapack az alternatíva.
Telepíthetek pluginokat egyjátékos módban?
Nem, a pluginok csak szervereken futnak. A saját gépeden futtathatsz egy helyi Paper-szervert, és a localhost címen csatlakozhatsz rá.
Kell a játékosoknak bármit telepíteniük?
Nem. A pluginok csak a szerveren futnak: a játékosok a normál játékkal csatlakoznak. Csak a resource packet használó pluginok kérik a játékosokat, hogy fogadják el.
Miért piros a pluginom a /plugins listában?
Megtalálta a szerver, de nem sikerült bekapcsolni. Az ok közvetlenül előtte a konzolban áll: lásd: hogyan javítsd a pluginhibákat.
Készíts plugint, amelyet még ma telepíthetsz
Ez a prompt küldésre készen nyílik meg:
“Egy Paper 1.21.4 plugin JoinMessages néven: egyedi belépési és kilépési üzenetek a játékos nevével és az online létszámmal, eltérő üzenet az első belépéskor, üdvözlő cím, és minden üzenet és hang a config.yml-ben.”
Generáld ezt a Codexe-szel