Útmutató

Hogyan készíts egyedi tárgyakat pluginnal

Frissítve: 2026. október 18.

Az egyedi kardok, varázspálcák, kulcsok és eszközök a legkeresettebb pluginfunkciók közé tartoznak. Egy plugin nem tud valóban új tárgyat adni a játékhoz, de fogni tud egy vanilla tárgyat, nevet, lore-t és rejtett címkét adhat neki, és reagálhat, amikor egy játékos használja. A játékosok a normál játékkal csatlakoznak, modok nélkül.

Írd át a tárgyakat a sajátjaidra.

Generáld ezt a Codexe-szel

Lépésről lépésre

  1. 1.Sorold fel a tárgyakat

    Minden tárgyhoz: az alapanyag, a megjelenített név, a lore sorai és hogy mit csinál. „Egy Fire Wand nevű blaze rod, amely jobb kattintásra tűzgolyót lő, 5 másodperces cooldownnal” egy teljes tárgyleírás.

  2. 2.Címkézd őket PersistentDataContainerrel

    Tárolj egy azonosítót, például fire_wand, a tárgy PersistentDataContainer tárolójában egy NamespacedKey kulccsal. A plugin erről a címkéről ismeri fel a tárgyat, nem a nevéről, így ha valaki átnevezi egy üllőn, abból nem lesz másolat.

  3. 3.Írd meg a képességeket

    Minden képesség egy eseményfigyelő: PlayerInteractEvent a jobb kattintásokhoz, EntityDamageByEntityEvent a találatokhoz, BlockBreakEvent az eszközökhöz. Adj hozzá cooldownt játékosonként és tárgyanként.

  4. 4.Döntsd el, hogyan jutnak hozzá a játékosok

    Egy admin /give parancs, egy craftrecept, egy bolt, mobdropok vagy ládajutalmak.

  5. 5.Tegyél mindent konfigurálhatóvá

    Nevek, lore, sebzés, cooldownok és receptek a config.yml fájlban, így új build nélkül egyensúlyozhatod a tárgyakat.

  6. 6.Buildeld, és próbálj ki minden tárgyat

    Hagyd, hogy a Codexe lefordítsa a plugint, csatlakozz a tesztszerverre a Próbáld ki most gombbal, adj magadnak minden tárgyat, és használd őket.

Miért címke, és miért nem a név

A megjelenített név vagy a lore ellenőrzése a klasszikus hiba: bármelyik játékos átnevezhet egy botot „Fire Wand”-ra egy üllőn. A PersistentDataContainer (Minecraft 1.14 és újabb) olyan adatot tárol a tárgyon, amelyet a játékosok nem tudnak szerkeszteni, és túléli az újraindításokat, a ládákat és a cseréket, mert a tárgy része.

Az 1.8-tól 1.13-ig terjedő verziókban nincs PersistentDataContainer; a pluginok egy könyvtáron keresztül NBT-t vagy rejtett lore-jelölőt használnak. Írd bele a verziót a kérésbe, és a Codexe azt a megoldást írja meg, amelyet az a verzió támogat.

Képességek és a mögöttük álló események

KépességEseményMegjegyzések
Jobb kattintásos képességPlayerInteractEventEllenőrizd a kezet, kezenként egyszer fut le
Extra sebzés vagy effektek találatkorEntityDamageByEntityEventEllenőrizd, hogy a sebző egy játékos, aki a tárgyat tartja
Területi bányászóeszközBlockBreakEventTartsd tiszteletben a védelmi pluginokat, például a WorldGuardot
Passzív effekt, amíg a kezében tartjaIsmétlődő feladat vagy PlayerItemHeldEventTávolítsd el az effektet, amikor a tárgyat elteszi
Íj vagy lövedékEntityShootBowEvent, ProjectileHitEventCímkézd meg a lövedéket, hogy tudd, honnan jött

Textúrák és modellek

Egy plugin azt változtatja meg, mit csinál egy tárgy, nem azt, hogyan néz ki. Egyedi kinézethez resource pack kell, amelyet a játékosok letöltenek: régebbi verziókon a tárgy egy CustomModelData számot hordoz, amelyet a pack egy modellhez rendel, 1.21.2-től pedig a tárgy az item_model komponensen keresztül a saját modelljére is mutathat. Pack nélkül a tárgy az alapanyagának tűnik egyedi névvel, ami sok szervernek teljesen megfelel.

Példa leírás

„Egy Paper 1.21.4 plugin MagicItems néven. Három tárgy, mindegyik PersistentDataContainer-azonosítóval címkézve: Fire Wand (blaze rod, jobb kattintásra tűzgolyót lő, 5 mp cooldown), Frost Blade (vaskard, a találatok 3 mp-re Slowness II-t adnak), Miner's Pick (gyémántcsákány, 3x3-ban bányászik, de nem olyan WorldGuard-régiókban, ahol a játékos nem építhet). /mi give <player> <item> a magicitems.admin joghoz. Mindegyikhez alakos recept. Nevek, lore, cooldownok és receptek a config.yml-ben.”

Kérdések

Plugin vagy mod egyedi tárgyakhoz?

Plugin, ha a játékosoknak a normál játékkal kell csatlakozniuk: a tárgyak vanilla tárgyak új viselkedéssel. Mod, ha valóban új tárgyakra vagy blokkokra van szükséged saját megjelenítéssel, amelyet aztán minden játékos telepít. Lásd: plugin vagy mod.

Használhatom ItemsAdder vagy Nexo mellett?

A pluginod függhet tőlük, de ezek fizetős pluginok: a Codexe-tesztszerver nem tudja telepíteni őket, így egy plugin, amelynek valamelyik kell, ott nem kapcsol be. A plugin.yml fájlban felsorolt ingyenes függőségeket a tesztszerver telepíti helyetted.

Leállnak a tárgyak egy frissítés után?

A PersistentDataContainerrel címkézett tárgyak megőrzik a címkéjüket a Minecraft-frissítések során. A képességekhez az új API miatt új build kellhet; lásd: plugin frissítése.

Készítsd el az egyedi tárgyaidat

Ez a prompt küldésre készen nyílik meg:

“Egy Paper 1.21.4 plugin MagicItems néven, három PersistentDataContainerrel címkézett tárggyal: Fire Wand (blaze rod, jobb kattintásra tűzgolyót lő, 5 másodperces cooldown), Frost Blade (vaskard, találatkor 3 másodpercre Slowness II), Miner's Pick (gyémántcsákány, amely 3x3-ban bányászik). /mi give a magicitems.admin joghoz, mindegyikhez alakos recept, nevek, lore, cooldownok és receptek a config.yml-ben.”

Generáld ezt a Codexe-szel
Hogyan készíts egyedi tárgyakat Minecraft-pluginnal | Codexe