Minecraft plugin PlayerAuctions

🔌 Про плагін PlayerAuctions

PlayerAuctions — це плагін для Minecraft серверів, який дозволяє створити внутрішній аукціон (auction house), де гравці можуть виставляти, шукати та купувати предмети через GUI або команди. PlayerAuctions інтегрується з Vault‑сумаріями для економіки та підтримує PlaceholderAPI для плейсхолдерів, забезпечуючи безпечні трансакції і робочий ринок на Minecraft server.

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

PlayerAuctions вирішує проблему відсутності централізованого ринку/аукціону на сервері: дозволяє гравцям продавати надлишкові предмети, стимулює економічну активність і спрощує торгівлю без зовнішніх сайтів. PlayerAuctions підходить для survival, economy та RPG серверів, де потрібен внутрішній ринковий механізм. PlayerAuctions часто використовується як основа Торгової системи на medium‑ та large‑серверах. ()

⚙ Основні можливості

• GUI‑аукціон із категоріями, пошуком і сортуванням.
• Команди та aliases (/ah, /auction, /auctionhouse) для відкриття інтерфейсу та роботи з лістингами.
• Лістинг предмета з ціною та опцією buy‑now (/ah sell <price> [buy_now] [time]).
• Mailbox система (повернення предметів при повному інвентарі та депозит доходів).
• Broadcast повідомлення при виставленні та купівлі (конфігурується: GLOBAL/WORLD/NONE).
• Atomic locking та захист від дубль‑купівель (race conditions).
• Persistent JSON storage з авто‑резервними копіями.

Всі перелічені можливості підтверджені в офіційній документації проекту. PlayerAuctions як paper plugin ставить акцент на продуктивності та сучасному API. ()

🧩 Кому підійде

• Survival сервери з економікою
• RP / RPG сервери з торгівою між гравцями
• Середні та великі серверні проєкти, що потребують GUI‑ринку
• Сервери на Paper/Purpur/Spigot, які використовують Vault для економіки. ()

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

• Гравець виставляє алмазну кирку з /ah sell 1000, інший гравець купує її через GUI.
• Скасовані лістинги повертаються в Mailbox замість выпадання в світ (щоб уникнути втрати предметів при повному інвентарі).
• Сервер транслює глобальне повідомлення про дорогі лоти, щоб залучити гравців.

⌨️ Команди

(Команди та permissions наведені відповідно до офіційної документації.) ()

🔐 Права доступу (permissions)

(Значення Default вказано відповідно до публічних джерел.) ()

⚙ Інсталяція

📥 Встановлення

• Переконайтесь, що сервер працює на сумісній версії Paper/Purpur/Spigot (див. сумісність нижче).
• Завантажити PlayerAuctions.jar і помістити в папку plugins/.
• Повністю перезапустити сервер (не використовувати /reload).
• Перевірити консолі на помилки та, за потреби, відредагувати config.yml та messages.yml. ()

📦 Залежності

• Vault — для роботи з економічними провайдерами (необхідно).
• Economy provider (наприклад EssentialsX economy або інший Vault‑сумісний плагін).
• PlaceholderAPI — опціонально, для плейсхолдерів (плагін підтримує інтеграцію).

(Ці залежності згадані у офіційній документації PlayerAuctions.) ()

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

• Плагін генерує власну папку plugins/PlayerAuctions/ та config.yml після першого запуску.
• PlayerAuctions має налаштування: макс. лотів на гравця, податок (tax), broadcast параметри, mailbox тощо.
• Підтримка баз даних: плагін використовує persistent JSON flat‑file storage; опції зовнішніх БД не описані у джерелах як обов’язкові. ()

🧠 Додаткова інформація

Відомі конфлікти

• Конфлікти можливі з іншими плагінами, що змінюють ті самі команди/GUI або використовують однакові permission‑вузли — тестування на staging рекомендовано. ()

Обмеження

• PlayerAuctions розроблено як modern paper plugin та оптимізовано під Paper 1.21 API; старі ядра можуть бути не підтримані у останніх релізах. ()

FAQ

Q: На яких версіях Minecraft працює PlayerAuctions? A: Офіційно сумісно з Minecraft Java 1.19.x, 1.20.x, 1.21.x (Paper/Purpur/Spigot). ()

Q: Чи потрібен Vault? A: Так — Vault потрібен для роботи з економікою плагіна. ()

Q: Чи використовує плагін bStats/телеметрію? A: Інформація про bStats або подібну телеметрію не згадується у основних публічних джерелах (Modrinth / GitHub README) станом на останні релізи; якщо це критично — перевірте README у репозиторії або issues. ()

Q: Чи є підтримка Discord? A: Вказано, що підтримка/зворотний звʼязок доступні через GitHub Issues та Discord server, але пряма посилання на Discord не вказана у Modrinth сторінці; використовуйте GitHub Issues для звернень. ()

Sources: Modrinth (PlayerAuctions) and the project GitHub repository. ()