Плагін Minecraft zAuctionHouse

🔌 Про zAuctionHouse

zAuctionHouse — це плагін Minecraft, який реалізує повноцінний аукціон для гравців, щоб вони могли виставляти, переглядати та купувати предмети. Основний акцент зроблено на гнучких налаштуваннях, інтерфейсах на базі GUI та підтримці кількох типів економіки. Проєкт підтримує GroupeZ-dev, а репозиторій і документація показують переписану версію V4, орієнтовану на сучасний Java та серверні архітектури.

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

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

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

• Лістинги миттєвої покупки (buy-it-now) та сценарії з торгами там, де це підтримується.
• Масові продажі: продаж кількох предметів в одному лістингу.
• Попередній перегляд Shulker Box, щоб покупці могли оглянути вміст перед купівлею.
• Фільтрація за категоріями, розширене сортування та пагінація для великих наборів лістингів.
• Підтримка кількох економік (Vault, PlayerPoints, CoinsEngine, валюти на основі предметів, XP/рівні).
• Налаштовувана система податків і знижки на податок на основі прав.
• Автоматичне або ручне отримання грошей, а також сповіщення про продажі офлайн.
• Інтеграція з zMenu для повністю налаштовуваних GUI та шаблонів інвентарю.
• Підтримка PlaceholderAPI та MiniMessage для форматованих повідомлень і placeholder-ів.
• Інструменти для адмінів: адмін-панель, журнали дій, історія транзакцій, відновлення предметів і команди керування кешем.
• Синхронізація між кількома серверами через Redis addon із розподіленим блокуванням і pub/sub.
• Керування предметами через blacklist/whitelist, обмеження світів, ліміти на лістинги та ціни, а також блокування транзакцій для запобігання race condition.
• Підтримка Discord webhook для сповіщень про продажі з налаштовуваним вмістом embed.

🧩 Для кого це

• Сервери Survival і SMP, яким потрібен ринок, керований гравцями.
• Сервери Skyblock, Factions і сервери, орієнтовані на економіку, яким потрібні системи торгівлі.
• Мережі, яким потрібні синхронізовані маркетплейси між кількома backend-серверами.
• Адміністратори серверів, яким потрібні журнали аудиту та інструменти відновлення для адмінів.

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

• Гравці виставляють рідкісні дропи або крафтові предмети за фіксованою ціною, щоб інші гравці могли одразу їх купити.
• Оператор сервера запроваджує податкові правила та VIP-знижки на податок через permissions.
• Багатосерверна мережа синхронізує лістинги та продажі між hub і backend серверами за допомогою Redis addon.

⌨️ Команди

(Команди вище взяті з офіційної документації проєкту та матеріалів quick-start у репозиторії.)

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

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

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

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

• Отримайте офіційний jar з zAuctionHouse з розповсюдження проєкту (офіційна сторінка продажу або каталог).
• Помістіть jar zAuctionHouse (і потрібні плагіни) у каталог сервера plugins/.
• Перезапустіть сервер і переконайтеся, що плагін успішно ініціалізувався в консолі сервера.
• Налаштуйте плагін через plugins/zAuctionHouse/config.yml і кастомізуйте GUI-інвентарі в plugins/zAuctionHouse/inventories/.

📦 Залежності

• Потрібно: zMenu, PlaceholderAPI.
• Необов’язкові / підтримувані інтеграції: Vault, LuckPerms і zAuctionHouse Redis addon для синхронізації між кількома серверами.

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

• Проєкт орієнтований на сучасний Java (переписана версія V4 націлена на Java 21) і використовує у своїй архітектурі підхід repository / ORM.
• Рекомендоване серверне ПЗ включає Paper і форки Paper; Folia та кілька форків на базі Paper також зазначені як підтримувані.
• Офіційна документація та розповсюдження показують підтримку Minecraft 1.20 аж до 1.21+ (перевірте документацію проєкту для точності сумісності збірки перед запуском у продакшені).

❓ FAQ

• Чи є безкоштовна версія?
  Доступна безкоштовна demo-збірка (проєкт на деяких платформах надає безкоштовний/demo-реліз), тоді як повні, підтримувані релізи розповсюджуються через преміум-канали проєкту.

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

Якщо вам потрібен налаштовуваний маркетплейс із GUI, підтримкою кількох економік і необов’язковою синхронізацією між кількома серверами, zAuctionHouse пропонує підтримувану реалізацію аукціону разом з адмінським аудитом і кастомізацією GUI через zMenu.