- Для версий
- 1.16.+
- 1.17.+
- 1.18+
- 1.19.+
- 1.20.+
- 1.21.+
mcAuction — аукцион предметов для Minecraft
Игрок может купить ровно столько предметов, сколько ему нужно. Из стопки в восемь предметов за 80 монет можно взять три за 30. До оплаты покупатель видит количество, итоговую сумму, валюту и место получения. Остальные пять остаются в продаже.Для владельца сервера
Откройте один рынок на выживании или объедините несколько серверов с общей экономикой. Для каждого узла задаются свои роли продажи, покупки и выдачи. Если режимы используют разные предметы и балансы, им можно назначить отдельные рынки и базы. Названия валют и серверов игрок увидит прямо в карточке лота.Для игроков
Найдите предмет по названию, выберите сортировку или оставьте предложения нужного сервера и валюты. У неделимого набора показан его состав. У лота с продажей по частям можно выбрать количество перед подтверждением.Как проходит сделка
Продавец берёт предмет в руку и открывает продажу командой/auction sell. После выбора цены и валюты лот появляется в каталоге. Покупатель открывает карточку и подтверждает сумму. В истории покупок остаются состав, статус выдачи и сервер получения. Свои предложения и возвраты доступны отдельными командами.Предметы и оформление
Описание и свойства исходного предмета сохраняются при покупке и возврате, в том числе у предметов с пользовательскими моделями. Цвета RGB, подписи, заполнители и кнопки сундуковых меню настраиваются. С DialogEngine каталог также открывается в виде диалога. Для диалогов есть обычный вариант и оформление с текстурами ресурс-пака.Когда покупатель вернётся позже
Если выдача ещё ожидается, покупатель может открыть историю и посмотреть статус. Продавец может снять оставшиеся предметы с продажи и забрать их через возвраты. Уже завершённые действия сохраняются после перезапуска.Скриншоты меню
В карточке восьми слитков видны общая цена, валюта и сервер продажи.Перед оплатой покупатель видит сумму и сервер получения.
Покупатель получил три слитка. В истории видны количество и уплаченная сумма.
При продаже можно выбрать валюту.
Для неделимого набора продавец выбирает целые стопки в собственном инвентаре.
В комплекте три золотых слитка и два изумруда. Общая цена — 45 жетонов.
Перед выставлением показаны обе стопки, пять предметов и полная цена неделимого набора.
После выдачи пяти слитков в истории продавца видно завершение возврата.
Команды и права
/ah— каталог. Полная команда/mcauction, другие варианты —/auctionи/auctionhouse./auction sell— оформить продажу. Чтобы выставить предмет в руке одной командой, используйте/auction sell <общая цена> [количество] [валюта]./auction my,/auction purchasesи/auction returnsоткрывают свои лоты, покупки и возвраты./auction inventoryоткрывает сундуковый каталог при установленном DialogEngine./auction settings— оформление,/auction settings runtime— настройки рынка./auction settings config— уведомления об обновлениях, сообщения и параметры прежнего аукциона.
mcauction.use и mcauction.sell. Права mcauction.admin и mcauction.settings по умолчанию есть у операторов. Для доверенных ролей предусмотрены mcauction.owner и mcauction.developer.Совместимость и экономика
Основные версии Paper — 1.16.5, 1.21.11 и 26.3. Также проверялся запуск на 1.17.1, 1.18.2, 1.19.4, 1.20.6, 26.1.2 и 26.2. Для поинтов подключите PlayerPoints. Для монет через Vault нужен совместимый экономический плагин. Есть интеграция с CMI. DialogEngine и PlaceholderAPI подключаются по необходимости.Установка и обновление
Положите JAR в папкуplugins и запустите сервер. На новой установке используется локальная H2. Для общего рынка поддерживаются MariaDB, MySQL и PostgreSQL. Redis помогает серверам получать уведомления об изменениях рынка. На существующей установке сохраните базу и настройки перед обновлением. Для переноса прежних лотов предназначен файл migration.yml. Пароли для внешнего хранилища задаются через переменные окружения. Вопрос по установке можно передать в поддержку mcDev.Конфигурация
journal.yml задаёт рынок, валюты, хранилище и места выдачи. В journal-menus.yml находятся оформление и сообщения. Подтверждённые правки из игровых редакторов сохраняются в соответствующих YAML-файлах. Ниже приведены настройки из дистрибутива.- В
updates.enabledвключается проверка новых версий. Вlegacy-economy.currenciesдля каждой валюты задаются провайдерtype, его идентификатор валютыidи подписьdisplay-name. Примеры Vault и PlayerPoints используют пустойid. - В
messageсобраны ответы прежнего аукциона, включая отказ в доступе, сообщение об изменившемся лоте и помощь.permission.reloadзадаёт право перезагрузки. В двух спискахlot_creation_confirmation_descriptionиlot_purchase_confirmation_descriptionзадаётся текст перед продажей и покупкой. - Срок продажи
lot_ttl_seconds, срок хранения истёкшего лотаexpired_lot_ttl_secondsи интервал очисткиcleaner_module.scheduler.delay_secondsуказываются в секундах. Вlot_limit_moduleесть общий предел активных лотов и отдельные пределы по правам. Списокdeny_world_name_listсодержит имена миров, где команда закрыта. - Для прежнего хранилища
database.typeвыбирает тип базы. Пример подключения MySQL приведён в комментариях. Перед сменой хранилища перенесите уже выставленные предметы и возвраты по настройкам миграции. - В
filter_moduleу фильтра есть собственный идентификатор, видимое название и список материалов. Вfilter_idкнопки указывается идентификатор нужного фильтра. Фильтр назначается при создании лота. Если изменить список материалов, у уже выставленных лотов останутся прежние фильтры. - У сундуковых меню
titleзадаёт заголовок,size— число ячеек. Для кнопкиslot.xвыбирает столбец от 1 до 9,slot.y— ряд сверху, начиная с 1. Вpattern.indexesячейки для предложений нумеруются с 0. Столбцы кнопок перелистыванияpaginationотсчитываются с 1. - У значков
materialвыбирает предмет,display_name— его подпись,description— строки подсказки,amount— число на значке. В подсказках лота оставляйте нужные подстановки из примера, чтобы игрок видел продавца, количество и цену. - В
gui.platformнастраиваются пауза между кликами в тиках, фон, навигация и заголовки.price_promptзадаёт приглашение ввести цену,invalid_price— ответ при неверном вводе. Для анимации задаются тип, интервал в тиках, шаг, основной цвет и цвет волны. У звуков кадра и завершения есть имя, громкость и высота тона. Пустое имя выключает соответствующий звук.
# На новой установке аукцион готов к работе с H2 и обычным инвентарём игрока.
# При обновлении старого аукциона журнал не включается автоматически: сначала перенос лотов.
# Все параметры доступны в /auction settings runtime. Рабочих паролей здесь нет.
enabled: true
identity:
market: survival
server: local
table-prefix: mca_journal
can-sell: true
can-buy: true
can-deliver: true
storage:
type: H2
# H2 всегда использует journal/auction внутри папки плагина.
# Для MariaDB/MySQL/PostgreSQL задайте IP сервера, порт и отдельную базу.
# MARIADB и MYSQL используют поставляемый MariaDB Connector/J.
# DNS-имена и пользовательские JDBC URL не принимаются.
host: 127.0.0.1
port: 0
database: mcauction
# Для сетевой СУБД нужны обе переменные окружения. Значений паролей в YAML нет.
username-env: MCAUCTION_JDBC_USERNAME
password-env: MCAUCTION_JDBC_PASSWORD
connect-timeout-ms: 3000
socket-timeout-ms: 5000
# Сетевые БД: сертификат и адрес сервера проверяются драйвером. Для H2 поля TLS не используются.
# DISABLE допустим только для локального стенда на 127.0.0.0/8 или ::1.
tls-mode: VERIFY_FULL
# Необязательный CA: относительный путь внутри папки плагина, файл до 1 MiB без ссылок.
# Пустое значение использует доверенные CA JVM. DNS-имя вместо IP автоматически не подставляется.
# Проверка адреса следует политике драйвера: при отсутствии подходящего SAN возможен CN fallback.
tls-ca-file: ''
workers:
count: 2
queue-capacity: 128
effect-timeout-ms: 5000
presence:
node-ttl-ms: 30000
safety-ms: 2000
heartbeat-ticks: 20
recovery:
enabled: true
# Один проход одновременно; размер — общий предел для всех шагов, не на каждого игрока.
interval-ticks: 20
batch-size: 32
# Новый шаг попадает в фон после этой паузы; подтверждение покупки в меню её не ждёт.
initial-delay-ms: 1000
# Повторяется только известный отказ без эффекта. UNKNOWN остаётся для сверки.
retry-delay-ms: 5000
currencies:
# При первом запуске в пустой папке сюда запишутся найденные Vault и PlayerPoints.
# Затем провайдеры не подменяются автоматически. Без установленной экономики
# настройте нужную валюту в игровом редакторе перед продажей.
- id: points
provider: PLAYER_POINTS
display-name: Поинты
scale: 0
provider-identity: PlayerPoints
delivery-servers:
local: Этот сервер
source-servers:
local: Этот сервер
listing:
# Цена /auction sell задаётся за весь лот, количество — в отдельных предметах.
lifetime-seconds: 86400
# Общий срок хранения от выставления. 0 — бессрочно, иначе не меньше lifetime-seconds.
retention-seconds: 0
# Активные и ожидающие изъятия/сверки лоты одного продавца в этом рынке.
max-active: 10
# Точное имя плагина, зарегистрировавшего custody API. Пустое значение не включает выдачу через инвентарь.
# mcAuction выбирает встроенную выдачу только для обычного native playerdata с directory fsync.
# Режимы с собственным SQL-профилем используют свой provider. Нативный backend не заменяет его.
# Продажа через mode API требует supportsListings; возвраты — supportsReturns.
custody-provider: mcAuction
# Отдельный провайдер единого commit кошельков и инвентаря (например, mode API).
# Он регистрирует JournalSettlementService до запуска journal. Старый AuctionPurchaseService не подменяется.
# Имя хранится в каждом aggregate-лоте; отсутствие сервиса не включает другой способ расчёта.
# Для режима custody-provider и settlement-provider задают одно точное имя плагина.
settlement-provider: ''
# Оформление сундуковых меню. Недостающие поля читаются из базового файла.
# Ошибка типа, слота или цвета отклоняет загрузку целиком: прежние настройки остаются активны.
schema-version: 1
dialog:
plain: '&fБез текстур проекта'
textured: '<accent>С текстурами проекта'
lot: '&f{available} шт. · {total} {currency}'
quote: '&f{quantity} из {available} · {price} {currency} · {delivery}'
admin-permission: mcauction.admin
style:
accent: '#8FE3CF'
secondary: '#B1A0F7'
# Тёмный текст заголовков остаётся заметным на светлой подложке Minecraft.
heading: '#27313B'
prefix: '<accent>✦ &fmcAuction &8› &7'
# Рамка отделяет действия от товаров. Материалы доступны начиная с 1.16.5.
filler: BLACK_STAINED_GLASS_PANE
accent-pane: CYAN_STAINED_GLASS_PANE
secondary-pane: PURPLE_STAINED_GLASS_PANE
border-only: true
clear-content: true
search:
timeout-seconds: 60
cancel-word: 'отмена'
feedback:
titles: true
bossbars: true
bossbar-seconds: 4
bossbar-color: BLUE
owner:
size: 54
title: '<heading>{section} · {page}'
item-slots: [10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34]
buttons:
previous: {slot: 45, material: ARROW, name: '&fПредыдущая страница', lore: []}
next: {slot: 53, material: ARROW, name: '&fСледующая страница', lore: []}
lots: {slot: 47, material: CHEST, name: '<accent>Мои предложения', lore: ['&7Снять непроданный остаток в возвраты.']}
returns: {slot: 49, material: ENDER_CHEST, name: '<secondary>Мои возвраты', lore: ['&7Забрать на исходном сервере.', '&7Незавершённые выдачи не повторяются.']}
purchases: {slot: 51, material: BOOK, name: '<accent>Мои покупки', lore: ['&7Статус и сервер получения.']}
back: {slot: 48, material: COMPASS, name: '&fВ каталог', lore: []}
close: {slot: 52, material: BARRIER, name: '&cЗакрыть', lore: []}
selling:
size: 54
title: '<heading>Оформление продажи'
item-slots: [10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34]
buttons:
price: {slot: 0, material: OAK_SIGN, name: '<accent>Цена всего · {price}', lore: ['&7Валюта: &f{currency}', '&7Нажмите и введите сумму в чат.']}
currency: {slot: 2, material: GOLD_NUGGET, name: '<accent>Валюта · {currency}', lore: ['&7Нажмите, чтобы сменить.', '&7После смены укажите цену заново.']}
kind: {slot: 4, material: CHEST, name: '<secondary>Тип · {kind}', lore: ['&7Нажмите: предметы или неделимый набор.', '&7Выбирайте предметы ЛКМ в своём инвентаре.', '&7В набор входят выбранные стопки целиком.']}
clear: {slot: 6, material: MILK_BUCKET, name: '&fОчистить выбор', lore: ['&7Предметы пока остаются у вас.']}
review: {slot: 8, material: EMERALD, name: '<accent>Проверить условия', lore: ['&7Количество: &f{items}', '&7За всё: <accent>{price} {currency}']}
previous: {slot: 45, material: ARROW, name: '&fПредыдущая страница', lore: []}
next: {slot: 53, material: ARROW, name: '&fСледующая страница', lore: []}
minus: {slot: 46, material: RED_DYE, name: '&c−1 предмет', lore: ['&7Выбрано: &f{quantity}', '&7Для набора количество фиксировано.']}
plus: {slot: 47, material: LIME_DYE, name: '<accent>+1 предмет', lore: ['&7Выбрано: &f{quantity}', '&7Для набора количество фиксировано.']}
back: {slot: 48, material: COMPASS, name: '&fВ каталог', lore: []}
all: {slot: 49, material: CHEST, name: '<secondary>Все такие предметы', lore: ['&7Учитываются совпадающие данные предмета.']}
close: {slot: 52, material: BARRIER, name: '&cЗакрыть', lore: []}
selling-confirmation:
size: 27
title: '<heading>Подтверждение продажи'
item-slots: [13]
buttons:
back: {slot: 18, material: ARROW, name: '&fИзменить условия', lore: []}
post: {slot: 22, material: LIME_DYE, name: '<accent>Выставить · {price} {currency}', lore: ['&7Тип: &f{kind}', '&7Предметов: &f{items} · стопок: {stacks}', '&7Выбранные предметы изымутся при сохранении.']}
cancel: {slot: 26, material: RED_DYE, name: '&cОтменить', lore: ['&7Предметы остаются у вас.']}
selling-lore:
- ''
- '&7Тип: &f{kind}'
- '&7Предметов: &f{items} · стопок: {stacks}'
- '&7За всё: <accent>{price} {currency}'
- '&7Номер: &f{id}'
owner-purchase-lore:
- ''
- '&7Количество: &f{quantity}'
- '&7Сумма: <accent>{price} {currency}'
- '&7Статус: &f{status}'
- '&7Получение: &f{delivery}'
- '&7Номер: &f{id}'
- '<accent>{action}'
owner-lot-lore:
- ''
- '&7Осталось: &f{quantity}'
- '&7За остаток: <accent>{price} {currency}'
- '&7Исходный сервер: &f{source}'
- '&7Номер: &f{id}'
- '<accent>{action}'
owner-return-lore:
- ''
- '&7К получению: &f{quantity}'
- '&7Статус: &f{status}'
- '&7Получение: &f{source}'
- '&7Номер: &f{id}'
- '<accent>{action}'
catalogue:
size: 54
title: '<heading>Аукцион · {page}'
item-slots: [10, 11, 12, 13, 14, 15, 16, 19, 20, 21, 22, 23, 24, 25, 28, 29, 30, 31, 32, 33, 34]
buttons:
previous: {slot: 45, material: ARROW, name: '&fПредыдущая страница', lore: ['&7Страница {page}']}
next: {slot: 53, material: ARROW, name: '&fСледующая страница', lore: ['&7Страница {page}']}
sort: {slot: 46, material: HOPPER, name: '<accent>Сортировка', lore: ['&f{sort}', '&7Нажмите, чтобы изменить.']}
currency: {slot: 47, material: GOLD_NUGGET, name: '<accent>Валюта', lore: ['&f{currency}', '&7ЛКМ — следующая · ПКМ — все.']}
source: {slot: 48, material: COMPASS, name: '<accent>Сервер продажи', lore: ['&f{source}', '&7ЛКМ — следующий · ПКМ — все.']}
search: {slot: 49, material: OAK_SIGN, name: '<secondary>Поиск предметов', lore: ['&7Поиск: &f{search}', '&7ЛКМ — ввести · ПКМ — очистить.']}
reset: {slot: 50, material: MILK_BUCKET, name: '&fСбросить фильтры', lore: ['&7Вернуть все валюты и серверы.']}
refresh: {slot: 51, material: SUNFLOWER, name: '<accent>Обновить предложения', lore: ['&7Сохранить текущие фильтры.']}
close: {slot: 52, material: BARRIER, name: '&cЗакрыть', lore: []}
sell: {slot: 0, material: EMERALD, name: '<accent>Продать предмет', lore: ['&7Открыть оформление продажи.']}
my-lots: {slot: 2, material: CHEST, name: '&fМои предложения', lore: ['&7Продажи, сроки и возвраты.']}
deliveries: {slot: 4, material: ENDER_CHEST, name: '&fМои покупки и выдачи', lore: ['&7Статус покупок и сервер получения.']}
admin: {slot: 8, material: COMPARATOR, name: '<secondary>Управление', lore: ['&7Настройки и состояние аукциона.']}
selection:
size: 54
title: '<heading>Выбор количества'
item-slots: [13]
buttons:
back: {slot: 45, material: ARROW, name: '&fК предложениям', lore: ['&7Фильтры и страница сохранятся.']}
minus-16: {slot: 28, material: RED_STAINED_GLASS_PANE, name: '&c−16', lore: ['&7Выбрано: &f{quantity} / {available}']}
minus-1: {slot: 29, material: RED_DYE, name: '&c−1', lore: ['&7Выбрано: &f{quantity} / {available}']}
plus-1: {slot: 33, material: LIME_DYE, name: '<accent>+1', lore: ['&7Выбрано: &f{quantity} / {available}']}
plus-16: {slot: 34, material: LIME_STAINED_GLASS_PANE, name: '<accent>+16', lore: ['&7Выбрано: &f{quantity} / {available}']}
all: {slot: 31, material: CHEST, name: '<secondary>Всё предложение', lore: ['&7Количество: &f{available}', '&7Тип: &f{kind}']}
delivery: {slot: 47, material: COMPASS, name: '&fСервер получения', lore: ['<accent>{delivery}', '&7Нажмите, чтобы выбрать другой.']}
continue: {slot: 49, material: EMERALD, name: '<accent>Перейти к подтверждению', lore: ['&7Количество: &f{quantity}', '&7К оплате: <accent>{price} {currency}', '&7Получение: &f{delivery}']}
close: {slot: 53, material: BARRIER, name: '&cЗакрыть', lore: []}
confirmation:
size: 27
title: '<heading>Подтверждение покупки'
item-slots: [13]
buttons:
back: {slot: 18, material: ARROW, name: '&fИзменить количество', lore: []}
confirm: {slot: 22, material: LIME_DYE, name: '<accent>Купить · {price} {currency}', lore: ['&7Количество: &f{quantity}', '&7Получение: &f{delivery}', '&7Сумма и наличие проверятся при покупке.']}
cancel: {slot: 26, material: RED_DYE, name: '&cОтменить', lore: ['&7Вернуться к предложениям.']}
pending:
size: 27
title: '<heading>Проверка покупки'
buttons:
check: {slot: 13, material: CLOCK, name: '<accent>Проверить ту же покупку', lore: ['&7Номер: &f{request}', '&7Повторно новый заказ не создаётся.', '&7Дождитесь ответа или проверьте позже.']}
close: {slot: 22, material: BARRIER, name: '&fЗакрыть', lore: ['&7Запрос останется доступен при следующем входе.']}
lot-lore:
- ''
- '&8──────────────'
- '&7Тип: &f{kind}'
- '&7Количество: &f{available}'
- '&7Цена всего: <accent>{total} {currency}'
- '&7Сервер продажи: &f{source}'
- '&7{split}'
- '<accent>Нажмите, чтобы выбрать количество.'
selection-lore:
- ''
- '&8──────────────'
- '&7Тип: &f{kind}'
- '&7Выбрано: &f{quantity} / {available}'
- '&7К оплате: <accent>{price} {currency}'
- '&7Сервер получения: &f{delivery}'
- '&7{split}'
confirmation-lore:
- ''
- '&8──────────────'
- '&7Покупка: &f{quantity} · {kind}'
- '&7К оплате: <accent>{price} {currency}'
- '&7Сервер получения: &f{delivery}'
labels:
selling-no-price: 'укажите сумму'
owner-purchases: 'Мои покупки'
purchase-collect: 'ЛКМ — получить оплаченную покупку.'
purchase-reserved: 'Проверяется'
purchase-debiting: 'Проверяется списание'
purchase-debited: 'Оплачено · проверяется расчёт'
purchase-crediting: 'Проверяется расчёт'
purchase-waiting-player: 'Оплачено · ожидает получения'
purchase-delivering: 'Сохраняется выдача'
purchase-settling: 'Проверяется расчёт режима'
purchase-complete: 'Получено'
purchase-cancelled: 'Отменено'
purchase-needs-review: 'Нужна сверка · повтор заблокирован'
owner-lots: 'Мои предложения'
owner-returns: 'Мои возвраты'
owner-withdraw: 'ЛКМ — снять в возвраты.'
return-collect: 'ЛКМ — забрать возврат.'
owner-source-only: 'Откройте это меню на исходном сервере.'
owner-read-only: 'Выдача не повторяется.'
return-waiting: 'Ожидает получения'
return-delivering: 'Сохраняется'
return-complete: 'Получено'
return-review: 'Нужна сверка · повтор заблокирован'
return-expired: 'Срок хранения истёк'
all-currencies: 'Все валюты'
all-servers: 'Все серверы'
search-empty: 'любой предмет'
single: 'Предметы'
bundle: 'Неделимый набор'
bundle-contents: '&7Состав набора · {stacks} стопок / {items} предметов:'
bundle-content-line: '&7• &f{quantity} × {item}'
bundle-more: '&7Ещё стопок: {stacks}'
partial: 'Можно выбрать часть предложения.'
whole-only: 'Доступна только покупка целиком.'
unknown-item: 'Предложение аукциона'
sort-newest: 'Сначала новые'
sort-oldest: 'Сначала старые'
sort-price-asc: 'Цена по возрастанию · в выбранной валюте'
sort-price-desc: 'Цена по убыванию · в выбранной валюте'
sort-quantity: 'Сначала больше предметов'
messages:
selling-invalid: '&cПроверьте предметы, количество и точность суммы для выбранной валюты.'
selling-select: '&7Выберите предметы ЛКМ в своём инвентаре.'
selling-saving: '&eСохраняем предложение. &7Номер: {id}.'
selling-price-prompt: '&7Введите цену за всё предложение ({currency}). Для отмены: &f{cancel}&7.'
selling-review: '&eРезультат сохранения требует сверки. Не выставляйте эти предметы повторно. &7Номер: {id}.'
selling-complete: '<accent>Предложение опубликовано: {items} шт. за {price} {currency} &7· № {id}'
selling-rejected: '&eПредложение не опубликовано. Обновите инвентарь и условия. &7Номер: {id}.'
owner-withdrawn: '<accent>Остаток снят с продажи. &7Откройте «Мои возвраты».'
owner-unavailable: '&eЭто действие сейчас недоступно. Обновите страницу.'
owner-complete: '<accent>Возврат получен. &7Номер: {id}.'
owner-waiting: '&eОсвободите место и проверьте исходный сервер. &7Номер: {id}.'
owner-review: '&eВыдача требует сверки, повтор заблокирован. &7Номер: {id}.'
owner-expired: '&eСрок хранения истёк. &7Номер: {id}.'
loading: '&7Загружаем предложения…'
empty: '&7По этим условиям предложений нет.'
load-error: '&cНе удалось получить предложения. Нажмите «Обновить».'
renderer-error: '&cКарточка временно недоступна.'
own-offer: '&eЭто ваше предложение. Откройте «Мои предложения» для управления.'
search-prompt: '&7Напишите название в чат (до 64 символов). Для отмены: &f{cancel}&7. Время: {seconds} с.'
search-invalid: '&cВведите до 64 печатных символов.'
search-expired: '&7Время ввода истекло.'
search-cancelled: '&7Поиск не изменён.'
purchase-error: '&eОтвет покупки не получен. Номер: &f{request}&e. Откройте аукцион для проверки этого же запроса.'
purchase-accepted: '<accent>Покупка принята. &7Номер: {request}.'
purchase-delivered: '<accent>Покупка выдана. &7Номер: {request}.'
purchase-pending: '&eПокупка ожидает получения на сервере {delivery}. &7Номер: {request}.'
purchase-rejected: '&cПокупка отклонена. Обновите предложение. &7Номер: {request}.'
purchase-review: '&eПокупка требует сверки. &7Номер: {request}. Сохраните этот номер.'
result-title: '<accent>Аукцион'
result-subtitle: '&f{result}'
pending-title: '<secondary>Проверяем покупку'
pending-subtitle: '&f{quantity} · {price} {currency}'
# Холодный перенос: старый движок должен быть остановлен до запуска сервера.
# Исходный H2 читается драйвером UtilM без изменений и остаётся заблокированным
# на время работы нового аукциона. Сетевые старые БД требуют отдельного freeze.
enabled: false
# mcAuction принимает только UUID, записанные самим старым аукционом.
# Для исторических строк нужен сервис JournalLegacyAuthority указанного плагина.
authority-provider: mcAuction
# RECORDED_ONLY использует UUID исходного лота. NATIVE_PROFILE дополнительно
# проверяет точное имя/UUID в usercache.json и сохранённом Bukkit-профиле:
# профиль существовал до публикации и сохранялся после неё. Формула UUID по
# имени не используется. Этот путь не заменяет authority режимного инвентаря.
owner-resolution: RECORDED_ONLY
max-source-bytes: 268435456
max-rows-per-table: 100000
max-snapshot-bytes: 134217728
query-timeout-seconds: 15
snapshot-timeout-ms: 60000
prepare-batch-size: 100
# LOCAL_H2 сохраняет удерживаемый файловый lease. MYSQL/MARIADB требуют
# заранее установленного оператором постоянного source fence и остановки старых writers.
source-kind: LOCAL_H2
source-operation: ''
source-host: 127.0.0.1
source-port: 3306
source-database: auction_legacy
source-username-env: MCA_LEGACY_JDBC_USERNAME
source-password-env: MCA_LEGACY_JDBC_PASSWORD
source-tls-mode: VERIFY_FULL
source-tls-ca-file: ''
source-connect-timeout-ms: 3000
source-socket-timeout-ms: 5000
# Точное старое economy-type/currency-id → id из journal.yml.
# Неизвестная валюта или владелец удерживает весь переход; деньги не списываются.
currencies: []
config.yml
/auction settings config. После подтверждения изменения сохраняются в файле. Для действующей базы и сервиса расчётов используется отдельная процедура переноса.updates.enabledвключает уведомление об обновлении.database.typeвыбирает хранилище прежнего аукциона. При переносе сверьте его с базой, в которой сервер уже сохранял лоты.- В
legacy-economy.currenciesполеtypeвыбирает провайдера,idзадаёт идентификатор валюты, аdisplay-name— название для игрока. Вmessageменяются ответы на команды и подсказкаhelp. Право на перезагрузку задаётся вpermission.reload. lot_ttl_secondsзадаёт срок продажи в секундах.expired_lot_ttl_secondsотсчитывается после истечения лота. Интервал проверки просроченных лотов задаётcleaner_module.scheduler.delay_seconds. Описания подтверждения продажи и покупки находятся вlot_creation_confirmation_descriptionиlot_purchase_confirmation_description.- В
lot_limit_module.managerукажите базовый пределdefault_max_lots. Запись вlot_limit_listсвязывает правоaccess_permissionс пределомmax_lots. В списокdeny_world_name_listвходят точные имена миров, в которых аукцион закрыт. - В
filter_module.filter_listу фильтра есть постоянный идентификатор, видимое название и список материалов. Кнопка меню ссылается на него черезfilter_id. Сохраняйте идентификаторы фильтров, которыми уже пользуются игроки. - В разделах
guiотдельно оформляются каталог, склад, выбор предметов, содержимое набора, действующие и истёкшие лоты.titleиsizeзадают заголовок и число ячеек.slot.xсчитается слева с 1,slot.y— сверху с 1. Вpattern.indexesотсчёт начинается с 0. У каждой кнопки можно менятьmaterial,display_nameи строкиdescription. - В
gui.platformнастраиваются фон, задержка между кликами и анимация.interval_ticksзадаёт интервал кадров в игровых тактах,step_increment— шаг анимации.main_colorиwave_colorотвечают за материалы,frame_soundиend_sound— за звук, громкость и высоту тона. ЗначениеNONEвыключает анимацию. Вpaginationзадаются вид стрелок, кнопка возврата и их столбцы в нижнем ряду.
# mcAuction — аукцион предметов. Команда /auction открывает каталог.
# На новой установке начните с journal.yml. В нём выбирают экономику, хранилище
# и серверы выдачи. Надписи, цвета и расположение кнопок находятся в journal-menus.yml.
# В игре эти настройки открываются командами /auction settings runtime и /auction settings.
# Для настроек этого файла откройте /auction settings config. Проверка обновлений
# включается и выключается сразу. Для смены действующей базы требуется перенос лотов.
# Этот файл также содержит параметры прежнего аукциона для серверов с существующими лотами.
#
# PlayerPoints предоставляет баланс жетонов. Для Vault нужен провайдер экономики.
# PlaceholderAPI поддерживает %mcauction_active_lots% и %mcauction_lots_sold%.
# Проверять публичную карточку после запуска. Установка обновления — вручную.
updates:
enabled: true
# Валюты прежних меню. Отсутствующий провайдер скрывает только свою валюту.
# Для mcEconomy добавьте type: MC_ECONOMY и его точный id валюты.
legacy-economy:
currencies:
- type: VAULT
id: ''
display-name: '&#f7ce67Монеты'
- type: PLAYER_POINTS
id: ''
display-name: 'Ld6e8Жетоны'
message:
reload_success: "&aПлагин перезагружен!"
permission_denied: "&cОтказано в доступе."
item_not_listed: "&cПредмет не выставлен на продажу."
item_missing_inventory: "&cВыбранный предмет отсутствует в инвентаре."
item_listed: "&aПредмет выставлен на продажу!"
no_items_selected: "&cПредметы не выбраны."
not_enough_money: "&cНедостаточно средств."
lot_doesnt_exist: "&cЛот не существует или перестал существовать."
lot_changed: "&eЛот изменился или недоступен. Обновите список и проверьте условия покупки."
items_returned: "&aПредметы возвращены в инвентарь."
max_active_lots_exceeded: "&cДостигнут лимит числа одновременно активных лотов &b%max_lots%&c."
deny_world: "&cНельзя использовать в этом мире."
help:
- "&e/mcauction reload &7- перезагрузить плагин"
- "&e/mcauction help &7- показать список команд"
permission:
reload: mcauction.reload # Разрешение на перезагрузку этого плагина.
# Хранилище прежнего аукциона. При обновлении оставьте тип и подключение к существующей базе.
# Новое хранилище торговых операций выбирается в journal.yml в разделе storage.
database:
# H2 хранит данные в папке плагина.
type: H2
# Пример подключения прежнего аукциона к MySQL. Используйте один тип хранилища.
# type: MYSQL
# database: "database"
# host: "127.0.0.1"
# port: 3306
# username-env: "MCAUCTION_LEGACY_DB_USER"
# password-env: "MCAUCTION_LEGACY_DB_PASSWORD"
# Укажите значения переменных при запуске сервера. Прежние username и password
# учитываются, если соответствующая переменная не назначена. Меню их не показывает.
# Текст предмета в меню подтверждения
# размещения предмета на аукционе.
lot_creation_confirmation_description:
- "&7После подтверждения, выбранный"
- "&7предмет или набор предметов будет"
- "&7выставлен на аукцион."
# Текст предмета в меню подтверждения
# покупки предмета или набора предметов на аукционе.
lot_purchase_confirmation_description:
- "&7После подтверждения стоимость будет"
- "&7списана с вашего баланса, а предмет"
- "&7или набор предметов попадут"
- "&7в ваш инвентарь."
# Через сколько секунд с момента публикации лота считать
# его истёкшим и поместить в меню "Истёкшие лоты".
lot_ttl_seconds: 86400
# Через сколько секунд с момента как лот стал
# истёкшим считать его готовым к удалению.
expired_lot_ttl_seconds: 86400
# Конфигурация чистильщика.
cleaner_module:
scheduler:
# С каким интервалом секунд удалять
# готовые к удалению лоты.
delay_seconds: 300
# Конфигурация ограничителя числа лотов.
lot_limit_module:
manager:
# Максимальное число лотов по умолчанию.
default_max_lots: 100
# Список ограничителей.
lot_limit_list:
# ID ограничителя.
lot_limit_1:
# Разрешение при наличии которого максимальное
# число лотов увеличивается до "max_lots".
access_permission: "mcauction.lot_limit_1"
# Новое максимальное число лотов игрока
# при наличии разрешения "access_permission".
max_lots: 100
lot_limit_2:
access_permission: "mcauction.lot_limit_2"
max_lots: 100
# Список миров в которых использование команды /mcauction и её алиас запрещено.
deny_world_name_list:
- "world2"
- "deny_world123"
# Конфигурация модуля фильтров.
filter_module:
# Список фильтров.
filter_list:
# ID фильтра.
# Пожалуйста придумайте название 1 раз и не меняйте.
# ID фильтров присваиваются и хранятся в базе данных
# за лотами. Безусловно если перевыставить лот, то
# ID новых изменённых в конфигурации фильтров будут
# применены, однако сейчас это не происходит автоматически.
anarchy_filter:
# Название фильтра.
display_name: "&6Всё для анархии"
# Список материалов на которые
# распространяется этот фильтр.
# Пожалуйста придумайте список материалов 1 раз и не меняйте.
# Присваиваемые фильтры лотов сверяются с ним только при создании,
# а не динамически чтобы запросы были производительными.
# Безусловно если перевыставить лот, то новые изменённые материалы
# в этой конфигурации будут применены, однако сейчас это не происходит автоматически.
material_list:
- TNT
- FLINT_AND_STEEL
stones_filter:
display_name: "&2Камни и булыжник"
material_list:
- STONE
- COBBLESTONE
- MOSSY_COBBLESTONE
gui:
title: "Фильтры"
size: 54
button_list:
button_1:
filter_id: anarchy_filter
slot:
x: 1
y: 1
item:
material: TNT
display_name: "&6Всё для анархии"
description:
- "&7Предметы этой категории"
- "&7TNT и зажигалка."
- ""
- "&eКликните чтобы применить этот фильтр!"
button_2:
filter_id: stones_filter
slot:
x: 2
y: 1
item:
material: STONE
display_name: "&2Камни и булыжник"
description:
- "&7Предметы этой категории"
- "&7Камень и булыжник (замшелый тоже)."
- ""
- "&eКликните чтобы применить этот фильтр!"
return:
slot:
x: 1
y: 6
item:
material: SPECTRAL_ARROW
display_name: "&fВернуться"
description:
- ""
- "&eКликните чтобы вернуться!"
gui:
# Внутреннее оформление прежнего режима; настройки нового журнала — journal-menus.yml.
platform:
click_delay_ticks: 4
background:
material: GRAY_STAINED_GLASS_PANE
display_name: ' '
description: []
# Столбцы последнего ряда, от 1 до 9. У стрелок двух страниц должны быть разные столбцы.
pagination:
back:
column: 8
material: ARROW
display_name: '&eНазад'
description: []
next:
column: 9
material: ARROW
display_name: '&eДальше'
description: []
return:
column: 1
material: ARROW
display_name: '&eВернуться'
description: []
animation:
# NONE отключает анимацию; также доступны CURTAIN_TOP_TO_BOTTOM и SEA_WAVE.
type: SEA_WAVE
interval_ticks: 2
step_increment: 2
main_color:
material: GRAY_STAINED_GLASS_PANE
display_name: ' '
description: []
wave_color:
material: CYAN_STAINED_GLASS_PANE
display_name: ' '
description: []
frame_sound:
sound: ''
volume: 0.25
pitch: 1.0
end_sound:
sound: ''
volume: 0.25
pitch: 1.0
confirmation:
title: '檱bПроверка условий'
economy:
title: '檱bВалюта продажи'
price_prompt: '&eВведите цену за всё предложение. Для отмены: отмена.'
invalid_price: '&cВведите положительную цену; для жетонов требуется целое число.'
auction:
title: "Аукцион" # Название меню.
size: 54 # Размер меню.
publish:
slot: # Позиция кнопки по X, Y.
x: 2 # (1-9) Позиция по X (горизонталь).
y: 6 # (1-6) Позиция по Y (вертикаль).
item:
# Тип материала кнопки.
# Используйте материалы версии ядра на котором запускаете плагин.
# Списки всех материалов для каждой версии:
# https://helpch.at/docs/1.8.8/org/bukkit/Material.html
# https://helpch.at/docs/x.x.x/org/bukkit/Material.html
# ...
material: JUKEBOX
# Название кнопки.
display_name: "&fВыставить предмет на продажу"
# Описание кнопки.
description:
- "&7Чтобы разместить свой предмет или"
- "&7набор предметов начните здесь."
- ""
- "&eКликните чтобы выбрать!"
filters:
slot:
x: 6
y: 6
item:
material: COMPARATOR
display_name: "&fФильтры"
description:
- "&7Ищите только самое нужно."
- ""
- "&eКликните чтобы изменить!"
refresh:
slot:
x: 7
y: 6
item:
material: SUNFLOWER
display_name: "&fОбновить список"
description:
- "&7Обновляет информацию о списке"
- "&7предметов на этой странице."
- ""
- "&eКликните чтобы обновить!"
pattern:
# Индексы ячеек меню от A (включительно) до B (включительно), записываются как "A-B".
# Отсчёт начинается с 0, слева направо, начиная с верхнего левого угла.
indexes: "0-44"
# Конфигурация описания выставленного на аукцион предмета.
lot:
# Если предмет 1, это его описание.
# Название и материал повторяют предмет.
item:
description:
- "&6Продавец: &f%player_name%"
- "&6Цена: &f%price% %currency_sign%"
- "&6До окончания: &b%time_left%"
- ""
- "&eКликните чтобы купить!"
# Если это набор предметов (более 1), это его описание.
bundle:
material: CHEST
display_name: "&fНабор предметов"
amount: 1
description:
- "&6Предметов: &ex%items%"
- "&6Продавец: &f%player_name%"
- "&6Цена: &f%price% %currency_sign%"
- "&6До окончания: &b%time_left%"
- ""
- "&6ПКМ &eчтобы купить!"
- "&6ЛКМ &eчтобы посмотреть предметы!"
# Кнопка назад списка предметов аукциона.
# Вид кнопки: gui.platform.pagination.back этого файла.
back:
slot:
x: 8
y: 6
# Кнопка далее списка предметов аукциона.
# Вид кнопки: gui.platform.pagination.next этого файла.
next:
slot:
x: 9
y: 6
to_storage:
slot:
x: 1
y: 6
item:
material: CHEST
display_name: "&fСклад"
description:
- "&7Предметы время размещения которых"
- "&7вышло, отправляются на склад."
- ""
- "&eКликните чтобы открыть!"
storage:
title: "Склад"
size: 54
to_auction:
slot:
x: 1
y: 6
item:
material: SPECTRAL_ARROW
display_name: "&fВернуться"
description:
- ""
- "&eКликните чтобы вернуться!"
to_expired_lots:
slot:
x: 4
y: 3
item:
material: GUNPOWDER
display_name: "&fИстёкшие лоты"
description:
- "&7Лоты время публикации которых"
- "&7вышло, находятся здесь."
- ""
- "&cПоспешите забрать или перевыставить"
- "&cистёкшие предметы. Спустя время они"
- "&cмогут пропасть насовсем."
- ""
- "&eКликните чтобы открыть!"
to_active_lots:
slot:
x: 6
y: 3
item:
material: ENDER_CHEST
display_name: "&fАктивные лоты"
description:
- "&7В этом меню находятся ваши активные"
- "&7лоты которые прямо сейчас могут"
- "&7приобрести другие игроки."
- ""
- "&aВы можете снять ваш лот и"
- "&aзабрать предмет назад здесь."
- ""
- "&eКликните чтобы открыть!"
select_lot_items:
title: "Выбор предмета(ов)"
size: 9
bundle_items:
title: "Предметы набора"
size: 18
pattern:
indexes: "0-8"
# Кнопка назад списка предметов.
# Вид кнопки: gui.platform.pagination.back этого файла.
back:
slot:
x: 8
y: 2
# Кнопка далее списка предметов.
# Вид кнопки: gui.platform.pagination.next этого файла.
next:
slot:
x: 9
y: 2
to_auction:
slot:
x: 1
y: 2
item:
material: SPECTRAL_ARROW
display_name: "&fВернуться"
description:
- ""
- "&eКликните чтобы вернуться!"
expired_lots:
title: "Истёкшие лоты"
size: 54
filters:
slot:
x: 6
y: 6
item:
material: COMPARATOR
display_name: "&fФильтры"
description:
- "&7Ищите только самое нужно."
- ""
- "&eКликните чтобы изменить!"
refresh:
slot:
x: 7
y: 6
item:
material: SUNFLOWER
display_name: "&fОбновить список"
description:
- "&7Обновляет информацию о списке"
- "&7предметов на этой странице."
- ""
- "&eКликните чтобы обновить!"
pattern:
# Индексы ячеек меню от A (включительно) до B (включительно), записываются как "A-B".
# Отсчёт начинается с 0, слева направо, начиная с верхнего левого угла.
indexes: "0-44"
# Конфигурация описания лота.
lot:
# Если предмет 1, это его описание.
# Название и материал повторяют предмет.
item:
description:
- "&7Продавец: &f%player_name%"
- "&7Цена: &f%price% %currency_sign%"
- "&cУдаление через: &b%time_left%"
- ""
- "&eКликните чтобы вернуть предмет(ы) назад!"
# Если это набор предметов (более 1), это его описание.
bundle:
material: CHEST
display_name: "&fНабор предметов"
amount: 1
description:
- "&7Предметов: &ex%items%"
- "&7Продавец: &f%player_name%"
- "&7Цена: &f%price% %currency_sign%"
- "&cУдаление через: &b%time_left%"
- ""
- "&6ПКМ &eчтобы вернуть предмет(ы) назад!"
- "&6ЛКМ &eчтобы посмотреть предметы!"
# Кнопка назад списка лотов.
# Вид кнопки: gui.platform.pagination.back этого файла.
back:
slot:
x: 8
y: 6
# Кнопка далее списка лотов.
# Вид кнопки: gui.platform.pagination.next этого файла.
next:
slot:
x: 9
y: 6
to_storage:
slot:
x: 1
y: 6
item:
material: SPECTRAL_ARROW
display_name: "&fВернуться"
description:
- ""
- "&eКликните чтобы вернуться!"
active_lots:
title: "Активные лоты"
size: 54
filters:
slot:
x: 6
y: 6
item:
material: COMPARATOR
display_name: "&fФильтры"
description:
- "&7Ищите только самое нужно."
- ""
- "&eКликните чтобы изменить!"
refresh:
slot:
x: 7
y: 6
item:
material: SUNFLOWER
display_name: "&fОбновить список"
description:
- "&7Обновляет информацию о списке"
- "&7предметов на этой странице."
- ""
- "&eКликните чтобы обновить!"
pattern:
# Индексы ячеек меню от A (включительно) до B (включительно), записываются как "A-B".
# Отсчёт начинается с 0, слева направо, начиная с верхнего левого угла.
indexes: "0-44"
# Конфигурация описания лота.
lot:
# Если предмет 1, это его описание.
# Название и материал повторяют предмет.
item:
description:
- "&6Продавец: &f%player_name%"
- "&6Цена: &f%price% %currency_sign%"
- "&6До окончания: &b%time_left%"
- ""
- "&eКликните чтобы вернуть предмет(ы) назад!"
# Если это набор предметов (более 1), это его описание.
bundle:
material: CHEST
display_name: "&fНабор предметов"
amount: 1
description:
- "&6Предметов: &ex%items%"
- "&6Продавец: &f%player_name%"
- "&6Цена: &f%price% %currency_sign%"
- "&6До окончания: &b%time_left%"
- ""
- "&6ПКМ &eчтобы вернуть предмет(ы) назад!"
- "&6ЛКМ &eчтобы посмотреть предметы!"
# Кнопка назад списка лотов.
# Вид кнопки: gui.platform.pagination.back этого файла.
back:
slot:
x: 8
y: 6
# Кнопка далее списка лотов.
# Вид кнопки: gui.platform.pagination.next этого файла.
next:
slot:
x: 9
y: 6
to_storage:
slot:
x: 1
y: 6
item:
material: SPECTRAL_ARROW
display_name: "&fВернуться"
description:
- ""
- "&eКликните чтобы вернуться!"