ChestShop – sklepy graczy na serwerze Minecraft

Co to jest ChestShop

ChestShop to darmowy plugin serwerowy pozwalający graczom i administratorom tworzyć sklepy bezpośrednio w świecie gry – bez żadnych GUI, klikania w menu czy wirtualnych interfejsów. Cały mechanizm opiera się na szyldzie zawieszonym nad skrzynią. Chcesz sprzedawać diamenty? Staw skrzynię, wbij gwoździa (metaforycznie), poczep szyld z ceną i gotowe – sklep działa.

Plugin istnieje od bardzo dawna i przez lata stał się standardem na serwerach ekonomicznych. Jego prostota jest jego największą zaletą: gracz nie musi uczyć się obsługi żadnego GUI. Wystarczy podejść do szyldu i kliknąć prawym lub lewym przyciskiem myszy, żeby kupić lub sprzedać przedmiot. To naturalne i intuicyjne, szczególnie dla graczy przyzwyczajonych do vanilla Minecrafta.

ChestShop jest dostępny na SpigotMC. Działa wyłącznie ze Spigot, Paper i pochodnymi (Purpur, Folia w trybie kompatybilności). Wymaga Vault oraz dowolnego pluginu ekonomii – najczęściej jest to moduł ekonomii z EssentialsX.

ChestShop obsługuje:

• sklepy kupna (gracz sprzedaje przedmioty serwerowi lub innemu graczowi),
• sklepy sprzedaży (gracz kupuje przedmioty od właściciela sklepu),
• sklepy kombinowane (jednocześnie kupno i sprzedaż),
• AdminShopy z nieskończonym stanem magazynowym,
• system podatków od transakcji,
• ograniczenia per przedmiot i per gracz.

Tworzenie sklepu – format szyldu

Szyld ChestShop składa się z dokładnie czterech linii. Każda linia pełni określoną rolę:

Format linii 3 jest kluczowy. Litera B oznacza cenę, za jaką gracz może kupić (Buy) od właściciela sklepu. Litera S oznacza cenę, za jaką właściciel sklepu skupuje (Sell) od gracza. Możesz podać tylko jedną z opcji lub obie:

B 50          # tylko zakup – gracze mogą tylko kupować
S 30          # tylko skup – gracze mogą tylko sprzedawać
B 50 : S 30   # obie opcje jednocześnie

Przykład kompletnego szyldu sprzedającego 64 kamienie za 10$, skupującego za 5$:

Rabus
64
B 10 : S 5
STONE

Jak założyć sklep krok po kroku:

1. Postaw skrzynię w dowolnym miejscu (możesz też użyć podwójnej skrzyni).
2. Umieść szyld bezpośrednio na skrzyni lub nad nią (blok przylegający).
3. Wpisz cztery linie w odpowiednim formacie.
4. Trzymaj w ręku przedmiot, który chcesz sprzedawać (jeśli plugin nie rozpoznaje nazwy automatycznie).
5. Kliknij prawym przyciskiem myszy szyld – ChestShop potwierdzi utworzenie sklepu.

Skrzynia musi zawierać przynajmniej jeden egzemplarz sprzedawanego przedmiotu, żeby transakcje kupna działały. Jeśli skrzynia jest pusta, kupujący zobaczy komunikat o braku towaru.

Kupowanie i sprzedawanie

Obsługa sklepu jako klient jest prosta:

• Prawym przyciskiem myszy w szyld – kupujesz przedmioty od właściciela sklepu (opcja B).
• Lewym przyciskiem myszy w szyld – sprzedajesz własne przedmioty właścicielowi sklepu (opcja S).

Każde kliknięcie realizuje jedną porcję transakcji – ilość podaną w linii 2 szyldu. Klikniesz prawym i kupujesz np. 64 kamienie za 10$. Klikniesz jeszcze raz – kolejne 64. Tak dopóki skrzynia właściciela ma towar, a ty masz kasę.

Gracz otrzymuje powiadomienie w chacie po każdej udanej transakcji, wraz z informacją o kwocie i aktualnym saldzie. Jeśli transakcja się nie powiedzie (brak towaru, brak miejsca w ekwipunku, niewystarczające środki), ChestShop poinformuje o przyczynie.

Właściciel sklepu może sprawdzić historię transakcji przez komendę /cslogs lub przeglądając plik logów w folderze pluginu. Konfiguracja logowania jest dostępna w config.yml.

Sklepy adminowe (AdminShop)

AdminShop to specjalny rodzaj sklepu, który działa bez fizycznej skrzyni z towarem. Właściciel ma nieograniczony stan magazynowy – gracze mogą kupować ile chcą, a sprzedawać ile chcą (do limitów ustawionych przez admina). To podstawa każdego serwera ekonomicznego, gdzie chcesz zapewnić graczom stały dostęp do podstawowych surowców.

Jak stworzyć AdminShop:

1. Musisz mieć uprawnienie chestshop.admin.
2. W pierwszej linii szyldu wpisz [Admin] (z nawiasami kwadratowymi, wielkość liter nieistotna).
3. Pozostałe linie wypełnij normalnie.

Przykład AdminShop skupującego żelazo po 5$ za 1 sztukę:

[Admin]
1
S 5
IRON_INGOT

AdminShopy są często używane do:

• tworzenia serwerowych sklepów z podstawowymi surowcami (drewno, kamień, żywność),
• skupowania od graczy surowców w nieskończoność (np. drewna jako źródło dochodów dla nowych graczy),
• regulowania cen na rynku – AdminShop z diamentami za 100$ wyznacza górny pułap cen u graczy.

Ważne: AdminShopy nie wymagają fizycznej skrzyni, ale możesz ją postawić – plugin ją zignoruje. Niektórzy admini stawiają dekoracyjną skrzynię dla estetyki sklepu.

Konfiguracja

Główny plik konfiguracyjny ChestShop to plugins/ChestShop/config.yml. Najważniejsze opcje:

# Ogólne ustawienia
allow_multiple_shops_per_chest: false   # czy jedna skrzynia może mieć wiele szyldów
allow_only_one_shop_per_user_per_world: false  # limit jednego sklepu na gracza
remove_shop_when_chest_is_removed: true # usuń szyld gdy skrzynia zniknie

# Ekonomia
shop_creation_price: 0.0        # koszt założenia sklepu (0 = darmowe)
tax_amount: 0.0                  # procent podatku od transakcji (np. 5.0 = 5%)
tax_account: ""                  # konto zbierające podatek (puste = usuwane z obiegu)

# Powiadomienia
notify_players_on_transaction: true     # chat-msg przy każdej transakcji
notify_shop_owners_of_transactions: true # właściciel dostaje info o sprzedaży
send_notification_via_message: false    # alternatywnie przez /msg zamiast chatu

# Logowanie
log_to_console: true             # logi transakcji w konsoli serwera
log_to_file: true                # logi do pliku CSV w folderze pluginu

# Ochrona
protect_chest_with_chestshop: true  # skrzynia chroniona przed kradzieżą
prevent_item_place_into_protected_chest: false

System podatków jest potężnym narzędziem ekonomicznym. Ustawienie tax_amount: 5.0 oznacza, że przy każdej transakcji 5% wartości trafia na wskazane konto (lub znika z obiegu). To naturalny odpływ pieniędzy zapobiegający inflacji – szczególnie ważne na długo działających serwerach survival.

Czarna lista przedmiotów (które gracze nie mogą sprzedawać w sklepach) definiuje się w sekcji blacklisted_items:

blacklisted_items:
  - BEDROCK
  - COMMAND_BLOCK
  - BARRIER
  - SPAWNER

Uprawnienia

ChestShop używa następujących węzłów uprawnień (zarządzaj przez LuckPerms):

Możesz też ograniczać liczbę sklepów per ranga przez węzły chestshop.shop.limit.[liczba], np. chestshop.shop.limit.5 daje graczowi limit 5 sklepów. Rangom VIP przydziel wyższy limit jako benefit.

Integracja z ekonomią (Vault)

ChestShop nie obsługuje ekonomii samodzielnie – do działania potrzebuje Vault jako pośrednika między pluginem sklepowym a wybranym systemem ekonomii. To standardowy schemat na serwerach Minecraft z ekonomią.

Stos zależności wygląda tak:

ChestShop
    └─ Vault (most ekonomii)
         └─ EssentialsX Economy / CMI / CoinsEngine / TokenManager

Instalacja:

1. Pobierz i zainstaluj Vault.
2. Zainstaluj plugin ekonomii (np. EssentialsX – jego moduł Economy automatycznie rejestruje się w Vault).
3. Zainstaluj ChestShop.
4. Uruchom serwer – przy starcie w logach zobaczysz [ChestShop] Economy: EssentialsX Economy (lub nazwa twojego pluginu ekonomii).

Jeśli Vault nie jest zainstalowany lub żaden plugin ekonomii się nie zarejestrował, ChestShop wypisze błąd przy starcie i sklepy nie będą działać. W takim wypadku sprawdź logi startu serwera.

ChestShop współpracuje ze wszystkimi popularnymi systemami ekonomii: EssentialsX Economy, CMI, CoinsEngine, iConomy, BOSEconomy, ReserveEconomy i innymi zarejestrowanymi w Vault. Nie jesteś przywiązany do jednego rozwiązania.

Porady i najczęstsze błędy

Najczęstsze problemy przy tworzeniu sklepu

• Szyld nie tworzy sklepu – sprawdź czy skrzynia jest bezpośrednio pod szyldem lub przyległa. ChestShop akceptuje szyld na górze skrzyni, na ścianie obok lub na bloku powyżej. Upewnij się też, że masz uprawnienie chestshop.shop.create.
• "Item not found" – ChestShop nie rozpoznał nazwy przedmiotu w linii 4. Trzymaj przedmiot w ręku podczas tworzenia szyldu lub użyj dokładnej nazwy materiału (np. OAK_LOG zamiast log). Możesz też wpisać ID numeryczne.
• Sklep działa ale pieniądze nie przechodzą – problem z Vault lub pluginem ekonomii. Sprawdź /balance – jeśli komenda nie działa, ekonomia nie jest załadowana.
• Skrzynia jest pełna i gracze nie mogą sprzedawać – sklep skupujący (S) musi mieć miejsce w skrzyni. Regularnie opróżniaj skrzynię lub użyj AdminShop jeśli chcesz skupować bez limitu.
• Cudzy gracz zniszczył mój szyld – ChestShop domyślnie chroni szyld, ale nie skrzynię (wymaga WorldGuard lub GriefPrevention do pełnej ochrony terenu).

Porady dla adminów

• Ustaw podatek 2-5% – to prosty mechanizm odpływu pieniędzy z obiegu, który zapobiega hiperinflacji na długo działających serwerach.
• Ogranicz listę blacklisted items – zablokuj handel spawnerami, command blockami i innymi wrażliwymi przedmiotami.
• Twórz AdminShopy z surowcami podstawowymi – drewno, kamień, żywność po stałych cenach dają nowym graczom punkt odniesienia i stabilizują rynek.
• Ogranicz liczbę sklepów per ranga – bez limitu gracze mogą zastawić cały spawn szyldami. Limit 3-5 sklepów dla podstawowych rang to rozsądne podejście.
• Logi transakcji – włącz log_to_file: true jeśli masz na serwerze problemy z oszustwami lub chcesz analizować przepływy ekonomiczne.
• Integracja z regionami – na serwerach z WorldGuard możesz tworzyć specjalne regiony handlowe (targowisko, market district) gdzie sklepy są dozwolone, a poza nimi nie.

Alternatywy – QuickShop i ShopGUI+

ChestShop nie jest jedyną opcją na rynku. Zależnie od stylu serwera i preferencji graczy, warto rozważyć alternatywy:

QuickShop Hikari

Nowsza i aktywnie rozwijana alternatywa dla ChestShop. Działa na tej samej zasadzie (skrzynia + szyld), ale ma nowocześniejszy interfejs, lepszą obsługę wersji 1.20+, wbudowane GUI do przeglądu sklepów i natywne wsparcie dla baz danych (MySQL/SQLite). Dla nowych serwerów na 1.20+ QuickShop Hikari może być lepszym wyborem niż klasyczny ChestShop.

ShopGUI+

Zupełnie inne podejście – płatny plugin ($15 na SpigotMC) z pełnym GUI w stylu klikanych menu. Admin konfiguruje asortyment w pliku YAML lub przez panel w grze, gracze kupują i sprzedają przez interfejs graficzny. Nie ma sklepów gracza – to bardziej serwisowy sklep administracyjny. Popularny na serwerach PvP, Skyblock i Factions, gdzie liczy się szybkość transakcji, nie immersja.

Kiedy wybrać ChestShop?

• Serwer survival/RPG z ekonomią opartą na graczach.
• Chcesz, żeby gracze sami tworzyli sklepy w świecie gry.
• Zależy ci na immersji i naturalnym wyglądzie rynku.
• Serwer działa na starszej wersji (1.16-1.19) gdzie ChestShop jest bardziej przetestowany.

Więcej opcji znajdziesz w katalogu pluginów.

Kompatybilność

ChestShop jest kompatybilny ze wszystkimi popularnymi pluginami ochrony terenu. Sklepy działają poprawnie w strzeżonych regionach WorldGuard i działkach GriefPrevention – plugin respektuje zabezpieczenia przed nieuprawnionym dostępem do skrzyni.

Powiązane artykuły: Vault – most ekonomii, EssentialsX – podstawowy plugin serwerowy, katalog wszystkich pluginów.