Discord
Wiki - Pluginy

QuickShop Hikari - nowoczesne sklepy graczy

QuickShop Hikari to aktywnie rozwijany fork QuickShop Reremake, uznawany za następcę klasycznego ChestShop. Oferuje sklepy oparte na skrzyniach z wbudowanym GUI do przeglądania ofert, natywną obsługę MySQL i SQLite oraz pełne wsparcie dla Paper, Purpur i Folia od wersji 1.18 do 1.21.x.

Czas czytania: ~6 min Platforma: Paper / Purpur / Folia

Co to jest QuickShop Hikari

QuickShop Hikari to darmowy, open-source plugin sklepowy, który pozwala graczom tworzyć sklepy bezpośrednio na skrzyniach w świecie gry. W przeciwieństwie do starszego ChestShop nie wymaga ręcznego wpisywania na szyldach - wystarczy komenda /qs create [cena] patrząc na skrzynię, a plugin sam wygeneruje szyld z hologramem nad sklepem.

Hikari jest forkiem QuickShop Reremake, który został porzucony w 2022 roku. Ghost_chu przejął projekt, przepisał silnik bazodanowy, dodał wsparcie dla Folia i utrzymuje regularny cykl aktualizacji. Na Modrinth plugin ma ponad 300 000 pobrań i jest jednym z najpopularniejszych pluginów handlowych w ekosystemie Paper.

Plugin jest dostępny na Modrinth i GitHub. Wymaga Java 17+, Paper/Purpur 1.18+ i opcjonalnie Vault (posiada też wbudowany silnik ekonomii).

Tworzenie sklepu

Proces tworzenia sklepu w QuickShop Hikari jest prostszy niż w ChestShop:

  1. Postaw skrzynię w dowolnym miejscu.
  2. Trzymaj w ręku przedmiot, który chcesz sprzedawać.
  3. Patrząc na skrzynię, wpisz /qs create [cena] (np. /qs create 50).
  4. Plugin automatycznie stworzy sklep z szyldem i hologramem nad skrzynią.

Domyślnie nowy sklep jest sklepem sprzedaży (gracze kupują od ciebie). Żeby zmienić tryb na skup, użyj /qs buy stojąc obok sklepu. Możesz też ustawić oba tryby jednocześnie przez GUI.

Gracze przeglądają oferty przez wbudowane GUI wywołane komendą /qs find [przedmiot]. Wyświetla listę wszystkich sklepów na serwerze sprzedających dany przedmiot, posortowaną po cenie. To ogromna przewaga nad ChestShop, gdzie musisz fizycznie chodzić po mapie szukając towaru.

Komendy i uprawnienia

Komenda Opis Uprawnienie
/qs create [cena] Tworzy sklep na skrzyni, na którą patrzysz quickshop.create.sell
/qs sell Ustawia sklep w tryb sprzedaży quickshop.create.sell
/qs buy Ustawia sklep w tryb skupu quickshop.create.buy
/qs price [cena] Zmienia cenę w sklepie quickshop.create.changeprice
/qs find [przedmiot] Wyszukuje sklepy z danym przedmiotem quickshop.find
/qs staff add [nick] Dodaje pracownika do sklepu quickshop.create.staff
/qs remove Usuwa sklep quickshop.create.sell
/qs fetchmessage Sprawdza powiadomienia o transakcjach offline quickshop.fetchmessage

Administrator ma dodatkowe komendy: /qs supercreate (sklep bez fizycznej skrzyni), /qs clean (usuwa puste sklepy), /qs export i /qs import (migracja danych).

Konfiguracja

Główny plik to plugins/QuickShop-Hikari/config.yml. Najważniejsze opcje:

# Ekonomia
shop:
  cost: 10.0                    # koszt utworzenia sklepu
  tax: 0.05                     # podatek od transakcji (5%)
  unlimited: false              # nieograniczony stan (admin)
  allow-stacks: false           # pozwól na handel stosami

# Wyświetlanie
display:
  type: VIRTUALITEM             # hologram nad sklepem (nie spawnuje entity)
  auto-despawn: true            # usuwa display gdy sklep jest pusty

# Baza danych
database:
  type: SQLITE                  # SQLITE lub MYSQL
  mysql:
    host: localhost
    port: 3306
    database: quickshop
    user: root
    password: ""

# Ochrona
protection:
  chest: true                   # chroni skrzynię sklepu
  sign: true                    # chroni szyld sklepu

QuickShop Hikari obsługuje PlaceholderAPI - możesz wyświetlać statystyki sklepowe w scoreboard, hologramach i tabulatorze. Dostępne placeholdery to m.in. %quickshop_total_shops% i %quickshop_player_shops%.

Bazy danych i wydajność

Jedna z największych przewag Hikari nad starszymi pluginami to natywna obsługa baz danych. SQLite działa out-of-the-box bez żadnej konfiguracji. Na większych serwerach (100+ graczy, tysiące sklepów) zalecane jest przejście na MySQL lub MariaDB.

Plugin wykonuje wszystkie operacje bazodanowe asynchronicznie, więc nie blokuje głównego wątku serwera. Sklepy ładują się leniwie - dane konkretnego sklepu są wczytywane dopiero gdy gracz się do niego zbliży.

Na serwerach z Folia QuickShop Hikari wykorzystuje wielowątkowy scheduler, co oznacza że sklepy w różnych regionach są obsługiwane równolegle. To jedyny plugin sklepowy z natywnym wsparciem Folia.

QuickShop Hikari vs ChestShop

Funkcja QuickShop Hikari ChestShop
Tworzenie sklepu Komenda + automatyczny szyld Ręczne pisanie na szyldzie
Wyszukiwanie ofert Wbudowane GUI (/qs find) Brak - trzeba chodzić po mapie
Baza danych SQLite / MySQL natywnie Pliki flat-file
Folia Pełne wsparcie Brak
Hologramy Wbudowane (wirtualne) Tylko szyld
Cena Darmowy Darmowy

Dla nowych serwerów na Paper 1.20+ QuickShop Hikari jest zalecanym wyborem. ChestShop pozostaje dobrą opcją dla mniejszych serwerów ceniących prostotę lub działających na starszych wersjach.

Powiązane artykuły: ChestShop, Vault, EssentialsX, katalog pluginów.