Plugin Minecraft Shopkeepers

🔌 Informazioni su Shopkeepers

Shopkeepers è un plugin Minecraft per Bukkit/Spigot che consente ai proprietari del server di posizionare mercanti villager personalizzabili, che vendono oggetti configurati a prezzi configurati. Il plugin supporta sia i negozi admin (scorte infinite) sia i negozi dei giocatori che prelevano le scorte da un contenitore, e pubblica una ShopkeepersAPI per l’integrazione di addon ed estensioni.

🎯 Scopo

Il plugin fornisce un sistema di negozi basato su NPC all’interno del gioco, così i server possono offrire negozi persistenti senza gestione manuale di forzieri o negozi complessi basati su comandi. È adatto per economie di server, negozi roleplay e server survival/SMP che desiderano commercianti NPC. ()

⚙️ Funzionalità

• Crea mercanti villager personalizzati con scambi e prezzi definiti.
• Negozi admin con scorte infinite.
• Negozi dei giocatori che prelevano oggetti da un contenitore collegato (forziere) per le scorte.
• ShopkeepersAPI per consentire agli autori di plugin di interrogare e gestire i mercanti in modo programmatico.
• Personalizzazione in gioco di oggetti/dati oggetto e supporto ai file di lingua tramite la wiki e i file di lingua del progetto. ()

🧩 A chi è rivolto

• Server Survival e SMP che vogliono negozi gestiti da NPC.
• Server roleplay o economy che usano NPC villager come mercanti.
• Sviluppatori di plugin che hanno bisogno di una API per integrare il comportamento dei negozi in altri sistemi. ()

🏗️ Esempi di utilizzo

• Un admin crea un negozio admin infinito che vende beni forniti dal server.
• Un giocatore apre un negozio che vende automaticamente oggetti da un forziere collegato.
• Uno sviluppatore crea un addon che elenca o modifica i mercanti usando ShopkeepersAPI. ()

⌨️ Comandi

(Nota: sopra sono elencati solo i comandi documentati esplicitamente dalle fonti ufficiali.) ()

⚙️ Installazione

📥 Configurazione

• Scarica il jar ufficiale del plugin e posizionalo nella cartella plugins/ del tuo server.
• Riavvia il server e controlla la console per confermare che il plugin sia stato caricato.

(Questi sono i passaggi standard di installazione per i plugin Bukkit/Spigot e sono supportati dalla documentazione del progetto.) ()

🧠 Note tecniche

• Shopkeepers è pubblicato sotto licenza GPL-3.0 e il repository del progetto include un modulo API (ShopkeepersAPI) e istruzioni di build. ()
• Il progetto fornisce artifact Maven e una API pubblicata per gli sviluppatori di addon; il README documenta l’uso del repository e le coordinate di dipendenza dell’API. ()
• La distribuzione ufficiale e il supporto della community sono disponibili tramite la pagina delle risorse di Spigot e il server Discord del plugin. ()

🤝 Quando questo plugin è utile

Se hai bisogno di mercanti NPC persistenti e configurabili, con supporto sia per negozi admin sia per negozi gestiti dai giocatori, e vuoi una API per integrare i negozi in altri plugin, Shopkeepers offre un’implementazione collaudata per server Bukkit/Spigot. ()