Plugin Minecraft zAuctionHouse

🔌 O zAuctionHouse

zAuctionHouse to plugin do Minecrafta, który implementuje w pełni funkcjonalny dom aukcyjny, dzięki któremu gracze mogą wystawiać, przeglądać i kupować przedmioty. Skupia się na konfigurowalności, interfejsach opartych na GUI oraz obsłudze wielu typów ekonomii. Projekt jest utrzymywany przez GroupeZ-dev, a repozytorium i dokumentacja pokazują przepisanie do wersji V4, ukierunkowane na nowoczesne Java i architektury serwerowe.

🎯 Cel

zAuctionHouse rozwiązuje problem handlu przedmiotami w grze, udostępniając centralny marketplace, w którym gracze mogą tworzyć oferty kup teraz, sprzedawać hurtowo i przeglądać zorganizowane kategorie ekwipunku. Jest przeznaczony dla serwerów, które chcą zintegrowanego rynku z audytem administratorów i opcjonalną synchronizacją sieciową.

⚙️ Funkcje

• Oferty z natychmiastowym zakupem (buy-it-now) oraz obsługa licytacji tam, gdzie jest wspierana.
• Sprzedaż hurtowa: sprzedaż wielu przedmiotów w jednej ofercie.
• Podgląd skrzynki Shulker, aby kupujący mogli sprawdzić zawartość przed zakupem.
• Filtrowanie kategorii, zaawansowane sortowanie i paginacja dla dużej liczby ofert.
• Obsługa wielu ekonomii (Vault, PlayerPoints, CoinsEngine, waluty oparte na przedmiotach, XP/poziomy).
• Konfigurowalny system podatków i zniżki podatkowe oparte na uprawnieniach.
• Wypłata pieniędzy z automatycznym lub ręcznym odbiorem oraz powiadomienia o sprzedaży offline.
• Integracja z zMenu dla w pełni konfigurowalnych GUI i szablonów ekwipunku.
• Obsługa PlaceholderAPI i MiniMessage dla formatowanych wiadomości i placeholderów.
• Narzędzia administracyjne: panel admina, logi działań, historia transakcji, odzyskiwanie przedmiotów i komendy zarządzania cache.
• Synchronizacja między wieloma serwerami za pomocą dodatku Redis z rozproszonym blokowaniem i pub/sub.
• Kontrola przedmiotów przez blacklistę/whitelistę, ograniczenia światów, limity ofert i cen oraz blokada transakcji zapobiegająca race conditions.
• Obsługa webhooków Discord do powiadomień o sprzedaży z konfigurowalną zawartością embed.

🧩 Dla kogo

• Serwery Survival i SMP, które chcą rynku napędzanego przez graczy.
• Serwery Skyblock, Factions i nastawione na ekonomię, potrzebujące systemów handlu.
• Sieci wymagające zsynchronizowanych marketplace'ów między wieloma serwerami backend.
• Administratorzy serwerów, którzy potrzebują logów audytowych i narzędzi odzyskiwania.

🏗️ Przykładowe zastosowania

• Gracze wystawiają rzadkie dropy lub wytworzone przedmioty po stałej cenie, aby inni mogli je kupić od razu.
• Operator serwera egzekwuje zasady podatkowe i zniżki VIP za pomocą uprawnień.
• Sieć wielu serwerów synchronizuje oferty i sprzedaże między serwerami hub i backend przy użyciu dodatku Redis.

⌨️ Komendy

(Powyższe komendy pochodzą z oficjalnej dokumentacji projektu oraz materiałów szybkiego startu repozytorium.)

🔐 Uprawnienia

(Listowane są tylko węzły uprawnień wyraźnie wymienione w oficjalnej konfiguracji i dokumentacji.)

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik jar z zAuctionHouse z dystrybucji projektu (oficjalna strona sprzedaży lub katalog).
• Umieść plik jar zAuctionHouse (oraz wymagane pluginy) w katalogu plugins/ serwera.
• Uruchom ponownie serwer i sprawdź, czy plugin inicjalizuje się w konsoli serwera.
• Skonfiguruj plugin, używając plugins/zAuctionHouse/config.yml, i dostosuj GUI ekwipunków w plugins/zAuctionHouse/inventories/.

📦 Zależności

• Wymagane: zMenu, PlaceholderAPI.
• Opcjonalne / wspierane integracje: Vault, LuckPerms oraz addon Redis zAuctionHouse do synchronizacji między serwerami.

🧠 Uwagi techniczne

• Projekt celuje w nowoczesne Java (przepisanie V4 celuje w Java 21) i używa w architekturze wzorca repository / ORM.
• Zalecane oprogramowanie serwerowe obejmuje Paper i forki Paper; Folia i kilka forków opartych na Paper są wymienione jako wspierane.
• Oficjalna dokumentacja i dystrybucja pokazują obsługę Minecrafta 1.20 aż do 1.21+ (sprawdź dokumentację projektu, aby poznać dokładną zgodność builda przed wdrożeniem na produkcję).

❓ FAQ

• Czy jest darmowa wersja?
  Dostępna jest darmowa wersja demo (projekt oferuje wydanie free/demo na niektórych platformach), natomiast pełne, wspierane wydania są dystrybuowane przez premium kanały projektu.

🤝 Kiedy ten plugin jest przydatny

Jeśli potrzebujesz konfigurowalnego, opartego na GUI marketplace'u z obsługą wielu ekonomii i opcjonalną synchronizacją między serwerami, zAuctionHouse zapewnia utrzymywaną implementację domu aukcyjnego wraz z audytem administratorów i możliwością personalizacji GUI przez zMenu.