Problemy

Najczęstszy problem przy pierwszej instalacji.

1. Masz Vaulta, ale nie masz pluginu ekonomii. Vault to tylko warstwa pośrednia — nie trzyma sald. Doinstaluj EssentialsX albo inny plugin ekonomii.
2. Plugin ekonomii nie wystartował. /plugins — musi być na zielono.
3. Zła kolejność wczytywania. Zrestartuj serwer zamiast używać /reload.

Test: /balance musi zwracać kwotę, a /vault-info wskazywać plugin obsługujący ekonomię. Szczegóły: Vault i ekonomia.

Komunikat o aktywnych transakcjach oznacza, że ktoś właśnie jest w trakcie zakupu — jego oferta jest zarezerwowana.

To zabezpieczenie, nie błąd. Przeładowanie w połowie transakcji mogłoby zgubić przedmiot albo pieniądze. Poczekaj kilkanaście sekund i spróbuj ponownie.

Jeśli blokada utrzymuje się długo, sprawdź logi transakcji (transactions.logging: true) — być może jakaś transakcja zawisła. Wtedy przyda się /market admin list i /market admin inspect <id>.

settings.gui-rows w config.yml nic nie robi w wersji 1.0.3. Jest wczytywana i ignorowana.

Rozmiar okna przeglądania ustawia się w gui.yml:

browse:
  size: 27

Szczegóły: GUI i gui.yml.

history.enabled: false bramkuje tylko komendę /market history. Przycisk historii w oknie przeglądania nie sprawdza tej flagi i otwiera historię zawsze.

Transakcje są zapisywane niezależnie od tej opcji.

market.history, market.mailbox i market.alerts istnieją w plugin.yml, ale kod ich nie sprawdza. Odebranie ich nic nie zmienia.

Te funkcje wyłącza się flagami w config.yml — patrz Komendy i uprawnienia.

Sprawdź po kolei:

1. Czy to jego własna oferta? Nie da się kupić od siebie.
2. anti-abuse.max-transaction-value. To sufit ceny przy zakupie, niezależny od settings.max-price. Oferta droższa od tego limitu jest nie do kupienia, choć dało się ją wystawić.
3. Limit zakupów od jednego sprzedawcy. max-purchases-from-same-player w oknie purchase-window-seconds.
4. Pełny ekwipunek.
5. Czy oferta jeszcze istnieje? Mogła zostać kupiona przez kogoś innego albo wygasnąć.

Przy transactions.logging: true w konsoli widać, na którym kroku transakcja się zatrzymała.

To prowizja od sprzedaży — domyślnie 5%. Kupujący płaci pełną cenę, sprzedawca dostaje ją pomniejszoną o prowizję.

Ekran potwierdzenia pokazuje obie kwoty przed zakupem. Żeby wyłączyć prowizje:

market-fee:
  enabled: false

Wygasłe oferty wracają do właściciela. Gdzie dokładnie — zależy od mailbox.enabled:

Pierwsze miejsce do sprawdzenia to zawsze /market mailbox.

Jeśli ustawiłeś market-fee.sink-account, a na koncie nic nie przybywa:

1. Konto nie istnieje w twoim pluginie ekonomii. Utwórz je albo użyj istniejącego.
2. Literówka w nazwie. Wartość jest przycinana ze spacji, ale nie poprawiana.
3. Sprawdź log serwera — błąd wpłaty zostawia ostrzeżenie. Zakup mimo to kończy się sukcesem, a prowizja przepada.

Prowizja od wystawienia nigdy nie idzie na sink — jest po prostu ściągana z wystawiającego.

Licznik zakupów i cooldown wystawiania żyją w pamięci i znikają przy restarcie serwera.

Na serwerze restartowanym co kilka godzin dobowy limit zakupów jest w praktyce znacznie luźniejszy, niż wynika z konfiguracji. To znane ograniczenie, nie błąd konfiguracji.

Najszybszy test to wbudowany autotest:

/market admin selftest

Bez podania nicków plugin utworzy dwa testowe konta-boty i przeprowadzi na nich pełną transakcję: wystawienie, rezerwację, zapłatę, wypłatę i dostarczenie przedmiotu.

To pierwsza rzecz do uruchomienia po większej zmianie konfiguracji albo aktualizacji.

Nexo i Oraxen są zależnościami miękkimi, wykrywanymi przy starcie pluginu. Jeśli zainstalowałeś je po rynku, zrób pełny restart serwera — /market reload nie wystarczy.

Szczegóły: Nexo, Oraxen i PlaceholderAPI.