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.

⌨️ Команди

Команда	Опис	Доступ
`/ah`	Відкриває GUI аукціону.	Гравець
`/ah sell <price>`	Продає предмет у вашій руці за фіксованою ціною.	Гравець
`/ah sell <price> <amount>`	Продає вказану кількість предмета в руці.	Гравець
`/ah selling`	Переглянути предмети, які ви зараз виставили.	Гравець
`/ah expired`	Переглянути ваші прострочені лістинги.	Гравець
`/ah purchased`	Переглянути предмети, які ви купили.	Гравець
`/ah history`	Переглянути вашу історію продажів/покупок.	Гравець
`/ah claim`	Отримати очікувані гроші (якщо не увімкнено автоматичне отримання).	Гравець
`/ah reload`	Перезавантажити конфігурацію плагіна.	Admin
`/ah admin history <player>`	Переглянути історію купівлі/продажу гравця (адмінський перегляд).	Admin
`/ah admin open <type> <player>`	Відкрити лістинги гравця/адмінський перегляд.	Admin
`/ah admin migrate <source>`	Перенести дані з попередньої версії/джерела.	Admin

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

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

Permission	Опис	За замовчуванням
`zauctionhouse.config`	Налаштовувати плагін у грі.	не вказано
`zauctionhouse.history`	Переглядати вашу історію покупок та/або продажів.	не вказано
`zauctionhouse.transaction`	Переглядати історію купівлі або продажу гравця (адмінська команда).	не вказано

(Перелічено лише ті вузли 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.

Сервери з плагіном zAuctionHouse

11
56.03
CorePlay
Класичний CZ/SK survival‑сервер з івентами, дуелями, аукціонами і дружньою спільнотою.
8
54.91
discord.gg/aflandz
1
52.61
EthelMC
Ком’юніті‑виживання з економікою, приватами, аренами та кросплеєм (Java/Bedrock). Ранги, магазини гравців і івенти.
1
49.77
Pinging
1
47.57
The Dojo
Towny‑виживання із прокачуванням mcMMO, економікою гравців і фокусом на спільноті — будуй міста, рівняй навички й грай з друзями.
0
46.83
Racsu Planet
Cross-play Survival MMORPG (Java + Bedrock) з навичками, квестами, кастомними підземеллями та внутрішньоігровою економікою, що підтримується офіційним магазином і спільнотним хабом.
0
45.21
Unleashed Craft
0
44.53
Minecraft server freakplot.minecraft.best:25584 d0d865663236
0
43.57
Survival
0
43.49
VoidCraft » PvP Factions 1.21 Forge ta faction. Ecrase tes ennemis. Regnez.
0
43.25
CyoriaSMP
SMP Survival, орієнтований на спільноту, з економікою в грі, захистом територій, кросплеєм Java+Bedrock, голосовим чатом за відстанню, кастомними мобами та мінііграмами — дружній геймплей для будівельників, торговців і PvPer'ів.
0
42.39
Tu nic nie ma ;)
0
41.88

Сторінка плагіна zAuctionHouse показує, на яких серверах моніторинг знайшов цей плагін, з якими платформами та версіями він зустрічається.

Плагіни можуть додавати команди, економіку, захист, права доступу, міні-ігри, інтеграції або інші механіки. Фактична роль zAuctionHouse залежить від конфігурації конкретного сервера.

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

Використовуйте список серверів з zAuctionHouse, щоб порівняти проєкти, перевірити сумісні версії або знайти приклади використання плагіна на публічних серверах.