Discord
Wiki - Pluginy

AuctionHouse - dom aukcyjny na serwerze

AuctionHouse

AuctionHouse to darmowy plugin, który dodaje do serwera Minecraft pełnoprawny system aukcyjny w stylu domu aukcyjnego z Hypixela. Gracze wystawiają przedmioty na sprzedaż, inni przeglądają oferty przez GUI i kupują lub licytują. Wszystko bez skrzyń, szyldów i chodzenia po mapie.

Czas czytania: ~6 min Platforma: Paper / Spigot / Purpur

Co to jest AuctionHouse

AuctionHouse to plugin handlowy działający na zasadzie globalnego rynku. Zamiast fizycznych sklepów w świecie gry, cały handel odbywa się przez interfejs GUI dostępny z poziomu komendy /ah. Gracz wystawia przedmiot, ustala cenę, a każdy inny gracz na serwerze może go kupić bez konieczności szukania sklepu na mapie.

Plugin obsługuje dwa tryby transakcji: bezpośredni zakup po ustalonej cenie (Buy It Now) oraz licytację, gdzie gracze przebijają się nawzajem przez określony czas. Możesz włączyć oba tryby jednocześnie lub ograniczyć serwer do jednego z nich.

AuctionHouse jest dostępny na SpigotMC. Jest darmowy, open-source, wymaga Vault i pluginu ekonomii. Obsługuje wersje od 1.8 do 1.21.x.

Wystawianie przedmiotów

Wystawienie przedmiotu na aukcję jest proste:

  1. Trzymaj przedmiot w ręku.
  2. Wpisz /ah sell [cena] (np. /ah sell 500).
  3. Przedmiot zostaje wystawiony na dom aukcyjny i jest widoczny dla wszystkich graczy.

Dla licytacji użyj /ah sell [cena startowa] -b. Cena startowa to minimalna oferta, od której zaczyna się licytacja. Domyślny czas trwania aukcji to 48 godzin (konfigurowalny).

Gracz może wystawić jednocześnie ograniczoną liczbę przedmiotów (domyślnie 15, konfigurowane per ranga). Jeśli przedmiot się nie sprzeda, wraca do sekcji "wygasłe" w GUI, skąd gracz może go odebrać.

Plugin zachowuje pełne dane przedmiotu: enchanty, lore, custom model data, zawartość shulker boxów i wszystkie NBT. Gracz kupuje dokładnie to, co widzi w podglądzie.

Przeglądanie i kupowanie

Menu domu aukcyjnego otwierasz komendą /ah. W GUI widzisz siatkę przedmiotów wystawionych na sprzedaż. Najnowsze oferty pojawiają się pierwsze. Możesz filtrować po:

  • Kategorii - bloki, bronie, zbroje, narzędzia, jedzenie, różne.
  • Trybie - kupno natychmiastowe lub licytacje.
  • Sortowaniu - cena rosnąco/malejąco, najnowsze, najstarsze.
  • Wyszukiwaniu - szukaj po nazwie przedmiotu.

Kliknięcie przedmiotu otwiera podgląd ze szczegółami: sprzedawca, cena, czas do wygaśnięcia, enchanty. Przycisk "Kup teraz" finalizuje transakcję - pieniądze przechodzą do sprzedawcy, przedmiot do kupującego.

W przypadku licytacji klikasz "Licytuj" i podajesz kwotę. Jeśli ktoś cię przebije, dostajesz powiadomienie. Możesz podbić lub odpuścić. Po zakończeniu aukcji zwycięzca otrzymuje przedmiot, a przegrany odzyskuje pieniądze.

Komendy i uprawnienia

Komenda Opis Uprawnienie
/ah Otwiera dom aukcyjny auctionhouse.use
/ah sell [cena] Wystawia przedmiot z ręki auctionhouse.sell
/ah sell [cena] -b Wystawia licytację auctionhouse.sell.bid
/ah search [fraza] Szuka przedmiotu po nazwie auctionhouse.search
/ah expired Pokazuje wygasłe aukcje gracza auctionhouse.expired
/ah active Pokazuje aktywne aukcje gracza auctionhouse.active
/ah admin Panel administracyjny auctionhouse.admin
/ah reload Przeładowuje konfigurację auctionhouse.reload

Limit aukcji per ranga kontrolujesz uprawnieniem auctionhouse.maxauctions.[liczba]. Przykład: gracze z rangą VIP mogą mieć auctionhouse.maxauctions.30, a domyślna ranga 10.

Konfiguracja

Kluczowe ustawienia w plugins/AuctionHouse/config.yml:

# Aukcje
default-auction-time: 48       # czas trwania aukcji w godzinach
allow-bid-system: true         # włącz licytacje
min-listing-price: 1.0         # minimalna cena wystawienia
max-listing-price: 1000000.0   # maksymalna cena wystawienia

# Opłaty
listing-fee: 0.0               # opłata za wystawienie (0 = darmowe)
listing-tax: 5.0               # procent podatku od sprzedaży

# Limity
max-active-auctions: 15        # max aktywnych aukcji per gracz
expired-item-claim-days: 7     # ile dni na odebranie wygasłego przedmiotu

# Blacklist
disabled-items:
  - BEDROCK
  - BARRIER
  - COMMAND_BLOCK

Podatek od sprzedaży (listing-tax) to ważny mechanizm ekonomiczny. Przy ustawieniu 5% gracz sprzedający diamentowy miecz za 1000$ otrzyma 950$, a 50$ znika z obiegu. To zapobiega inflacji na serwerach z dużym obrotem handlowym.

Porady dla adminów

  • Ogranicz czas aukcji - 24-48 godzin wystarczy. Dłuższe aukcje zaśmiecają GUI nieaktualnymi ofertami.
  • Ustaw minimalną cenę - bez tego gracze wystawiają diamentowe miecze za 1$, co psuje ekonomię. Minimum 10-50$ zapobiega dumpingowi.
  • Blacklistuj wrażliwe przedmioty - spawner, barrier, command block, shulker boxy z zawartością exploitów.
  • AuctionHouse + ShopGUI+ to dobry duet - sklep admina (stałe ceny podstawowych surowców) + dom aukcyjny (wolny rynek na rzadkie przedmioty) tworzy naturalną dwupoziomową ekonomię.
  • Licytacje dodają emocji - włącz je przynajmniej dla rzadkich przedmiotów. Gracze chętnie rywalizują o netherite'owy miecz z Sharpness V.

Powiązane artykuły: Vault, ShopGUI+, QuickShop Hikari, katalog pluginów.