Minecraft plugin zAuctionHouse

🔌 O zAuctionHouse

zAuctionHouse je Minecraft plugin, který hráčům poskytuje plně vybavenou aukční síň pro vystavování, prohlížení a nákup předmětů. Zaměřuje se na vysokou míru konfigurace, rozhraní řízená přes GUI a podporu více typů ekonomiky. Projekt spravuje GroupeZ-dev a repozitář i dokumentace ukazují přepsanou verzi V4, která cílí na moderní Java a serverové architektury.

🎯 Účel

zAuctionHouse řeší problém obchodování s předměty ve hře tím, že poskytuje centrální tržiště, kde hráči mohou vytvářet nabídky typu buy-now, provádět hromadné prodeje a procházet inventáře podle kategorií. Je určen pro servery, které chtějí integrované tržiště s administrátorským auditem a volitelnou synchronizací napříč sítí.

⚙️ Funkce

• Nabídky instant-buy (buy-it-now) a pracovní postupy na způsob dražby tam, kde jsou podporovány.
• Hromadné prodeje: prodej více předmětů v jedné nabídce.
• Náhled shulker boxu, aby si kupující mohli prohlédnout obsah před nákupem.
• Filtrování podle kategorií, pokročilé řazení a stránkování pro velké množství nabídek.
• Podpora více ekonomik (Vault, PlayerPoints, CoinsEngine, měny založené na předmětech, XP/úrovně).
• Konfigurovatelný daňový systém a slevy na dani podle oprávnění.
• Automatické nebo ruční vyplacení peněz a oznámení o prodejích offline.
• Integrace zMenu pro plně přizpůsobitelná GUI a šablony inventářů.
• Podpora PlaceholderAPI a MiniMessage pro formátované zprávy a placeholdery.
• Admin nástroje: admin panel, záznamy akcí, historie transakcí, obnova předmětů a příkazy pro správu cache.
• Synchronizace mezi více servery přes Redis addon s distribuovaným zamykáním a pub/sub.
• Ovládání předmětů přes blacklist/whitelist, omezení světa, limity nabídek a cen a zamykání transakcí pro zabránění race condition.
• Podpora Discord webhooků pro oznámení o prodejích s konfigurovatelným obsahem embed.

🧩 Pro koho je určen

• Survival a SMP servery, které chtějí tržiště řízené hráči.
• Skyblock, Factions a ekonomicky zaměřené servery, které potřebují obchodní systémy.
• Sítě, které vyžadují synchronizovaná tržiště mezi více backend servery.
• Správce serveru, kteří potřebují auditní logy a nástroje pro obnovu na straně adminů.

🏗️ Příklady použití

• Hráči vystaví vzácné dropy nebo vyrobené předměty za pevnou cenu, aby je ostatní mohli ihned koupit.
• Operátor serveru prosazuje pravidla daní a VIP daňové slevy pomocí oprávnění.
• Víceserverová síť synchronizuje nabídky a prodeje mezi hub a backend servery pomocí Redis addon.

⌨️ Příkazy

(Příkazy výše jsou převzaty z oficiální dokumentace projektu a rychlých startovacích materiálů v repozitáři.)

🔐 Oprávnění

(Uvedeny jsou pouze permission nodey výslovně zmíněné v oficiální konfiguraci a dokumentaci.)

⚙️ Instalace

📥 Nastavení

• Získejte oficiální jar z zAuctionHouse z distribuce projektu (oficiální prodejní stránka nebo katalog).
• Umístěte jar zAuctionHouse (a vyžadované pluginy) do adresáře serveru plugins/.
• Restartujte server a ověřte, že se plugin úspěšně inicializoval v konzoli serveru.
• Nakonfigurujte plugin pomocí plugins/zAuctionHouse/config.yml a upravte GUI inventáře v plugins/zAuctionHouse/inventories/.

📦 Závislosti

• Vyžadováno: zMenu, PlaceholderAPI.
• Volitelná / podporovaná integrace: Vault, LuckPerms a zAuctionHouse Redis addon pro synchronizaci mezi více servery.

🧠 Technické poznámky

• Projekt cílí na moderní Java (přepsaná verze V4 cílí na Java 21) a ve své architektuře používá repository pattern / ORM.
• Doporučený serverový software zahrnuje Paper a jeho forky; Folia a několik forků založených na Paper jsou také uvedeny jako podporované.
• Oficiální dokumentace a distribuce ukazují podporu pro Minecraft 1.20 až 1.21+ (před nasazením do produkce si v dokumentaci projektu ověřte přesnou kompatibilitu buildu).

❓ FAQ

• Existuje bezplatná verze?
  Je k dispozici bezplatný demo build (projekt na některých platformách poskytuje free/demo release), zatímco plné, podporované verze jsou distribuovány přes premium kanály projektu.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete konfigurovatelné tržiště řízené přes GUI s podporou více ekonomik a volitelnou synchronizací mezi více servery, zAuctionHouse poskytuje udržovanou implementaci aukční síně spolu s admin auditem a přizpůsobením GUI přes zMenu.