Opas

Miten tehdä mukautettuja esineitä pluginilla

Päivitetty 18. lokakuuta 2026

Mukautetut miekat, sauvat, avaimet ja työkalut ovat pluginien toivotuimpia ominaisuuksia. Plugin ei voi lisätä peliin täysin uutta esinettä, mutta se voi ottaa vanilla-esineen, antaa sille nimen, kuvauksen ja piilotetun tunnisteen ja reagoida, kun pelaaja käyttää sitä. Pelaajat liittyvät tavallisella pelillä, modeja ei tarvita.

Vaihda esineet omiksesi.

Generoi tämä Codexella

Vaihe vaiheelta

  1. 1.Listaa esineet

    Kullekin esineelle: perusmateriaali, näyttönimi, kuvausrivit ja mitä se tekee. "Roihusauva nimeltä Fire Wand, joka ampuu tulipallon oikealla klikkauksella, 5 sekunnin jäähdytysaika" on valmis esine.

  2. 2.Merkitse ne PersistentDataContainerilla

    Tallenna tunniste, kuten fire_wand, esineen PersistentDataContainer-säiliöön NamespacedKey-avaimella. Plugin tunnistaa esineen tästä tunnisteesta eikä nimestä, joten sen uudelleennimeäminen alasimella ei luo kopiota.

  3. 3.Kirjoita kyvyt

    Jokainen kyky on tapahtumankuuntelija: PlayerInteractEvent oikeille klikkauksille, EntityDamageByEntityEvent osumille, BlockBreakEvent työkaluille. Lisää jäähtymisajat pelaajakohtaisesti ja esinekohtaisesti.

  4. 4.Päätä, miten pelaajat saavat ne

    Ylläpitäjän /give-komento, valmistusresepti, kauppa, mobien pudotukset tai laatikkopalkinnot.

  5. 5.Tee kaikesta muokattavaa

    Nimet, kuvaukset, vahinko, jäähtymisajat ja reseptit tiedostoon config.yml, jotta voit tasapainottaa esineitä ilman uutta koontia.

  6. 6.Kokoa ja kokeile jokaista esinettä

    Anna Codexen kääntää plugin, liity testipalvelimelle Kokeile heti -toiminnolla, anna itsellesi jokainen esine ja käytä sitä.

Miksi tunniste eikä nimi

Näyttönimen tai kuvauksen tarkistaminen on klassinen virhe: kuka tahansa alasimella varustettu pelaaja voi nimetä kepin "Fire Wandiksi". PersistentDataContainer (Minecraft 1.14 ja uudemmat) tallentaa esineeseen tietoa, jota pelaajat eivät voi muokata, ja se säilyy uudelleenkäynnistysten, arkkujen ja vaihtokauppojen yli, koska se on osa esinettä.

Versioissa 1.8-1.13 ei ole PersistentDataContaineria; pluginit käyttävät NBT:tä kirjaston kautta tai piilotettua merkintää kuvauksessa. Kerro versio pyynnössä, niin Codexe kirjoittaa sen tavan, jota kyseinen versio tukee.

Kyvyt ja niiden taustalla olevat tapahtumat

KykyTapahtumaHuomiot
Oikean klikkauksen voimaPlayerInteractEventTarkista käsi, tapahtuma laukeaa kerran kummallekin kädelle
Lisävahinkoa tai efektejä osuessaEntityDamageByEntityEventTarkista, että vahingon tekijä on pelaaja, joka pitää esinettä
Alueen louhintatyökaluBlockBreakEventKunnioita suojauspluginien, kuten WorldGuardin, alueita
Passiivinen efekti kädessä pidettäessäToistuva tehtävä tai PlayerItemHeldEventPoista efekti, kun esine laitetaan pois
Jousi tai ammusEntityShootBowEvent, ProjectileHitEventMerkitse ammus, jotta tiedät, mistä se tuli

Tekstuurit ja mallit

Plugin muuttaa sitä, mitä esine tekee, ei sitä, miltä se näyttää. Mukautettu ulkoasu vaatii resurssipaketin, jonka pelaajat lataavat: vanhemmissa versioissa esineellä on CustomModelData-numero, jonka paketti yhdistää malliin, ja versiosta 1.21.2 alkaen esine voi myös osoittaa omaan malliinsa item_model-komponentin kautta. Ilman pakettia esine näyttää perusmateriaaliltaan mukautetulla nimellä, mikä riittää monille palvelimille.

Esimerkkikuvaus

"Paper 1.21.4 -plugin nimeltä MagicItems. Kolme esinettä, joista jokainen on merkitty PersistentDataContainer-tunnisteella: Fire Wand (roihusauva, oikea klikkaus ampuu tulipallon, 5 s jäähdytysaika), Frost Blade (rautamiekka, osumat antavat Slowness II:n 3 sekunniksi), Miner's Pick (timanttihakku, rikkoo 3x3 mutta ei WorldGuard-alueilla, joilla pelaaja ei voi rakentaa). /mi give <player> <item> oikeudella magicitems.admin. Muotoreseptit kullekin. Nimet, kuvaukset, jäähtymisajat ja reseptit config.yml-tiedostossa."

Kysymykset

Plugin vai modi mukautetuille esineille?

Plugin, jos pelaajien pitäisi liittyä tavallisella pelillä: esineet ovat vanilla-esineitä uudella toiminnalla. Modi, jos tarvitset aidosti uusia esineitä tai kuutioita omalla renderöinnillään, jolloin jokainen pelaaja asentaa sen. Katso plugin vai modi.

Voinko käyttää sen kanssa ItemsAdderia tai Nexoa?

Pluginisi voi riippua niistä, mutta ne ovat maksullisia plugineja: Codexen testipalvelin ei voi asentaa niitä, joten niitä vaativa plugin ei käynnisty siellä. Tiedostossa plugin.yml listatut ilmaiset riippuvuudet asennetaan testipalvelimelle puolestasi.

Lakkaavatko esineet toimimasta päivityksen jälkeen?

PersistentDataContainerilla merkityt esineet säilyttävät tunnisteensa Minecraft-päivitysten yli. Kyvyt saattavat vaatia uuden koonnin uudelle API:lle; katso pluginin päivitys.

Tee omat mukautetut esineesi

Tämä kehote aukeaa valmiina lähetettäväksi:

“Paper 1.21.4 -plugin nimeltä MagicItems, jossa on kolme PersistentDataContainerilla merkittyä esinettä: Fire Wand (roihusauva, oikea klikkaus ampuu tulipallon, 5 sekunnin jäähdytysaika), Frost Blade (rautamiekka, Slowness II 3 sekunniksi osuessa), Miner's Pick (timanttihakku, joka louhii 3x3). /mi give oikeudella magicitems.admin, muotoresepti kullekin, nimet, kuvaukset, jäähtymisajat ja reseptit config.yml-tiedostossa.”

Generoi tämä Codexella
Miten tehdä mukautettuja esineitä Minecraft-pluginilla | Codexe