- Документация
- https://modrinth.com/plugin/playerauctions
Назначение
PlayerAuctions — серверный плагин аукционного дома для выставления и покупки предметов. Проект относится к экономике, игровым механикам, социальным функциям и утилитам. Клиентская сторона не поддерживается, серверная обязательна. Лицензия — MIT, автор выбранных версий — MinekartaStudio.
В официальном описании упомянуты интеграция с экономиками на базе Vault и PlaceholderAPI, графический интерфейс, уведомления и почтовое получение результатов сделок. Поскольку плагин перемещает предметы и деньги, проверять нужно не только запуск, но и полный жизненный цикл лота.
Скриншоты и внешний вид
Для каких серверов подходит
PlayerAuctions уместен там, где игрокам нужен общий рынок без личной встречи. Основные сценарии:
• выживание с внутриигровой экономикой;
• торговля редкими или специализированными предметами;
• перенос объявлений из чата в отдельный интерфейс;
• уведомления о новых лотах и покупках;
• контролируемое получение отменённых предметов и выручки.
До внедрения следует определить правила рынка: допустимые предметы, срок размещения, лимиты, комиссии и порядок возврата. Конкретные значения этих параметров в предоставленной основе не указаны.
Подтверждённые возможности
Для версии 3.1.0 описана почтовая система. Отменённый лот направляется в личный ящик, а после продажи продавцу поступает уведомление о выручке; при его получении средства зачисляются через экономическую интеграцию. Для почтовых объектов заявлен настраиваемый срок хранения, по умолчанию — 30 дней.
Также указаны уведомления о выставлении и покупке, переход к просмотру аукциона из чата и выбор области рассылки: весь сервер, текущий мир либо отключение. Интерфейс поддерживает MiniMessage, включая шестнадцатеричные цвета, градиенты и управление курсивом. Для 3.1.0 упомянут командный фреймворк с автодополнением.
Полный перечень категорий GUI, комиссий, прав и правил сортировки в исходном фрагменте отсутствует, поэтому дополнять его предположениями нельзя.
Совместимость
Общие метаданные перечисляют Paper, Purpur и Spigot, а также Minecraft 1.19–1.19.4, 1.20–1.20.6 и 1.21–1.21.11. Однако описание 3.1.0 прямо говорит о строгой ориентации на Paper 1.21 и отказе от устаревшей поддержки. Следовательно, общий список проекта нельзя автоматически применять к этому JAR.
Перед установкой сопоставляют:
• точную версию Minecraft и ядра;
• версию PlayerAuctions;
• экономический провайдер;
• наличие интеграционных компонентов;
• формат уже существующих данных.
Обязательные project dependencies в выбранных метаданных не перечислены. Описание при этом называет Vault-based экономику и PlaceholderAPI. Конкретные обязательные версии и полнота работы без этих компонентов не подтверждены.
Файлы и хеши
Доступны два зафиксированных артефакта:
• PlayerAuctions-3.1.0.jar, версия 3.1.0, 3946384 байта;
• PlayerAuctions-2.0.0-Modern.jar, версия 2.0.0, 15944768 байт.
SHA-512 версии 3.1.0: d5e7cd1fc4bf0c89e84485a12d07e0b22e2930f652356874d32b00961ded937008f16436bd271e49335a1b3d839904841ac92547cbede9f21717e210c18fa10c. SHA-1: 804ca86b99e9edda42e9b94229411a733f55745b.
SHA-512 версии 2.0.0 Modern: 2c9056897f0938575dce765d66cb53c6299437623f2c8517245fdf7262841b2d123699e220c239be8d1ca7246d879947ad3c2ccfe51561ab378007400871cc6f. SHA-1: 4c80c42dc40d25f3fdf92f6813f336dcc4bf7e0f.
Файлы получены по официальному HTTPS, сверены по хешам и статически проверены по структуре и путям. Динамический запуск не выполнялся. Разница размеров не объясняет различия функций и не служит основанием для выбора.
Установка и проверка
JAR помещают в папку plugins совместимого сервера. Рекомендуемый порядок:
• остановить сервер;
• сохранить текущий JAR, данные аукциона и экономической системы;
• зафиксировать состояние активных лотов и незабранных результатов;
• проверить имя, размер и хеш файла;
• удалить прежний JAR, не оставляя две версии;
• запустить сервер и прочитать журнал;
• провести сделку с предметом малой ценности.
Открытие интерфейса ещё не подтверждает исправность. Тест должен включать выставление, покупку при достаточном балансе, отказ при недостаточном, передачу предмета, получение выручки, отмену, возврат при полном инвентаре, истечение срока и перезапуск сервера.
Почту 3.1.0 проверяют отдельно: отменённый предмет и уведомление о выручке должны попадать в предусмотренный маршрут, а повторное открытие не должно приводить к повторному получению. Также проверяют выбранную область уведомлений и права обычного игрока.
Ограничения и риски
Аукцион затрагивает ценные предметы и балансы. Несовместимость или прерванное обновление способны привести к зависшим результатам, потере либо дублированию. В источнике не раскрыты схема хранения, миграция данных, комиссии, ограничения предметов и поведение при аварийном завершении.
Основные ограничения:
• 3.1.0 заявлен как выпуск для Paper 1.21;
• общий список версий не относится автоматически к каждому файлу;
• обязательные зависимости и их версии не указаны;
• статическая проверка не подтверждает транзакции;
• срок хранения почты нужно согласовать с правилами сервера;
• частые глобальные уведомления могут перегружать чат.
Доступ персонала и игроков проверяют раздельно. Наличие GUI не доказывает корректность разрешений на административные действия.
Безопасное обновление
До обновления сохраняют JAR, данные PlayerAuctions, экономическую базу и сведения об активных лотах. Затем копию запускают с теми же версиями ядра и интеграций. Проверяют старые лоты, незабранные предметы, выручку и повторный старт.
Переход с 2.0.0 Modern на 3.1.0 нельзя считать обычной заменой. Для нового выпуска заявлены почтовая модель и ориентация на Paper 1.21, а правила миграции в предоставленных данных отсутствуют. Поэтому необходим тест на копии реальных данных.
Откат
Откат должен возвращать согласованный комплект: прежний JAR, его данные и совместимую экономическую систему. Если новая версия изменила хранение или переместила результаты в почту, одной замены файла может быть недостаточно.
После возврата проверяют:
• загрузку без ошибок;
• видимость прежних лотов;
• доступность отменённых предметов;
• баланс тестовых игроков;
• отсутствие повторного начисления;
• новую тестовую покупку и отмену.
До выяснения причины новые сделки лучше ограничить, чтобы не увеличивать число спорных операций.
Диагностика
Разбор начинают с первой ошибки и точного набора версий. Проблему воспроизводят на одном тестовом лоте, разделяя этапы: создание, отображение, покупка, списание, доставка предмета, начисление выручки и получение почты.
Если GUI работает, а покупка нет, проверяют экономическую интеграцию и журнал операции. Если деньги списаны, а предмет не получен, фиксируют состояние лота, инвентаря и почты до повторных действий. После обновления полезно сравнить чистую установку с копией старых данных. Ручные компенсации до фиксации состояния затрудняют расследование.
Лицензия
PlayerAuctions распространяется по MIT. При локализации сохраняют название проекта, авторство MinekartaStudio и лицензионные сведения. Рекомендации по копиям, тестовым сделкам и откату являются редакционной практикой, а не обещанием разработчика.
FAQ
Нужен ли мод на клиенте?
Нет. Клиентская сторона помечена как неподдерживаемая, серверная — как обязательная.
Подходит ли 3.1.0 для Spigot 1.19?
Общие метаданные охватывают Spigot и 1.19, но описание 3.1.0 указывает Paper 1.21. Совместимость этого JAR со Spigot 1.19 не подтверждена.
Обязательны ли Vault и PlaceholderAPI?
Официальное описание заявляет интеграции, однако обязательные project dependencies и их версии не перечислены. Это нужно уточнять для конкретного выпуска.
Что происходит с отменённым лотом в 3.1.0?
По описанию он направляется в личный почтовый ящик. Поведение следует проверить тестом, включая заполненный инвентарь.
Можно ли обновить при активных лотах?
Безопаснее сначала испытать миграцию на копии. Правила обновления активных лотов в предоставленной основе не описаны.
Что проверять первым?
Полный цикл одной сделки: выставление, покупку, передачу предмета, получение выручки, отмену и работу почты после перезапуска.
