Minecraft plugin QuickShop-Hikari

🔌 O QuickShop-Hikari

QuickShop-Hikari je Minecraft plugin, který implementuje obchody na bázi truhel pro nákup a prodej (ChestShops). Hráči vytvářejí a používají obchody interakcí s truhlami; většina hraní nevyžaduje žádné příkazy. Projekt spravuje QuickShop-Community a zaměřuje se na moderní kompatibilitu, bezpečnost dat a rozšiřitelné integrace.

🎯 Účel

Poskytnout ekonomiku ve hře založenou na předmětech, kde mohou hráči vystavovat předměty k prodeji nebo vytvářet nákupní obchody pomocí truhel. Plugin je určen pro správce serverů, kteří chtějí fyzickou ekonomiku řízenou truhlami a kontrolu po jednotlivých obchodech bez nutnosti nutit hráče učit se příkazy.

⚙️ Funkce

• Vytváření nákupních a prodejních obchodů pomocí truhel a cedulek (obchody na bázi truhel).
• Podpora dat NBT, enchantmentů, poškození předmětů, dat lektvarů a spawnovacích vajec mobů.
• Přepínatelný virtuální zobrazovaný předmět nad obchody (podporováno přes ProtocolLib nebo PacketEvents).
• Podpora neomezených truhel a smíšeného nákup/prodej chování u dvojtruhly.
• Podpora blacklistu s možností bypass oprávnění.
• Správa oprávnění pro každý obchod a výhody obchodu mezi vlastníky a ostatními hráči.
• Podpora i18n pro názvy předmětů a enchantmentů a syntaxe MiniMessage pro zprávy.
• Podpora datasource H2 (lokální) a MySQL (vzdálené).
• Integrační hooky pro běžné ochranné a utilitní pluginy (k dispozici jsou moduly kompatibility).
• Developer API (poskytnuty Maven/Gradle koordináty) pro dotazování obchodů a integraci funkcí.
• Telemetrie bStats s možností opt-outu přes konfiguraci.

🧩 Pro koho to je

Pro majitele a administrátory serverů provozujících Survival/SMP nebo ekonomicky zaměřené servery, kteří chtějí fyzický marketplace založený na truhlách. Hodí se pro malé i velké servery používající ekonomické pluginy kompatibilní s Vault a chtějící kontrolu po jednotlivých obchodech a ukládání do databáze.

🏗️ Příklady použití

• Hráči vloží předměty do truhly a označí ji, aby se celé stacky automaticky prodávaly ostatním hráčům.
• Admin zapne oprávnění po jednotlivých obchodech, aby moderátoři mohli spravovat obchody v konkrétních světech nebo regionech.
• Síť používá úložiště MySQL, aby obchody zůstaly zachované napříč instancemi serveru.

⌨️ Příkazy

Poznámka: dokumentace projektu uvádí, že běžné hraní hráče nevyžaduje příkazy; příkazy jsou primárně administrativní.

🔐 Oprávnění

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální QuickShop-Hikari jar z distribuce projektu (vydání Modrinth/Spigot/GitHub).
• Umístěte jar soubor do složky plugins/ na serveru.
• Spusťte server a ověřte, že se plugin načetl (dokumentace ukazuje spuštění příkazu qs v konzoli pro zobrazení nápovědy/testovacího výstupu).

📦 Závislosti

Potvrzené povinné/volitelné integrace uvedené projektem:

• Vault (nutné pro propojení ekonomiky)
• Ekonomický plugin kompatibilní s Vault (příklady uvádí projekt)
• ProtocolLib nebo PacketEvents (nutné pro virtuální zobrazované předměty / lokalizaci po hráčích)
• LuckPerms (doporučeno pro správu oprávnění)

🧾 Konfigurace

• Plugin vytváří a používá config.yml (dokumentace odkazuje na klíče config.yml pro zobrazovací protokol a nastavení soukromí).
• Ukládání dat podporuje lokální H2 nebo vzdálené MySQL; možnosti konfigurace jsou dostupné v konfiguračních souborech pluginu.

🧠 Technické poznámky

• Oficiální dokumentace doporučuje běh na serveru založeném na Paper a uvádí požadavek Java 21.
• Projekt poskytuje developer API a Maven/Gradle koordináty pro použití při kompilaci.
• QuickShop-Hikari dodává kompatibilní moduly pro pluginy třetích stran (např. WorldGuard, WorldEdit, OpenInv) jako volitelné stažení.
• Telemetrie: používá bStats; opt-out přes nastavení configu.

🤝 Kdy je tento plugin užitečný

Pokud chcete tržiště řízené truhlami, viditelné pro hráče, s perzistentním úložištěm a kontrolou po jednotlivých obchodech (místo jen GUI nebo příkazových obchodů), QuickShop-Hikari poskytuje moderní implementaci založenou na databázi s hooky pro běžné ekonomické a ochranné pluginy.