Plugin Minecraft zAuctionHouse

🔌 Informazioni su zAuctionHouse

zAuctionHouse è un plugin Minecraft che implementa una casa d'aste completa per consentire ai giocatori di mettere in vendita, sfogliare e acquistare oggetti. Si concentra su configurabilità, interfacce basate su GUI e supporto per più tipi di economia. Il progetto è mantenuto da GroupeZ-dev e il repository e la documentazione mostrano una riscrittura V4 che punta a Java moderno e ad architetture server.

🎯 Scopo

zAuctionHouse risolve il problema della compravendita di oggetti in-game fornendo un marketplace centrale in cui i giocatori possono creare inserzioni a prezzo fisso, effettuare vendite in blocco e sfogliare inventari categorizzati. È pensato per i server che desiderano un marketplace integrato con auditing degli admin e sincronizzazione di rete opzionale.

⚙️ Funzionalità

• Inserzioni con acquisto immediato (buy-it-now) e flussi in stile asta dove supportati.
• Vendite in blocco: vendi più oggetti in un'unica inserzione.
• Anteprima del forziere Shulker per consentire agli acquirenti di controllare il contenuto prima dell'acquisto.
• Filtri per categoria, ordinamento avanzato e paginazione per grandi insiemi di inserzioni.
• Supporto multi-economia (Vault, PlayerPoints, CoinsEngine, valute basate su oggetti, XP/livelli).
• Sistema fiscale configurabile e riduzioni delle tasse basate sui permessi.
• Consegna del denaro con ritiro automatico o manuale, e notifiche di vendita offline.
• Integrazione con zMenu per GUI e modelli di inventario completamente personalizzabili.
• Supporto a PlaceholderAPI e MiniMessage per messaggi formattati e placeholder.
• Strumenti admin: pannello admin, log delle azioni, cronologia delle transazioni, recupero oggetti e comandi di gestione della cache.
• Sincronizzazione multi-server tramite un addon Redis con locking distribuito e pub/sub.
• Controlli degli oggetti in blacklist/whitelist, restrizioni sul mondo, limiti di inserzione e di prezzo, e blocco delle transazioni per evitare race conditions.
• Supporto ai webhook Discord per le notifiche di vendita con contenuto embed configurabile.

🧩 A chi è rivolto

• Server Survival e SMP che vogliono un marketplace guidato dai giocatori.
• Server Skyblock, Factions e orientati all'economia che necessitano di sistemi di scambio.
• Network che richiedono marketplace sincronizzati tra più server backend.
• Amministratori di server che hanno bisogno di log di audit e strumenti di recupero admin.

🏗️ Casi d'uso di esempio

• I giocatori mettono in vendita drop rari o oggetti craftati a prezzo fisso, così che altri giocatori possano acquistarli subito.
• Un operatore del server applica regole fiscali e riduzioni per VIP tramite i permessi.
• Una rete multi-server sincronizza inserzioni e vendite tra i server hub e backend usando l'addon Redis.

⌨️ Comandi

(I comandi sopra sono tratti dalla documentazione ufficiale del progetto e dai materiali di quick-start del repository.)

🔐 Permessi

(Sono elencati solo i nodi di permesso esplicitamente citati nella configurazione e nella documentazione ufficiali.)

⚙️ Installazione

📥 Setup

• Ottieni il jar ufficiale di zAuctionHouse dalla distribuzione del progetto (pagina di vendita ufficiale o catalogo).
• Inserisci il jar di zAuctionHouse (e i plugin richiesti) nella directory plugins/ del server.
• Riavvia il server e verifica che il plugin si inizializzi nella console del server.
• Configura il plugin usando plugins/zAuctionHouse/config.yml e personalizza gli inventari GUI in plugins/zAuctionHouse/inventories/.

📦 Dipendenze

• Richiesti: zMenu, PlaceholderAPI.
• Integrazioni opzionali / supportate: Vault, LuckPerms e l'addon Redis di zAuctionHouse per la sincronizzazione multi-server.

🧠 Note tecniche

• Il progetto punta a Java moderno (la riscrittura V4 punta a Java 21) e utilizza un pattern repository / ORM nella sua architettura.
• Il software server consigliato include Paper e fork di Paper; Folia e diversi fork basati su Paper sono elencati come supportati.
• La documentazione ufficiale e la distribuzione mostrano supporto per Minecraft 1.20 fino a 1.21+ (controlla la documentazione del progetto per la compatibilità esatta della build prima di andare in produzione).

❓ FAQ

• Esiste una versione gratuita?
  È disponibile una build demo gratuita (il progetto fornisce una release free/demo su alcune piattaforme), mentre le release complete e supportate sono distribuite tramite i canali premium del progetto.

🤝 Quando questo plugin è utile

Se ti serve un marketplace configurabile, basato su GUI, con supporto multi-economia e sincronizzazione multi-server opzionale, zAuctionHouse offre un'implementazione di casa d'aste mantenuta insieme ad auditing admin e personalizzazione della GUI tramite zMenu.