Vault i ekonomia
Bez działającej ekonomii rynek nie ruszy. Instalacja Vaulta i pluginu ekonomii od zera.
To najczęstszy punkt, w którym instalacja się wykłada. Warto poświęcić mu pięć minut, zanim zaczniesz szukać błędów w samym rynku.
Dlaczego potrzebne są dwa pluginy
Vault sam z siebie nie ma pieniędzy
Vault to warstwa pośrednia, nie ekonomia. Nie trzyma sald, nie wie, ile kto ma. Jego rolą jest dać pluginom jeden wspólny sposób rozmawiania z dowolnym pluginem ekonomii.
Sam Vault bez pluginu ekonomii = rynek nie działa.
GrzybcioRynek
│ „przelej 100 od gracza A do gracza B"
▼
Vault ← tłumacz, nie bank
│
▼
EssentialsX ← tu faktycznie są saldaInstalacja
Vault
Wrzuć Vault.jar do plugins/ i zrestartuj serwer.
Sprawdź /plugins — Vault powinien być na zielono.
Plugin ekonomii
Najpopularniejszy wybór to EssentialsX. Alternatywy: CMI, BentoBox Economy i kilka innych — rynek nie ma preferencji, byle działały przez Vaulta.
Wrzuć plik JAR do plugins/ i zrestartuj.
Sprawdź, czy ekonomia działa
Wejdź na serwer i wpisz:
/balanceMusi zwrócić kwotę. Jeśli zwraca „unknown command" albo błąd, ekonomia nie działa i nie ma sensu iść dalej.
Sprawdź, czy Vault ją widzi
/vault-infoW odpowiedzi powinno być wypisane, który plugin obsługuje ekonomię. Jeśli w tym miejscu jest pusto, rynek też jej nie znajdzie.
Dopiero teraz wgraj GrzybcioRynek
Restart serwera. W konsoli nie powinno być ostrzeżeń o braku ekonomii.
Nadanie graczom pieniędzy do testów
/eco give Nick 10000Bez pieniędzy nie przetestujesz zakupu, a „nie działa kupowanie" bardzo często oznacza po prostu puste konto.
Prowizje a ekonomia
Rynek pobiera dwa rodzaje prowizji — opisane szczegółowo w Konfiguracji:
| Prowizja | Kto płaci | Kiedy |
|---|---|---|
| Od wystawienia | Sprzedawca | Przy wystawianiu oferty |
| Od sprzedaży | Sprzedawca | Potrącana z ceny przy zakupie |
Kupujący zawsze płaci pełną cenę widoczną w ofercie. Sprzedawca dostaje cenę pomniejszoną o prowizję od sprzedaży.
Gdzie trafiają prowizje
Opcja market-fee.sink-account decyduje, co się dzieje z prowizją od sprzedaży:
| Wartość | Efekt |
|---|---|
"" (puste) | Pieniądze znikają z ekonomii — klasyczny money sink |
"serwer" | Trafiają na konto Vault o tej nazwie |
Money sink to nie strata
Znikanie pieniędzy z obiegu to normalne narzędzie przeciw inflacji na serwerze. Jeśli gracze drukują pieniądze szybciej, niż je wydają, prowizja spalana przy każdej transakcji spowalnia ten proces.
Konto skarbca musi istnieć
Jeśli wpiszesz nazwę konta, które nie istnieje w twoim pluginie ekonomii, wpłata się nie uda. Zakup mimo to zakończy się sukcesem, a w logu pojawi się ostrzeżenie — prowizja po prostu przepadnie. Sprawdź log po pierwszej transakcji.
Wypłata dla sprzedawcy offline
Gdy ktoś kupi przedmiot nieobecnego gracza, pieniądze trafiają na jego konto od razu — nie musi być online. Vault operuje na kontach, nie na graczach w grze.
Częste problemy
Kolejność przyczyn:
- Nie ma pluginu ekonomii — sam Vault nie wystarczy.
- Plugin ekonomii nie wystartował. Sprawdź
/plugins, czy nie jest czerwony. - Zła kolejność wczytywania — zrestartuj serwer zamiast używać
/reload.
- Sprawdź, czy
/balancepokazuje saldo tego samego gracza, którym testujesz. - Sprawdź limit
anti-abuse.max-transaction-value— droższe oferty są blokowane przy zakupie, nawet jeśli dało się je wystawić. - Zajrzyj do logu — przy
transactions.logging: truewidać każdy krok transakcji.
To nie błąd, tylko prowizja od sprzedaży — domyślnie 5%. Kupujący płaci pełną cenę, sprzedawca dostaje ją pomniejszoną o prowizję.
Żeby to wyłączyć:
market-fee:
enabled: false