Plugin Minecraft AuctionHouse

🔌 Informazioni su AuctionHouse

AuctionHouse è un plugin per Minecraft che aggiunge una casa d'aste in-game accessibile con il comando /ah. I giocatori possono mettere oggetti in vendita, sfogliare e cercare gli annunci, e acquistare oggetti tramite un mercato basato su GUI. Il plugin si concentra sugli scambi tra giocatori con regole di inserzione, commissioni e annunci configurabili.

🎯 Scopo

AuctionHouse offre un mercato centralizzato e gestito tramite GUI, così i server possono avere un sistema d'aste amministrato invece di affidarsi a negozi gestiti dai giocatori o a mercati basati su cartelli. È pensato per server che vogliono un mercato pubblico ricercabile con restrizioni configurabili e integrazione con l'economia.

⚙️ Funzionalità

• Casa d'aste GUI aperta con /ah.
• Crea e annulla inserzioni; recupera gli oggetti annullati o scaduti.
• Cerca e filtra le inserzioni per nome, tipo, lore, enchants o venditore.
• Ordina le inserzioni per tempo o prezzo.
• Controlli sulle inserzioni: imposta prezzi minimi/massimi, commissioni di inserzione (fisse e/o percentuali), tassa del venditore con limite e cooldown tra le inserzioni.
• Restrizioni sugli oggetti per nome, tipo, lore, incantesimi, danno, flag unbreakable, custom_model_data e pattern regex.
• Opzione per elencare gli oggetti del server (inserzioni una tantum o illimitate).
• Trigger speciali per aprire l'asta tramite cartelli, block entity nominate (bauli, shulker, dispenser, ecc.) o entità con nome personalizzato.
• I tooltip al passaggio del mouse mostrano il tempo rimanente e gli enchants.
• Annunci opzionali per nuove inserzioni e integrazione con Discord.
• Supporto all'internazionalizzazione e messaggi, materiali e suoni configurabili.
• Registrazione delle transazioni in un file di log separato e pulizia automatica degli oggetti abbandonati.

🧩 A chi è rivolto

• Server Survival e SMP che vogliono un mercato condiviso tra giocatori.
• Server focalizzati sull'economia che vogliono una GUI d'asta ricercabile.
• Admin che hanno bisogno di regole di inserzione, commissioni e restrizioni sugli oggetti configurabili.

🏗️ Casi d'uso di esempio

• I giocatori elencano il bottino in eccesso e lo mettono all'asta alla community del server invece di usare bauli o negozi.
• Lo staff del server crea inserzioni limitate o illimitate per gli oggetti offerti dal server.
• Gli admin applicano le regole dell'economia del server limitando determinati oggetti o applicando tasse di inserzione.

⌨️ Comandi

🔐 Permessi

⚙️ Installazione

📥 Configurazione

• Scarica il file .jar ufficiale del plugin e inseriscilo nella directory plugins/ del tuo server per server compatibili con Spigot.
• Riavvia il server (riavvio completo) e controlla la console per confermare che il plugin sia stato caricato.
• Configura il plugin usando i file di configurazione forniti, secondo necessità.

📦 Dipendenze

• Vault (richiesto, consigliato 1.7.1+).
• Un plugin economia adatto (ad esempio EssentialsX economy o un altro provider economico compatibile con Vault).
• Un plugin permessi adatto (se usi permessi oltre quelli predefiniti).

🧠 Note tecniche

• Archiviazione: il plugin usa SQLite (non è documentato il supporto a database esterni).
• Il plugin registra le transazioni in un file di log separato e supporta l'internazionalizzazione.
• Supporta le teste di HeadDatabase e le texture personalizzate dei teschi come pulsanti GUI.
• L'autore indica che le funzionalità e la compatibilità delle versioni sono rivolte a Spigot; il comportamento può variare su altri software server.

🤝 Quando questo plugin è utile

Se vuoi un sistema d'aste configurabile, basato su GUI e integrato con l'economia del tuo server e Vault, AuctionHouse offre controlli sulle inserzioni, ricerca/filtro, commissioni/tasse e registrazione delle transazioni per fornire un mercato dei giocatori gestibile.