Plugin Minecraft ChestShop

🔌 Informazioni su ChestShop

ChestShop è un plugin per Minecraft per creare negozi gestiti dai giocatori usando bauli e cartelli. Collega le azioni del negozio all’economia del server (tramite Vault o Reserve) così i giocatori possono comprare e vendere oggetti usando la valuta del server. Il progetto è mantenuto su GitHub e distribuisce i build tramite le comuni piattaforme di plugin.

🎯 Scopo

Fornire un marketplace semplice e persistente nel mondo di gioco, in cui i giocatori creano negozi posizionando un cartello su un baule. ChestShop gestisce le transazioni tra gli inventari dei giocatori e l’economia del server e include protezioni e hook di compatibilità per ridurre il griefing e lo sforzo di integrazione.

⚙️ Funzionalità

• Creare negozi di acquisto/vendita posizionando un cartello formattato su un baule.
• Integrazione con Vault o Reserve e altri plugin di economia compatibili per la gestione del denaro.
• Opzioni di protezione del negozio e di compatibilità per rispettare i comuni plugin di protezione dei bauli.
• Misure anti-lag / di sicurezza delle transazioni documentate dagli autori.
• Estensibile con add-on della community e plugin di compatibilità (l’elenco degli add-on è mantenuto dal progetto).
• Comandi di amministrazione e informativi sono stati aggiunti nelle release recenti (esempi: /shopinfo, /iteminfo).

🧩 A chi è rivolto

• Server Survival e SMP che usano un’economia basata sulla valuta.
• Server che vogliono negozi semplici, basati su cartelli, invece di vetrine con GUI.
• Amministratori che preferiscono negozi che mantengono gli oggetti in bauli vanilla (nessun database obbligatorio per l’archiviazione di base del negozio).

🏗️ Esempi d’uso

• I giocatori posizionano un baule, inseriscono l’oggetto da vendere e creano un cartello per impostare i prezzi di acquisto/vendita; gli altri giocatori cliccano sul cartello per commerciare.
• Gli amministratori del server creano negozi admin per la vendita di oggetti gestita dal server.
• Una community aggiunge un plugin di compatibilità per integrare ChestShop con un addon di protezione o di visualizzazione.

⌨️ Comandi

(I comandi elencati sono presi dalle note di rilascio e dalla documentazione del progetto. Sono mostrati solo i comandi esplicitamente documentati dal progetto.)

🔐 Permessi

(I nodi dei permessi sono inclusi solo quando compaiono nelle risorse ufficiali del progetto e nelle note di rilascio.)

⚙️ Installazione

📥 Configurazione

• Scarica il .jar ufficiale di ChestShop e mettilo nella cartella plugins/ del server.
• Installa Vault o Reserve e un plugin di economia compatibile che fornisca una API per il denaro.
• Riavvia il server e controlla la console per confermare che ChestShop sia stato abilitato correttamente.

📦 Dipendenze

• Vault (integrazione supportata) o Reserve (integrazione supportata)
• Un plugin di economia compatibile che espone una API per il denaro (installato insieme a Vault/Reserve)

🧾 Configurazione

Il plugin genera file di configurazione/yml al primo avvio; le opzioni di configurazione e i toggle di compatibilità sono disponibili in quei file e nella documentazione del progetto.

🧠 Note tecniche

• Il codice sorgente e il tracciamento delle issue sono ospitati su GitHub sotto licenza LGPL-2.1.
• Il progetto elenca build e artefatti di release sui comuni siti di plugin; i maintainer pubblicano anche build di sviluppo su un server CI.
• ChestShop è progettato per tipi di server Bukkit/Spigot/Paper (la documentazione del progetto e il repository lo dichiarano esplicitamente).

🤝 Quando questo plugin è utile

Se vuoi un marketplace semplice nel mondo di gioco, in cui gli oggetti restano in normali bauli e le transazioni usano la valuta del tuo server, ChestShop offre un sistema di negozi con baule e cartello maturo ed estensibile, con integrazione economy e compatibilità con gli add-on.