Plugin Minecraft Shopkeepers

🔌 O Shopkeepers

Shopkeepers to wtyczka Minecraft dla Bukkit/Spigot, która pozwala właścicielom serwerów stawiać konfigurowalne sklepy u wieśniaków, sprzedające ustawione przedmioty za ustawione ceny. Wtyczka obsługuje zarówno sklepy admina (nieskończony zapas), jak i sklepy graczy pobierające zapas z kontenera, a także udostępnia ShopkeepersAPI do integracji dodatków i rozszerzeń.

🎯 Cel

Wtyczka zapewnia oparty na NPC, działający w grze system sklepów, dzięki czemu serwery mogą oferować trwałe sklepy bez ręcznego zarządzania skrzyniami ani złożonych sklepów opartych na komendach. Nadaje się do ekonomii serwerowej, sklepów roleplay oraz serwerów survival/SMP, które chcą handlarzy NPC. ()

⚙️ Funkcje

• Tworzenie niestandardowych sklepów u wieśniaków z określonymi wymianami i cenami.
• Sklepy admina z nieskończonym zaopatrzeniem.
• Sklepy graczy, które pobierają przedmioty z podłączonego kontenera (skrzyni) jako zapas.
• ShopkeepersAPI dla autorów wtyczek do programowego odczytu i zarządzania handlarzami.
• Dostosowywanie przedmiotów/danych przedmiotów w grze i obsługa plików językowych przez wiki projektu i pliki językowe. ()

🧩 Dla kogo

• Serwery Survival i SMP, które chcą sklepów obsługiwanych przez NPC.
• Serwery roleplay lub ekonomiczne, które używają wieśniaków NPC jako handlarzy.
• Twórcy wtyczek, którzy potrzebują API do integracji działania sklepów z innymi systemami. ()

🏗️ Przykładowe zastosowania

• Administrator tworzy nieskończony sklep admina sprzedający towary dostarczone przez serwer.
• Gracz otwiera sklep, który automatycznie sprzedaje przedmioty z połączonej skrzyni.
• Programista tworzy dodatek, który wyświetla lub modyfikuje handlarzy za pomocą ShopkeepersAPI. ()

⌨️ Komendy

(Uwaga: powyżej wymieniono tylko komendy wyraźnie udokumentowane przez oficjalne źródła.) ()

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik jar wtyczki i umieść go w folderze plugins/ na serwerze.
• Uruchom ponownie serwer i sprawdź konsolę, aby potwierdzić, że wtyczka została załadowana.

(Są to standardowe kroki instalacji dla wtyczek Bukkit/Spigot i są opisane w dokumentacji projektu.) ()

🧠 Uwagi techniczne

• Shopkeepers jest wydawany na licencji GPL-3.0, a repozytorium projektu zawiera moduł API (ShopkeepersAPI) oraz instrukcje budowania. ()
• Projekt udostępnia artefakty Maven i publiczne API dla twórców dodatków; README opisuje użycie repozytorium i współrzędne zależności API. ()
• Oficjalna dystrybucja i wsparcie społeczności są dostępne na stronie zasobów Spigot oraz na serwerze Discord wtyczki. ()

🤝 Kiedy ta wtyczka jest przydatna

Jeśli potrzebujesz trwałych, konfigurowalnych handlarzy NPC z obsługą zarówno sklepów admina, jak i sklepów prowadzonych przez graczy, a także API do integrowania sklepów z innymi wtyczkami, Shopkeepers oferuje sprawdzone rozwiązanie dla serwerów Bukkit/Spigot. ()