Plugin Minecraft QuickShop-Hikari

🔌 O QuickShop-Hikari

QuickShop-Hikari to plugin do Minecrafta, który implementuje sklepy kupna/sprzedaży oparte na skrzyniach (ChestShops). Gracze tworzą i używają sklepów, wchodząc w interakcję ze skrzyniami; w większości rozgrywki nie są potrzebne żadne komendy. Projekt jest utrzymywany przez QuickShop-Community i skupia się na nowoczesnej kompatybilności, bezpieczeństwie danych oraz rozszerzalnych integracjach.

🎯 Cel

Zapewnienie ekonomii w grze opartej na przedmiotach, w której gracze mogą wystawiać przedmioty na sprzedaż lub tworzyć sklepy kupna za pomocą skrzyń. Plugin jest przeznaczony dla administratorów serwerów, którzy chcą fizycznej, opartej na skrzyniach ekonomii oraz kontroli per sklep, bez zmuszania graczy do nauki komend.

⚙️ Funkcje

• Tworzenie sklepów kupna i sprzedaży za pomocą skrzyń i znaków (sklepy oparte na skrzyniach).
• Obsługa danych NBT, enchantów, uszkodzeń przedmiotów, danych mikstur i jaj mobów.
• Przełączalny wirtualny wyświetlany przedmiot nad sklepami (obsługiwane przez ProtocolLib lub PacketEvents).
• Obsługa nieograniczonych skrzyń oraz mieszanego zachowania kupna/sprzedaży na podwójnych skrzyniach.
• Obsługa blacklisty z opcjami pomijania przez uprawnienia.
• Zarządzanie uprawnieniami per sklep oraz korzyści sklepu między właścicielami a innymi graczami.
• Obsługa i18n dla nazw przedmiotów i enchantów oraz składni MiniMessage dla wiadomości.
• Obsługa źródeł danych H2 (lokalnie) i MySQL (zdalnie).
• Hooki integracyjne dla popularnych wtyczek ochronnych i użytkowych (dostępne moduły kompatybilności).
• API dla deweloperów (podane współrzędne Maven/Gradle) do pobierania danych o sklepach i integracji funkcji.
• Telemetria bStats z możliwością rezygnacji w konfiguracji.

🧩 Dla kogo

Dla właścicieli i administratorów serwerów prowadzących Survival/SMP lub serwery nastawione na ekonomię, którzy chcą fizycznego rynku opartego na skrzyniach. Sprawdza się na małych i dużych serwerach używających pluginów ekonomii kompatybilnych z Vault i oczekujących kontroli per sklep oraz przechowywania opartego na bazie danych.

🏗️ Przykładowe zastosowania

• Gracze wkładają przedmioty do skrzyni i oznaczają ją, aby automatycznie sprzedawać stosy innym graczom.
• Administrator włącza uprawnienia per sklep, aby moderatorzy mogli zarządzać sklepami w określonych światach lub regionach.
• Sieć używa przechowywania MySQL, aby sklepy były trwałe między instancjami serwera.

⌨️ Komendy

Uwaga: dokumentacja projektu wskazuje, że zwykła rozgrywka graczy nie wymaga komend; komendy służą głównie administracji.

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Pobierz oficjalny plik jar QuickShop-Hikari z dystrybucji projektu (wydania Modrinth/Spigot/GitHub).
• Umieść plik jar w folderze plugins/ swojego serwera.
• Uruchom serwer i sprawdź, czy plugin został załadowany (w dokumentacji pokazano uruchomienie komendy qs w konsoli, aby wyświetlić pomoc/wynik testowy).

📦 Zależności

Potwierdzone wymagane/opcjonalne integracje wymienione przez projekt:

• Vault (wymagany do połączenia z ekonomią)
• Plugin ekonomii kompatybilny z Vault (przykłady podane przez projekt)
• ProtocolLib lub PacketEvents (wymagane dla wirtualnych przedmiotów wyświetlanych / lokalizacji per gracz)
• LuckPerms (zalecany do zarządzania uprawnieniami)

🧾 Konfiguracja

• Plugin tworzy i używa pliku config.yml (dokumentacja odnosi się do kluczy config.yml dla protokołu wyświetlania i ustawień prywatności).
• Przechowywanie danych obsługuje lokalny H2 lub zdalny MySQL; opcje konfiguracji są dostępne w plikach konfiguracyjnych pluginu.

🧠 Uwagi techniczne

• Oficjalna dokumentacja zaleca uruchamianie na serwerze opartym na Paper i podaje wymaganie Java 21.
• Projekt udostępnia API dla deweloperów oraz współrzędne Maven/Gradle do użycia podczas kompilacji.
• QuickShop-Hikari zawiera moduły kompatybilności dla wtyczek zewnętrznych (np. WorldGuard, WorldEdit, OpenInv) jako opcjonalne pobrania.
• Telemetria: używa bStats; można zrezygnować przez ustawienia konfiguracji.

🤝 Kiedy ten plugin jest przydatny

Jeśli chcesz rynek dla graczy oparty na skrzyniach, z trwałym przechowywaniem i kontrolą per sklep (zamiast sklepów opartych wyłącznie na GUI lub komendach), QuickShop-Hikari oferuje nowoczesną implementację opartą na bazie danych, z hookami dla popularnych pluginów ekonomii i ochrony.