PlayerAuctions

PlayerAuctions - это мощный и современный плагин для аукциона на серверах Minecraft (Paper). Он решает сразу несколько проблем: вместо того чтобы спамить в чат "Продаю алмазную кирку", игроки могут выставить лот в удобном интерфейсе, а остальные - найти нужный товар через поиск и категории. Экономика сервера становится прозрачной, а админу не приходится разбирать жалобы на обманутые сделки - всё автоматизировано.

Обзор

PlayerAuctions создан для Paper 1.21 и использует Vault для экономики, а также PlaceholderAPI для вывода статистики. В версии 3.1.0 появилось несколько важных нововведений:

• Почтовый ящик (Mailbox) - теперь отменённые аукционы и выручка от продаж не пропадают, если инвентарь забит. Всё приходит в личный ящик, а через 30 дней (настраивается) невостребованные вещи удаляются.
• Обновлённая система команд (CCF) - нулевая задержка и умные подсказки Tab.
• Полная поддержка MiniMessage - можно использовать Hex-цвета, градиенты и авто-удаление курсива в описании предметов.
• Отказ от поддержки старых версий - только Paper 1.21, никакого legacy-мусора.

Основные возможности

Система почтового ящика

Больше не надо бояться, что при отмене лота предмет выпадет на землю и кто-то его подберёт. Всё уходит в Mailbox, а деньги от продажи - туда же в виде уведомления. Забрал уведомление - получил деньги на баланс Vault. Удобно и надёжно.

Глобальные оповещения

Когда кто-то выставляет лот или покупает, в чат летит сообщение. Можно настроить, чтобы видели весь сервер, только игроков в том же мире или отключить совсем. Сообщения кликабельны - нажал и сразу открылся аукцион.

Интерфейс с MiniMessage

Границы, заголовки, названия категорий - всё можно раскрасить в Hex и градиенты. Встроенная сортировка по цене (возрастание/убывание), по времени и по новизне. Есть поиск и категории: блоки, инструменты, оружие, броня и т.д.

Безопасные транзакции

Используется оптимистичная блокировка базы данных, чтобы никто не мог купить один и тот же предмет дважды (race condition). Хранилище - JSON-файлы с авто-бэкапами. Лёгкое, надёжное, не требует MySQL.

Команды и права

Команда	Описание	Право	По умолчанию
/ah	Открыть главное меню аукциона	playerauctions.use	true
/ah sell <цена> [buy_now] [время]	Выставить предмет из руки	playerauctions.sell	true
/ah myauctions	Посмотреть свои лоты	playerauctions.use	true
/ah mailbox	Открыть почтовый ящик	playerauctions.use	true
/ah search <ключевое слово>	Поиск предмета	playerauctions.search	true
/ah categories	Просмотр по категориям	playerauctions.categories	true
/ah history [игрок]	История транзакций (своя или чужая)	playerauctions.history(.others)	true (op)
/ah notify <on/off>	Включить/выключить личные уведомления	playerauctions.notify	true
/ah reload	Перезагрузить конфиг	playerauctions.reload	op

Админ-право playerauctions.admin даёт доступ ко всем командам и bypass.

Настройка config.yml

Пример настройки, чтобы вы понимали, как всё гибко:

aution:
  max-auctions-per-player: 5
  tax-percentage: 5.0 # 5% налог с продажи

  broadcast:
    enabled: true
    on-listing: true
    on-purchase: true
    range: GLOBAL # GLOBAL, WORLD, NONE

mailbox:
  enabled: true
  retention-days: 30

Плейсхолдеры (PlaceholderAPI)

Вставляйте в скорборды или табы:

• %playerauctions_total_auctions% - количество активных лотов на сервере
• %playerauctions_player_listings% - количество лотов у конкретного игрока

Установка

1. Сервер должен быть на Paper 1.21+.
2. Установите Vault и плагин экономики (например, EssentialsX).
3. Положите PlayerAuctions.jar в папку plugins/.
4. Перезапустите сервер.
5. (Опционально) Отредактируйте config.yml и messages.yml - поддерживается MiniMessage.

Плагин PlayerAuctions - отличное решение для серверов, где хотят упорядочить торговлю. Он избавляет от хаоса в чате, даёт игрокам прозрачный рынок, а админу - полный контроль над экономикой. Если вы собираете сервер для выживания или мини-игр с экономикой - стоит присмотреться.