Plugin Minecraft zAuctionHouse

🔌 Despre zAuctionHouse

zAuctionHouse este un plugin Minecraft care implementează o casă de licitații completă, pentru ca jucătorii să poată lista, răsfoi și cumpăra iteme. Se concentrează pe configurabilitate, interfețe bazate pe GUI și suport pentru mai multe tipuri de economie. Proiectul este întreținut de GroupeZ-dev, iar repository-ul și documentația arată o rescriere V4 care vizează Java modern și arhitecturi moderne de server.

🎯 Scop

zAuctionHouse rezolvă problema tranzacționării itemelor în joc prin oferirea unei piețe centrale unde jucătorii pot crea listări buy-now, pot face vânzări în cantitate mare și pot răsfoi inventare pe categorii. Este destinat serverelor care doresc o piață integrată cu audit pentru admini și sincronizare de rețea opțională.

⚙️ Funcții

• Listări instant-buy (buy-it-now) și fluxuri de tip bidding acolo unde sunt suportate.
• Vânzări în cantitate mare: vinde mai multe iteme într-o singură listare.
• Previziualizare pentru shulker box, astfel încât cumpărătorii să poată inspecta conținutul înainte de achiziție.
• Filtrare pe categorii, sortare avansată și paginare pentru seturi mari de listări.
• Suport multi-economie (Vault, PlayerPoints, CoinsEngine, monede bazate pe iteme, XP/niveluri).
• Sistem de taxe configurabil și reduceri de taxe bazate pe permisiuni.
• Livrare de bani prin auto-claim sau manual-claim și notificări pentru vânzările offline.
• Integrare zMenu pentru GUI și template-uri de inventar complet personalizabile.
• Suport PlaceholderAPI și MiniMessage pentru mesaje formatate și placeholders.
• Instrumente pentru admini: panou admin, jurnale de acțiuni, istoric de tranzacții, recuperare de iteme și comenzi de gestionare a cache-ului.
• Sincronizare multi-server printr-un addon Redis cu distributed locking și pub/sub.
• Control asupra itemelor prin blacklist/whitelist, restricții de lume, limite de listare și preț, plus transaction locking pentru a preveni race conditions.
• Suport pentru Discord webhook pentru notificări de vânzare cu conținut embed configurabil.

🧩 Pentru cine este

• Servere Survival și SMP care vor o piață condusă de jucători.
• Servere Skyblock, Factions și servere axate pe economie care au nevoie de sisteme de schimb.
• Rețele care necesită piețe sincronizate între mai multe servere backend.
• Administratori de server care au nevoie de jurnale de audit și instrumente de recuperare pentru admini.

🏗️ Exemple de utilizare

• Jucătorii listează dropuri rare sau iteme craftate la un preț fix, pentru ca alți jucători să le poată cumpăra imediat.
• Un operator de server aplică reguli de taxe și reduceri VIP prin permisiuni.
• O rețea multi-server sincronizează listările și vânzările între serverele hub și backend folosind addon-ul Redis.

⌨️ Comenzi

(Comenzile de mai sus sunt preluate din documentația oficială a proiectului și din materialele de quick-start din repository.)

🔐 Permisiuni

(Doar nodurile de permisiune menționate explicit în configurația și documentația oficială sunt listate.)

⚙️ Instalare

📥 Setup

• Obține jar-ul oficial zAuctionHouse din distribuția proiectului (pagina oficială de vânzare sau catalogul).
• Pune jar-ul zAuctionHouse (și pluginurile necesare) în directorul serverului plugins/.
• Repornește serverul și verifică dacă pluginul s-a inițializat corect în consola serverului.
• Configurează pluginul folosind plugins/zAuctionHouse/config.yml și personalizează inventarele GUI în plugins/zAuctionHouse/inventories/.

📦 Dependențe

• Necesare: zMenu, PlaceholderAPI.
• Integrări opționale / suportate: Vault, LuckPerms și addon-ul zAuctionHouse Redis pentru sincronizare multi-server.

🧠 Note tehnice

• Proiectul vizează Java modern (rescrierea V4 vizează Java 21) și folosește un pattern repository / ORM în arhitectura sa.
• Software-ul de server recomandat include Paper și fork-uri Paper; Folia și mai multe fork-uri bazate pe Paper sunt de asemenea listate ca fiind suportate.
• Documentația oficială și distribuția arată suport pentru Minecraft 1.20 până la 1.21+ (verifică documentația proiectului pentru compatibilitatea exactă a build-ului înainte de implementarea în producție).

❓ FAQ

• Există o versiune gratuită?
  Este disponibil un build demo gratuit (proiectul oferă pe unele platforme o versiune gratuită/demo), în timp ce versiunile complete, suportate, sunt distribuite prin canalele premium ale proiectului.

🤝 Când este util acest plugin

Dacă ai nevoie de o piață configurabilă, bazată pe GUI, cu suport multi-economie și sincronizare opțională multi-server, zAuctionHouse oferă o implementare întreținută de casă de licitații, împreună cu audit pentru admini și personalizare GUI prin zMenu.