Guida
Come creare oggetti personalizzati con un plugin
Aggiornato il 18 ottobre 2026
Spade, bacchette, chiavi e attrezzi personalizzati sono tra le funzioni più richieste nei plugin. Un plugin non può aggiungere al gioco un oggetto davvero nuovo, ma può prendere un oggetto vanilla, dargli un nome, una lore e un tag nascosto e reagire quando un giocatore lo usa. I giocatori entrano con il gioco normale, senza mod.
Sostituisci gli oggetti con i tuoi.
Generalo con CodexePasso per passo
1.Elenca gli oggetti
Per ogni oggetto: il materiale di base, il nome visualizzato, le righe di lore e cosa fa. "Una verga di blaze chiamata Bacchetta di Fuoco che spara una palla di fuoco con il clic destro, cooldown di 5 secondi" è un oggetto completo.
2.Marcali con il PersistentDataContainer
Salva un id come
fire_wandnelPersistentDataContainerdell'oggetto con unaNamespacedKey. Il plugin riconosce l'oggetto da quel tag, non dal nome, quindi rinominarlo in un'incudine non crea una copia.3.Scrivi le abilità
Ogni abilità è un listener di eventi:
PlayerInteractEventper i clic destri,EntityDamageByEntityEventper i colpi,BlockBreakEventper gli attrezzi. Aggiungi cooldown per giocatore e per oggetto.4.Decidi come li ottengono i giocatori
Un comando admin
/give, una ricetta di crafting, un negozio, drop dei mob o premi delle casse.5.Rendi tutto configurabile
Nomi, lore, danni, cooldown e ricette in
config.yml, così puoi bilanciare gli oggetti senza una nuova build.6.Compila e prova ogni oggetto
Lascia che Codexe compili il plugin, entra nel server di prova con Provalo subito, datti ogni oggetto e usalo.
Perché un tag e non il nome
Controllare il nome visualizzato o la lore è l'errore classico: qualsiasi giocatore con un'incudine può rinominare un bastone in "Bacchetta di Fuoco". Il PersistentDataContainer (Minecraft 1.14 e successive) salva sull'oggetto dati che i giocatori non possono modificare, e resiste a riavvii, casse e scambi perché fa parte dell'oggetto.
Dalla 1.8 alla 1.13 il PersistentDataContainer non esiste; i plugin usano l'NBT tramite una libreria o un marcatore nascosto nella lore. Scrivi la versione nella richiesta e Codexe usa il metodo che quella versione supporta.
Le abilità e gli eventi dietro di loro
| Abilità | Evento | Note |
|---|---|---|
| Potere con clic destro | PlayerInteractEvent | Controlla la mano: scatta una volta per mano |
| Danni o effetti extra al colpo | EntityDamageByEntityEvent | Controlla che chi colpisce sia un giocatore con l'oggetto in mano |
| Attrezzo che scava ad area | BlockBreakEvent | Rispetta i plugin di protezione come WorldGuard |
| Effetto passivo mentre lo tieni in mano | Un task ripetuto o PlayerItemHeldEvent | Togli l'effetto quando l'oggetto viene messo via |
| Arco o proiettile | EntityShootBowEvent, ProjectileHitEvent | Marca il proiettile per sapere da dove arriva |
Texture e modelli
Un plugin cambia cosa fa un oggetto, non il suo aspetto. Un aspetto personalizzato richiede una resource pack che i giocatori scaricano: nelle versioni più vecchie l'oggetto porta un numero CustomModelData che la pack associa a un modello, e dalla 1.21.2 un oggetto può anche puntare al proprio modello con il componente item_model. Senza pack l'oggetto ha l'aspetto del materiale di base con un nome personalizzato, e per molti server va benissimo.
Esempio di descrizione
"Un plugin per Paper 1.21.4 chiamato MagicItems. Tre oggetti, ognuno marcato con un id nel PersistentDataContainer: Fire Wand (verga di blaze, il clic destro spara una palla di fuoco, cooldown di 5 s), Frost Blade (spada di ferro, i colpi danno Lentezza II per 3 s), Miner's Pick (piccone di diamante, rompe 3x3 ma non nelle regioni WorldGuard in cui il giocatore non può costruire). /mi give <player> <item> per magicitems.admin. Ricette a forma fissa per ciascuno. Nomi, lore, cooldown e ricette in config.yml."
Domande
Plugin o mod per gli oggetti personalizzati?
Un plugin se i giocatori devono entrare con il gioco normale: gli oggetti sono oggetti vanilla con un comportamento nuovo. Una mod se ti servono oggetti o blocchi davvero nuovi con una grafica propria, che poi ogni giocatore deve installare. Vedi plugin o mod.
Posso usarlo con ItemsAdder o Nexo?
Il tuo plugin può dipendere da loro, ma sono plugin a pagamento: il server di prova di Codexe non può installarli, quindi un plugin che ne richiede uno lì non si attiva. Le dipendenze gratuite elencate in plugin.yml vengono installate per te sul server di prova.
Gli oggetti smettono di funzionare dopo un aggiornamento?
Gli oggetti marcati con un PersistentDataContainer mantengono il tag tra un aggiornamento di Minecraft e l'altro. Le abilità potrebbero richiedere una nuova build per la nuova API; vedi aggiornare un plugin.
Crea i tuoi oggetti personalizzati
Questo prompt si apre pronto da inviare:
“Un plugin per Paper 1.21.4 chiamato MagicItems con tre oggetti marcati tramite PersistentDataContainer: Fire Wand (verga di blaze, il clic destro spara una palla di fuoco, cooldown di 5 secondi), Frost Blade (spada di ferro, Lentezza II per 3 secondi al colpo), Miner's Pick (piccone di diamante che scava 3x3). /mi give per magicitems.admin, una ricetta a forma fissa per ciascuno, nomi, lore, cooldown e ricette in config.yml.”
Generalo con Codexe