Plugin Minecraft ChestShop

🔌 O ChestShopie

ChestShop to wtyczka do Minecrafta do tworzenia sklepów prowadzonych przez graczy przy użyciu skrzyń i tabliczek. Łączy działania sklepu z ekonomią serwera (przez Vault lub Reserve), dzięki czemu gracze mogą kupować i sprzedawać przedmioty za walutę serwera. Projekt jest utrzymywany na GitHubie i udostępnia buildy przez popularne platformy z wtyczkami.

🎯 Cel

Zapewnić prosty, trwały rynek w świecie gry, w którym gracze tworzą sklepy, stawiając tabliczkę na skrzyni. ChestShop obsługuje transakcje między ekwipunkiem gracza a ekonomią serwera oraz zawiera zabezpieczenia i hooki zgodności, aby ograniczyć griefing i nakład pracy przy integracji.

⚙️ Funkcje

• Tworzenie sklepów kupna/sprzedaży przez umieszczenie sformatowanej tabliczki na skrzyni.
• Integracja z Vault lub Reserve oraz innymi kompatybilnymi wtyczkami ekonomii do obsługi pieniędzy.
• Opcje ochrony sklepu i zgodności, uwzględniające popularne wtyczki ochrony skrzyń.
• Środki antylagowe / zabezpieczające transakcje opisane przez autorów.
• Rozszerzalność dzięki dodatkom społeczności i wtyczkom zgodności (lista dodatków jest utrzymywana przez projekt).
• W nowszych wydaniach dodano komendy administracyjne i informacyjne (przykłady: /shopinfo, /iteminfo).

🧩 Dla kogo

• Serwery Survival i SMP korzystające z ekonomii opartej na walucie.
• Serwery, które chcą prostych sklepów graczy opartych na tabliczkach zamiast sklepów GUI.
• Administratorzy, którzy wolą sklepy przechowujące przedmioty w zwykłych skrzyniach (bez obowiązkowej bazy danych do podstawowego przechowywania sklepu).

🏗️ Przykładowe zastosowania

• Gracze stawiają skrzynię, wkładają przedmiot do sprzedaży i tworzą tabliczkę, aby ustawić ceny kupna/sprzedaży; inni gracze klikają tabliczkę, aby handlować.
• Administratorzy serwera tworzą sklepy admina do sprzedaży przedmiotów prowadzonych przez serwer.
• Społeczność dodaje wtyczkę zgodności, aby zintegrować ChestShop z dodatkiem ochrony lub wyświetlania.

⌨️ Komendy

(Wymienione komendy pochodzą z notatek wydań i dokumentacji projektu. Pokazano tylko komendy wyraźnie udokumentowane przez projekt.)

🔐 Uprawnienia

(Node’y uprawnień są uwzględniane tylko wtedy, gdy pojawiają się w oficjalnych materiałach projektu i notatkach wydań.)

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik .jar ChestShop i umieść go w folderze plugins/ serwera.
• Zainstaluj Vault lub Reserve oraz kompatybilną wtyczkę ekonomii, która udostępnia API pieniędzy.
• Zrestartuj serwer i sprawdź konsolę serwera, aby potwierdzić, że ChestShop uruchomił się poprawnie.

📦 Zależności

• Vault (obsługiwana integracja) lub Reserve (obsługiwana integracja)
• Kompatybilna wtyczka ekonomii udostępniająca API pieniędzy (zainstalowana razem z Vault/Reserve)

🧾 Konfiguracja

Wtyczka generuje pliki konfiguracyjne/yml przy pierwszym uruchomieniu; opcje konfiguracji i przełączniki zgodności są dostępne w tych plikach oraz w dokumentacji projektu.

🧠 Uwagi techniczne

• Kod źródłowy i śledzenie zgłoszeń są hostowane na GitHubie na licencji LGPL-2.1.
• Projekt publikuje buildy i artefakty wydań na popularnych stronach z wtyczkami; opiekunowie publikują też buildy deweloperskie na serwerze CI.
• ChestShop jest przeznaczony dla typów serwerów Bukkit/Spigot/Paper (dokumentacja projektu i repozytorium mówią to wprost).

🤝 Kiedy ta wtyczka jest przydatna

Jeśli chcesz prostego rynku w świecie gry, w którym przedmioty pozostają w zwykłych skrzyniach, a transakcje korzystają z waluty twojego serwera, ChestShop oferuje dojrzały i rozszerzalny system sklepów oparty na skrzyniach i tabliczkach z integracją ekonomii i zgodnością z dodatkami.