Minecraft plugin Shopkeepers

🔌 O Shopkeepers

Shopkeepers je plugin pro Minecraft Bukkit/Spigot, který umožňuje majitelům serverů umisťovat přizpůsobitelné villager shopkeepery, kteří prodávají nakonfigurované předměty za nakonfigurované ceny. Plugin podporuje jak admin shops (s nekonečnou zásobou), tak player shops, které berou zásoby z kontejneru, a také poskytuje ShopkeepersAPI pro integraci addonů a rozšíření.

🎯 Účel

Plugin poskytuje herní obchodní systém založený na NPC, aby servery mohly nabízet trvalé obchody bez ruční správy chestů nebo složitých obchodů přes příkazy. Hodí se pro serverové ekonomiky, roleplay obchody a survival/SMP servery, které chtějí NPC obchodníky. ()

⚙️ Funkce

• Vytváření vlastních villager shopkeeperů s definovanými obchody a cenami.
• Admin shops s nekonečnou zásobou.
• Player shops, které berou předměty z připojeného kontejneru (chest) pro zásobu.
• ShopkeepersAPI pro autory pluginů, aby mohli shopkeepery programově dotazovat a spravovat.
• Přizpůsobení itemů/item dat ve hře a podpora jazykových souborů prostřednictvím wiki projektu a jazykových souborů. ()

🧩 Pro koho je to určené

• Survival a SMP servery, které chtějí obchody řízené NPC.
• Roleplay nebo ekonomické servery, které používají villager NPC jako obchodníky.
• Vývojáře pluginů, kteří potřebují API pro integraci chování obchodů do jiných systémů. ()

🏗️ Příklady použití

• Admin vytvoří nekonečný admin shop prodávající zboží poskytované serverem.
• Hráč otevře obchod, který automaticky prodává předměty z propojeného chestu.
• Vývojář vytvoří addon, který pomocí ShopkeepersAPI vypisuje nebo upravuje shopkeepery. ()

⌨️ Příkazy

(Poznámka: výše jsou uvedeny pouze příkazy, které jsou výslovně zdokumentované oficiálními zdroji.) ()

⚙️ Instalace

📥 Nastavení

• Stáhněte oficiální jar pluginu a vložte jej do složky serveru plugins/.
• Restartujte server a zkontrolujte serverovou konzoli, zda se plugin načetl.

(Toto jsou standardní instalační kroky pro pluginy Bukkit/Spigot a podporuje je dokumentace projektu.) ()

🧠 Technické poznámky

• Shopkeepers je vydán pod licencí GPL-3.0 a repozitář projektu obsahuje API modul (ShopkeepersAPI) a návody k sestavení. ()
• Projekt poskytuje Maven artefakty a publikované API pro vývojáře addonů; README popisuje použití repozitáře a souřadnice závislosti API. ()
• Oficiální distribuce a komunitní podpora jsou dostupné přes stránku Spigot resource a Discord server pluginu. ()

🤝 Kdy je tento plugin užitečný

Pokud potřebujete trvalé, konfigurovatelné NPC obchodníky s podporou jak admin shops, tak obchodů spravovaných hráči, a chcete API pro integraci obchodů do jiných pluginů, Shopkeepers nabízí osvědčenou implementaci pro servery Bukkit/Spigot. ()