Plugin Minecraft ItemJoin

🔌 Informazioni su ItemJoin

ItemJoin è un plugin per Minecraft che assegna automaticamente ai giocatori oggetti personalizzati altamente configurabili. Gli oggetti possono essere concessi in eventi come join, first-join, respawn, world-switch, region-enter e region-leave. Il plugin si concentra su definizioni flessibili degli oggetti (itemflags), eventi trigger e comandi associati agli oggetti, così che i server possano offrire menu lobby, kit iniziali o strumenti sensibili al contesto senza mod client personalizzate.

🎯 Scopo

ItemJoin risolve il problema di fornire in modo affidabile ai giocatori oggetti personalizzati o interattivi collegati agli eventi e ai mondi del server. È utile per server hub/lobby, server minigame, reti survival (dove gli oggetti devono essere limitati per mondo) e reti che necessitano di menu basati su oggetti o di oggetti che avviano comandi.

⚙️ Funzionalità

• Assegna oggetti tramite trigger configurabili: join, first-join, respawn, world-switch, region-enter/exit ed eventi simili.
• itemflags per oggetto che modificano il comportamento (slot, overwrite, regole di stack, blocco di movimento/raccolta, limiti di gamemode, probabilità di ricezione, cooldown).
• ItemCommands: collega comandi agli oggetti e configura il contesto di esecuzione (console, player, server, message) e i tipi di azione (clic sinistro/destro, clic nell'inventario, fisico, multi-clic).
• Integrazione con PlaceholderAPI per nomi/lore dinamici degli oggetti e supporto ai placeholder.
• Supporto per teste personalizzate dei giocatori (texture e proprietari personalizzati), immagini su mappe, tipped arrows, libri, banner, fuochi d'artificio, personalizzazione dell'armatura in pelle e livelli di incantesimo personalizzati.
• Blocco opzionale del movimento o del pickup degli oggetti in mondi specifici e limitazione degli oggetti in base all'indirizzo IP o allo stato di first-join.
• Creatore GUI in-game per costruire set di oggetti e flusso integrato di importazione/creazione.
• API per altri plugin: disponibile in me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 A chi è rivolto

• Proprietari di server che hanno bisogno di oggetti automatici per lobby/hub o kit iniziali.
• Gestori di minigame e network che richiedono oggetti specifici per mondo o bussole da menu.
• Sviluppatori che vogliono un sistema di oggetti collegabile tramite API.

🏗️ Esempi di utilizzo

• Dare ai giocatori una bussola menu al join che esegue comandi diversi al clic.
• Fornire kit iniziali una sola volta al first-join impedendo il trasferimento di oggetti tra mondi specifici.
• Creare oggetti interattivi che eseguono comandi di economia/negozio con cooldown e costi.

⌨️ Comandi

Nota: questi comandi e sottocomandi provengono dal set di comandi documentato del plugin. Il plugin fornisce altri sottocomandi nella wiki e nell'output di aiuto generato.

🔐 Permessi

Il comportamento dei permessi specifici per oggetto è configurabile; i controlli dei permessi sugli oggetti sono disabilitati per impostazione predefinita e devono essere attivati nella configurazione del plugin per avere effetto.

⚙️ Installazione

📥 Configurazione

• Scarica il jar ufficiale di ItemJoin e mettilo nella cartella plugins/ del tuo server.
• Assicurati che in plugins/ non ci siano file jar duplicati di ItemJoin (ad esempio ItemJoin(1).jar).
• Riavvia il server in modo che il plugin possa generare la propria configurazione e registrare le funzionalità per la versione del tuo server.
• Controlla i log della console del server per confermare il caricamento del plugin e consulta la wiki del plugin per una configurazione dettagliata.

📦 Dipendenze

Il plugin non ha requisiti runtime obbligatori, ma elenca diverse soft-dependencies e integrazioni comuni (opzionali e abilitate quando presenti):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Abilita o configura le integrazioni secondo necessità; il plugin funziona senza queste, ma funzionalità come i placeholder, le teste/skin personalizzate e i hook per l'economia dipendono dai plugin corrispondenti.

🧠 Note tecniche

• Piattaforme: confermato per server in stile Spigot (Spigot, Bukkit, Paper, Purpur, Folia).
• Intervallo Minecraft supportato/testato: da 1.8 a 1.21.
• Il codice sorgente e le release sono pubblicati e il progetto espone un'API a me.RockinChaos.itemjoin.api.ItemJoinAPI per l'integrazione di altri plugin.
• Licenza: LGPL-3.0.

🤝 Quando questo plugin è utile

Se ti serve un sistema flessibile e configurabile per fornire ai giocatori oggetti interattivi e contestuali (menu, kit iniziali, strumenti specifici per mondo) e vuoi anche un'API per le integrazioni, ItemJoin offre queste funzionalità supportando i più comuni plugin di placeholder e skin.