Плагін Minecraft Shopkeepers

🔌 Про Shopkeepers

Shopkeepers — це плагін Minecraft для Bukkit/Spigot, який дозволяє власникам серверів розміщувати кастомізованих торговців-вілagerів, що продають налаштовані предмети за заданими цінами. Плагін підтримує як admin shops (з нескінченним запасом), так і player shops, які беруть товари зі сховища, а також надає ShopkeepersAPI для інтеграції аддонів і розширень.

🎯 Призначення

Плагін надає внутрішньоігрову систему магазинів на основі NPC, щоб сервери могли пропонувати постійні крамниці без ручного керування скринями або складних магазинів на командах. Він підходить для економічних серверів, roleplay-магазинів і survival/SMP серверів, яким потрібні NPC-торговці. ()

⚙️ Можливості

• Створення кастомних торговців-вілagerів із заданими обмінами та цінами.
• Адмін-магазини з нескінченним запасом.
• Магазини гравців, які беруть предмети з підключеного контейнера (chest) для поповнення запасу.
• ShopkeepersAPI для авторів плагінів, щоб програмно запитувати й керувати торговцями.
• Кастомізація предметів/даних предметів у грі та підтримка мовних файлів через wiki проєкту й мовні файли. ()

🧩 Для кого це

• Для Survival і SMP серверів, яким потрібні магазини під керуванням NPC.
• Для roleplay або економічних серверів, які використовують NPC-вілagerів як торговців.
• Для розробників плагінів, яким потрібен API для інтеграції торгової поведінки в інші системи. ()

🏗️ Приклади використання

• Адміністратор створює нескінченний адмін-магазин, що продає товари, надані сервером.
• Гравець відкриває магазин, який автоматично продає предмети з прив’язаного chest.
• Розробник створює аддон, який показує або змінює торговців за допомогою ShopkeepersAPI. ()

⌨️ Команди

(Примітка: вище перелічено лише ті команди, які прямо задокументовані офіційними джерелами.) ()

⚙️ Встановлення

📥 Налаштування

• Завантажте офіційний jar-файл плагіна і помістіть його в папку сервера plugins/.
• Перезапустіть сервер і перевірте консоль сервера, щоб переконатися, що плагін завантажився.

(Це стандартні кроки встановлення для плагінів Bukkit/Spigot, і вони підтримуються документацією проєкту.) ()

🧠 Технічні примітки

• Shopkeepers поширюється під ліцензією GPL-3.0, а репозиторій проєкту містить модуль API (ShopkeepersAPI) та інструкції зі збірки. ()
• Проєкт надає артефакти Maven і опублікований API для розробників аддонів; README описує використання репозиторію та координати залежності API. ()
• Офіційне поширення та підтримка спільноти доступні через сторінку ресурсу Spigot і Discord-сервер плагіна. ()

🤝 Коли цей плагін корисний

Якщо вам потрібні постійні, налаштовані NPC-торговці з підтримкою як адмін-магазинів, так і магазинів гравців, і ви хочете API для інтеграції магазинів в інші плагіни, Shopkeepers пропонує перевірену реалізацію для серверів Bukkit/Spigot. ()