Плагін Minecraft QuickShop-Hikari

🔌 Про QuickShop-Hikari

QuickShop-Hikari — це плагін Minecraft, який реалізує магазини купівлі/продажу на основі скринь (ChestShops). Гравці створюють і використовують магазини, взаємодіючи зі скринями; більшість ігрового процесу не потребує жодних команд. Проєкт підтримує QuickShop-Community і зосереджується на сучасній сумісності, безпеці даних і розширюваних інтеграціях.

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

Надати внутрішньоігрову економіку на основі предметів, де гравці можуть виставляти предмети на продаж або створювати магазини купівлі за допомогою скринь. Плагін призначений для адміністраторів серверів, які хочуть фізичну економіку, прив’язану до скринь, і керування для кожного магазину без змушування гравців вивчати команди.

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

• Створення магазинів купівлі та продажу за допомогою скринь і табличок (магазини на основі скринь).
• Підтримка даних NBT, чарів, пошкодження предметів, даних зілля та яєць мобів.
• Перемикаємий віртуальний предмет-відображення над магазинами (підтримуються ProtocolLib або PacketEvents).
• Підтримка необмежених скринь і змішаної поведінки купівлі/продажу в подвійній скрині.
• Підтримка чорного списку з можливістю обходу через дозвіл.
• Керування дозволами для кожного магазину та переваги магазину між власниками й іншими гравцями.
• Підтримка i18n для назв предметів і чар та синтаксису MiniMessage для повідомлень.
• Підтримка джерел даних H2 (локально) і MySQL (віддалено).
• Інтеграційні хук-модулі для поширених плагінів захисту та утиліт (доступні модулі сумісності).
• API для розробників (надані координати Maven/Gradle) для запитів до магазинів і інтеграції функцій.
• Телеметрія bStats з можливістю відмови через конфігурацію.

🧩 Для кого це

Для власників і адміністраторів серверів, які запускають Survival/SMP або сервери з акцентом на економіку й хочуть фізичний ринок на основі скринь. Підходить для малих і великих серверів, що використовують сумісні з Vault економічні плагіни та потребують контролю для кожного магазину й зберігання в базі даних.

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

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

⌨️ Команди

Примітка: документація проєкту зазначає, що звичайний ігровий процес гравця не потребує команд; команди переважно призначені для адміністрування.

🔐 Дозволи

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

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

• Завантажте офіційний jar QuickShop-Hikari з дистрибутива проєкту (релізи Modrinth/Spigot/GitHub).
• Помістіть jar-файл у папку plugins/ вашого сервера.
• Запустіть сервер і перевірте, що плагін завантажився (у документації показано запуск команди qs у консолі для виведення довідки/тесту).

📦 Залежності

Підтверджені обов’язкові/необов’язкові інтеграції, зазначені проєктом:

• Vault (обов’язковий для зв’язування економіки)
• Плагін економіки, сумісний із Vault (приклади наведені проєктом)
• ProtocolLib або PacketEvents (потрібні для віртуальних предметів-відображень / локалізації для окремих гравців)
• LuckPerms (рекомендовано для керування дозволами)

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

• Плагін створює та використовує config.yml (у документації згадуються ключі config.yml для протоколу відображення та налаштувань приватності).
• Зберігання даних підтримує локальний H2 або віддалений MySQL; параметри конфігурації доступні у файлах налаштувань плагіна.

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

• Офіційна документація рекомендує запуск на сервері на базі Paper і вказує вимогу Java 21.
• Проєкт надає API для розробників і координати Maven/Gradle для використання під час компіляції.
• QuickShop-Hikari постачається з модулями сумісності для сторонніх плагінів (наприклад, WorldGuard, WorldEdit, OpenInv) як необов’язкові завантаження.
• Телеметрія: використовує bStats; відмову можна увімкнути через налаштування config.

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

Якщо вам потрібен ринок, що працює через скрині, орієнтований на гравців, із постійним зберіганням і керуванням для кожного магазину (а не лише магазини через GUI або команди), QuickShop-Hikari пропонує сучасну реалізацію на базі бази даних із хук-інтеграціями для поширених економічних і захисних плагінів.