Плагін Minecraft ChestShop

🔌 Про ChestShop

ChestShop — це Minecraft-плагін для створення магазинів, якими керують гравці, використовуючи скрині та таблички. Він прив’язує дії магазину до економіки сервера (через Vault або Reserve), щоб гравці могли купувати й продавати предмети за серверну валюту. Проєкт підтримується на GitHub і поширює збірки через поширені платформи для плагінів.

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

Надати простий, постійний внутрішньоігровий ринок, де гравці створюють магазини, встановлюючи табличку на скриню. ChestShop обробляє транзакції між інвентарями гравців і економікою сервера, а також містить захист і хуки сумісності, щоб зменшити griefing і спростити інтеграцію.

⚙️ Функції

• Створення магазинів купівлі/продажу шляхом розміщення відформатованої таблички на скрині.
• Інтеграція з Vault або Reserve та іншими сумісними економічними плагінами для роботи з грошима.
• Захист магазинів і параметри сумісності з урахуванням поширених плагінів захисту скринь.
• Заходи проти лагів / для безпечних транзакцій, описані авторами.
• Розширюється через спільнотні доповнення та плагіни сумісності (список доповнень підтримується проєктом).
• Адміністративні та інформаційні команди додані в останніх релізах (приклади: /shopinfo, /iteminfo).

🧩 Для кого це

• Для серверів Survival і SMP, які використовують економіку на основі валюти.
• Для серверів, яким потрібні прості магазини гравців на табличках, а не GUI-вітрини.
• Для адміністраторів, які віддають перевагу магазинам, що зберігають предмети у звичайних скринях (без обов’язкової бази даних для базового зберігання).

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

• Гравці ставлять скриню, кладуть предмет на продаж і створюють табличку, щоб задати ціни купівлі/продажу; інші гравці натискають на табличку, щоб торгувати.
• Адміністратори сервера створюють адмін-магазини для продажу предметів від імені сервера.
• Спільнота додає плагін сумісності для інтеграції ChestShop із плагіном захисту або доповненням для відображення.

⌨️ Команди

(Перелічені команди взяті з приміток до релізів і документації проєкту. Показано лише команди, які явно задокументовані проєктом.)

🔐 Права доступу

(Вузли прав доступу включені лише там, де вони є в офіційних ресурсах проєкту та примітках до релізів.)

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

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

• Завантажте офіційний .jar ChestShop і помістіть його до папки plugins/ на сервері.
• Встановіть Vault або Reserve і сумісний економічний плагін, який надає API для грошей.
• Перезапустіть сервер і перевірте консоль, щоб переконатися, що ChestShop успішно увімкнувся.

📦 Залежності

• Vault (підтримується інтеграція) або Reserve (підтримується інтеграція)
• Сумісний економічний плагін, що надає API для грошей (встановлюється разом із Vault/Reserve)

🧾 Конфігурація

Плагін створює файли конфігурації/yml під час першого запуску; параметри конфігурації та перемикачі сумісності доступні в цих файлах і в документації проєкту.

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

• Вихідний код і відстеження проблем розміщені на GitHub за ліцензією LGPL-2.1.
• Проєкт публікує збірки й релізні артефакти на поширених сайтах плагінів; мейнтейнеры також публікують dev-збірки на CI-сервері.
• ChestShop розроблено для типів серверів Bukkit/Spigot/Paper (це прямо зазначено в документації проєкту та репозиторії).

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

Якщо вам потрібен простий внутрішньоігровий ринок, де предмети залишаються у звичайних скринях, а транзакції використовують валюту вашого сервера, ChestShop надає зрілу, розширювану систему магазинів на скринях і табличках з інтеграцією економіки та сумісністю з доповненнями.