Plugin Minecraft AuctionHouse

🔌 O AuctionHouse

AuctionHouse to plugin do Minecraft, który dodaje aukcyjny dom dostępny w grze za pomocą komendy /ah. Gracze mogą wystawiać przedmioty na sprzedaż, przeglądać i wyszukiwać oferty oraz kupować przedmioty przez rynek oparty na GUI. Plugin koncentruje się na handlu między graczami, oferując konfigurowalne zasady wystawiania, opłaty i ogłoszenia.

🎯 Cel

AuctionHouse zapewnia scentralizowany rynek sterowany przez GUI, dzięki czemu serwery mogą oferować zarządzany system aukcji zamiast polegać na sklepach prowadzonych przez graczy lub rynkach opartych na znakach. Jest przeznaczony dla serwerów, które chcą przeszukiwalnego publicznego rynku z konfigurowalnymi ograniczeniami i integracją z ekonomią.

⚙️ Funkcje

• Dom aukcyjny GUI otwierany komendą /ah.
• Tworzenie i anulowanie ofert; odbieranie anulowanych lub wygasłych przedmiotów.
• Wyszukiwanie i filtrowanie ofert po nazwie, typie, lore, enchants lub sprzedawcy.
• Sortowanie ofert według czasu lub ceny.
• Kontrola ofert: ustawianie cen minimalnych/maksymalnych, opłat za wystawienie (stałych i/lub procentowych), podatku sprzedawcy z limitem oraz cooldownu między ofertami.
• Ograniczenia przedmiotów według nazwy, typu, lore, zaklęć, obrażeń, flagi unbreakable, custom_model_data i wzorców regex.
• Opcja wystawiania przedmiotów serwera (oferty jednorazowe lub bez limitu).
• Specjalne wyzwalacze otwierające aukcję przez tabliczki, nazwane encje bloków (skrzynie, shulkery, dozowniki itp.) lub encje z własną nazwą.
• Podpowiedzi po najechaniu pokazują pozostały czas i enchants.
• Opcjonalne ogłoszenia nowych ofert i integracja z Discordem.
• Obsługa internacjonalizacji oraz konfigurowalnych wiadomości, materiałów i dźwięków.
• Logowanie transakcji do osobnego pliku logu i automatyczne usuwanie porzuconych przedmiotów.

🧩 Dla kogo jest ten plugin

• Serwery Survival i SMP, które chcą wspólnego rynku dla graczy.
• Serwery nastawione na ekonomię, które chcą przeszukiwalnego GUI aukcji.
• Administratorzy potrzebujący konfigurowalnych zasad wystawiania, opłat i ograniczeń przedmiotów.

🏗️ Przykładowe zastosowania

• Gracze wystawiają nadmiarowy loot i licytują go społeczności serwera zamiast używać skrzyń lub sklepów.
• Administracja serwera tworzy ograniczone lub nielimitowane oferty przedmiotów udostępnianych przez serwer.
• Administratorzy egzekwują zasady ekonomii serwera, ograniczając niektóre przedmioty lub nakładając podatki za wystawianie.

⌨️ Komendy

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik .jar pluginu i umieść go w katalogu plugins/ serwera dla serwerów zgodnych ze Spigotem.
• Zrestartuj serwer (pełny restart) i sprawdź konsolę, aby potwierdzić, że plugin został załadowany.
• Skonfiguruj plugin, korzystając z udostępnionych plików konfiguracyjnych, jeśli to potrzebne.

📦 Zależności

• Vault (wymagane, zalecane 1.7.1+).
• Odpowiedni plugin ekonomii (np. EssentialsX economy lub inny dostawca ekonomii zgodny z Vault).
• Odpowiedni plugin uprawnień (jeśli używasz uprawnień wykraczających poza domyślne).

🧠 Uwagi techniczne

• Przechowywanie: plugin używa SQLite (brak udokumentowanej obsługi zewnętrznych baz danych).
• Plugin zapisuje transakcje do osobnego pliku logu i obsługuje internacjonalizację.
• Obsługuje głowy z HeadDatabase oraz niestandardowe tekstury czaszek jako przyciski GUI.
• Autor zaznacza, że funkcje i zgodność wersji są ukierunkowane na Spigot; zachowanie może różnić się na innym oprogramowaniu serwera.

🤝 Kiedy ten plugin jest przydatny

Jeśli chcesz konfigurowalnego, opartego na GUI systemu aukcyjnego zintegrowanego z ekonomią serwera i Vault, AuctionHouse oferuje kontrolę ofert, wyszukiwanie/filtrowanie, opłaty/podatki i logowanie transakcji, aby zapewnić wygodny rynek graczy.