Plugin Minecraft Shopkeepers

🔌 Despre Shopkeepers

Shopkeepers este un plugin Minecraft pentru Bukkit/Spigot care le permite proprietarilor de servere să plaseze villager shopkeepers personalizabili, care vând obiecte configurate la prețuri configurate. Pluginul suportă atât admin shops (stoc nelimitat), cât și player shops care iau stoc dintr-un container, și oferă și ShopkeepersAPI pentru integrarea și extinderea addon-urilor.

🎯 Scop

Pluginul oferă un sistem de magazin bazat pe NPC în joc, astfel încât serverele să poată oferi magazine persistente fără gestionarea manuală a chest-urilor sau magazine complicate bazate pe comenzi. Este potrivit pentru economii de server, magazine roleplay și servere survival/SMP care vor comercianți NPC. ()

⚙️ Funcții

• Creează villager shopkeepers personalizați cu trade-uri și prețuri definite.
• Admin shops cu aprovizionare nelimitată.
• Player shops care iau obiecte dintr-un container (chest) atașat pentru stoc.
• ShopkeepersAPI pentru autorii de pluginuri, pentru a interoga și gestiona programatic shopkeeperii.
• Personalizare în joc a itemelor/item-data și suport pentru fișiere de limbă prin wiki-ul proiectului și fișierele de limbă. ()

🧩 Pentru cine este

• Servere Survival și SMP care vor magazine operate de NPC-uri.
• Servere roleplay sau economice care folosesc NPC-uri villager drept comercianți.
• Dezvoltatori de pluginuri care au nevoie de o API pentru a integra comportamentul magazinelor în alte sisteme. ()

🏗️ Exemple de utilizare

• Un admin creează un admin shop nelimitat care vinde bunuri oferite de server.
• Un jucător deschide un magazin care vinde automat obiecte dintr-un chest conectat.
• Un dezvoltator construiește un addon care listează sau modifică shopkeeperii folosind ShopkeepersAPI. ()

⌨️ Comenzi

(Notă: mai sus sunt listate doar comenzile documentate explicit de sursele oficiale.) ()

⚙️ Instalare

📥 Configurare

• Descarcă jar-ul oficial al pluginului și pune-l în folderul plugins/ al serverului.
• Repornește serverul și verifică consola serverului pentru a confirma că pluginul s-a încărcat.

(Acestea sunt pașii standard de instalare pentru pluginurile Bukkit/Spigot și sunt susținuți de documentația proiectului.) ()

🧠 Note tehnice

• Shopkeepers este publicat sub licența GPL-3.0, iar repository-ul proiectului include un modul API (ShopkeepersAPI) și instrucțiuni de build. ()
• Proiectul oferă artefacte Maven și o API publicată pentru dezvoltatorii de addon-uri; README documentează folosirea repository-ului și coordonatele dependenței API. ()
• Distribuția oficială și suportul comunității sunt disponibile prin pagina de resource Spigot și serverul Discord al pluginului. ()

🤝 Când este util acest plugin

Dacă ai nevoie de comercianți NPC persistenți și configurabili, cu suport atât pentru admin shops, cât și pentru magazine operate de jucători, și vrei o API pentru a integra magazinele în alte pluginuri, Shopkeepers oferă o implementare dovedită pentru servere Bukkit/Spigot. ()