Server Minecraft con plugin EconomyShopGUI

## 🔌 Informazioni su EconomyShopGUI EconomyShopGUI è un plugin Minecraft che fornisce un sistema di negozio grafico configurabile, così i giocatori possono comprare e vendere oggetti tramite menu invece che con comandi in chat. Il plugin offre sezioni del negozio, pagine del negozio con paginazione, un'interfaccia di vendita e oggetti fisici opzionali "ShopStand". È progettato per ambienti server Bukkit/Spigot/Paper e si integra con i plugin di economia più comuni. ## 🎯 Scopo Il plugin sostituisce o affianca i comandi testuali del negozio con negozi guidati da GUI e configurazione amministrativa del negozio. È pensato per proprietari e amministratori di server che vogliono negozi in-game strutturati e configurabili, collegati a un plugin di economia esistente. ## ⚙️ Funzionalità - Sezioni del negozio configurabili e pagine GUI con paginazione. - Flussi di acquisto e vendita degli oggetti con schermata di transazione e limiti configurabili. - Funzione vendi tutto globale e per sezione. - Supporto per oggetti fisici ShopStand (negozi espositivi posizionabili). - Marketplace di layout / layout installabili e installazione del layout in gioco. - API per sviluppatori per collegarsi al plugin da altri plugin. - Integrazione con più sistemi di economia e integrazioni opzionali per plugin di spawner e utility. - Usa bStats per metriche anonime del plugin. ## 🧩 Per chi è pensato - Server Survival e SMP che vogliono negozi GUI in-game. - Server che usano già un plugin di economia separato e hanno bisogno di un'interfaccia negozio front-end. - Server che vogliono layout del negozio configurabili e supporti fisici del negozio opzionali. - Sviluppatori di plugin che hanno bisogno di una API del negozio per integrare il comportamento del negozio. ## 🏗️ Casi d'uso di esempio - Gli operatori creano sezioni del negozio per risorse, strumenti e cosmetici e permettono ai giocatori di acquistare tramite una GUI. - Un server offre il comando /sellall per permettere ai giocatori di vendere oggetti alle sezioni del negozio configurate. - Gli amministratori installano o caricano un layout per cambiare l'aspetto del negozio senza modificare i file grezzi. ## ⌨️ Comandi | **Comando** | **Descrizione** | **Permesso** | **Accesso** | |---|---|---|---| | `/eshop additem <section> <material> <buy price> <sell price>` | Aggiunge un oggetto a una sezione del negozio. | `EconomyShopGUI.eshop.additem` | Admin | | `/eshop edititem <section> <index> <action> <key> <value>` | Modifica le proprietà di un oggetto in una sezione. | `EconomyShopGUI.eshop.edititem` | Admin | | `/eshop deleteitem <section> <index>` | Rimuove un oggetto da una sezione del negozio. | `EconomyShopGUI.eshop.deleteitem` | Admin | | `/eshop addhanditem <section> <buy price> <sell price>` | Aggiunge l'oggetto che hai in mano a una sezione del negozio. | `EconomyShopGUI.eshop.addhanditem` | Admin | | `/eshop installLayout <id>` | Installa un layout del negozio tramite id (integrazione con il marketplace dei layout). | `EconomyShopGUI.eshop.installLayout` | Admin | | `/eshop logs export` | Esporta i log delle transazioni come vista web (funzione di registrazione transazioni). | `non specificato` | Admin | | `/sellall` | Vende tutti gli oggetti vendibili in base alle sezioni del negozio configurate. | `EconomyShopGUI.sellall` | Giocatore | | `/sellgui` | Apre la Sell GUI per vendere oggetti tramite un menu. | `EconomyShopGUI.sellgui` | Giocatore | (I comandi sopra sono inclusi solo quando documentati dall'autore del plugin.) ## 🔐 Permessi | **Permesso** | **Descrizione** | **Predefinito** | |---|---|---| | `EconomyShopGUI.shop` | Consente ai giocatori di aprire il negozio. | non specificato | | `EconomyShopGUI.shop.<section>` | Accesso per aprire una sezione specifica del negozio per nome. | non specificato | | `EconomyShopGUI.shop.all` | Consente di aprire tutte le sezioni del negozio. | non specificato | | `EconomyShopGUI.sellall` | Consente di usare il comando `/sellall`. | non specificato | | `EconomyShopGUI.sellall.<section>` | Consente di vendere a una sezione specifica del negozio con `/sellall`. | non specificato | | `EconomyShopGUI.sellall.all` | Consente di vendere a tutte le sezioni con `/sellall`. | non specificato | | `EconomyShopGUI.sellallitem` | Consente l'uso di `/sellall <item>`. | non specificato | | `EconomyShopGUI.sellgui` | Consente di aprire la Sell GUI. | non specificato | | `EconomyShopGUI.reload` | Consente di ricaricare il plugin. | non specificato | | `EconomyShopGUI.eshop.additem` | Consente di aggiungere oggetti del negozio tramite comando. | non specificato | | `EconomyShopGUI.eshop.edititem` | Consente di modificare gli oggetti del negozio tramite comando. | non specificato | | `EconomyShopGUI.eshop.deleteitem` | Consente di eliminare gli oggetti del negozio tramite comando. | non specificato | | `EconomyShopGUI.eshop.addhanditem` | Consente di aggiungere al negozio l'oggetto in mano tramite comando. | non specificato | | `EconomyShopGUI.eshop.addsection` | Consente di aggiungere sezioni del negozio tramite comando. | non specificato | | `EconomyShopGUI.eshop.uploadLayout` | Consente di caricare un layout. | non specificato | | `EconomyShopGUI.eshop.installLayout` | Consente di installare un layout. | non specificato | | `EconomyShopGUI.eshop.shopstands.create` | Consente di creare/posizionare oggetti ShopStand. | non specificato | | `EconomyShopGUI.eshop.shopstands.destroy` | Consente di distruggere gli ShopStand. | non specificato | (I valori predefiniti sono registrati come "non specificato" quando il plugin non elenca un valore predefinito nell'elenco documentato dei permessi.) ## ⚙️ Installazione ### 📥 Configurazione - Scarica il JAR ufficiale del plugin e mettilo nella cartella `plugins/` del tuo server. - Riavvia il server (oppure usa un gestore di plugin per caricare il plugin). - Controlla la console del server all'avvio per confermare che il plugin sia stato caricato e per eventuali avvisi sulle dipendenze. ### 📦 Dipendenze - Richiede un provider di economia. Il plugin documenta il supporto per uno di questi: **Vault**, **PlayerPoints**, **CoinsEngine**, **GemsEconomy**, **UltraEconomy**, **VotingPlugin**, **zEssentials** (uno di questi deve essere presente per le operazioni di economia). - Le integrazioni opzionali includono PlaceholderAPI, Citizens, Quests e vari plugin di spawner per il supporto diretto. ## 🧠 Note tecniche - Il plugin è pubblicato per server Bukkit/Spigot/Paper e l'autore segnala che non supporta server modded/ibridi. - Requisiti indicati dall'autore: Minecraft 1.8+ e Java 8 o più recente. - Il plugin espone una API per sviluppatori così altri plugin possono agganciarsi agli eventi e alle funzionalità del negozio. - Il plugin usa bStats per la raccolta anonima di metriche. - Esiste una variante premium che aggiunge funzionalità come editor GUI, oggetti comando e oggetti NBT personalizzati; la funzionalità principale (negozi GUI) è presente nella versione gratuita. ## 🤝 Quando questo plugin è utile Se ti serve una vetrina grafica in-game che si integri con il tuo plugin di economia esistente e supporti layout configurabili, sezioni del negozio e flussi di vendita, EconomyShopGUI offre un'interfaccia documentata per gli amministratori e una API per l'integrazione con i plugin.

Plugin