CoinOp (Койн оп)

Плагин для серверов Майнкрафт с экономикой и рынком, где игроки торгуют предметами друг с другом через заявки на покупку и продажу. Цены определяются спросом и предложением, как на бирже: подходящие заявки исполняются автоматически.

Возможности

• Заявки на покупку и продажу предметов с указанием количества и цены за единицу.
• Мгновенная покупка по самой низкой доступной цене и продажа по самой высокой.
• Просмотр текущих цен, недавних сделок и собственных активных заявок.
• Цены покупки и продажи, объём торгов и направление изменения цены в подсказке предмета.
• Необязательное меню для торговли с категориями предметов.
• Общий рынок для нескольких серверов через Redis.
• Переработанная наковальня с линейной стоимостью операций: лимит «Слишком дорого!» можно убрать. Зачарования можно переносить с предмета на книгу, положив зачарованный предмет в левый слот, а книгу — в правый.

Заявки на покупку с более высокой ценой исполняются раньше, а заявки на продажу с более низкой — раньше. Когда цена покупки равна или выше цены продажи, сделка проходит по цене заявки на продажу.

Команды

Игрокам:

• /coinop, /co или /market — открыть меню рынка.
• /coinop buy <item> <amount> <price> или /coinbuy — создать заявку на покупку.
• /coinop sell <item> <amount> <price> или /coinsell — создать заявку на продажу.
• /coinop instant buy <item> <amount> — мгновенно купить предметы.
• /coinop instant sell <item> <amount> — мгновенно продать предметы.
• /coinop orders или /coinorders — посмотреть свои заявки.
• /coinop orders cancel <item> <id> — отменить заявку.
• /coinop price <item> или /coinprice — узнать текущую цену.
• /coinop history <item> — посмотреть последние сделки с предметом.

Администраторам:

• /coinadmin reload или /coa reload — перезагрузить конфиг.
• /coinadmin bounds list — показать ограничения цен.
• /coinadmin bounds set <item> <min> <max> — задать пределы цены предмета.
• /coinadmin bounds remove <item> — удалить пределы цены.
• /coinadmin limits list — показать торговые лимиты.
• /coinadmin limits set <item> <limit> — задать дневной лимит.
• /coinadmin stats [item] — посмотреть статистику торгов.
• /coinadmin cleanup — удалить неактивные заявки.
• /coinadmin sync status — проверить подключение к Redis.

Права

• CoinOp.use — доступ к основным функциям рынка.
• CoinOp.buy и CoinOp.sell — создание заявок на покупку и продажу.
• CoinOp.instant — мгновенная покупка и продажа.
• CoinOp.orders — просмотр своих заявок.
• CoinOp.cancel — отмена своих заявок.
• CoinOp.admin — административные команды.
• CoinOp.admin.bounds, CoinOp.admin.limits, CoinOp.admin.reload, CoinOp.admin.sync — отдельные права на управление пределами цен, лимитами, конфигом и синхронизацией.
• CoinOp.bypass.limit и CoinOp.bypass.bounds — обход торговых лимитов и ограничений цен.

Настройка

Основной файл — plugins/CoinOp/config.yml.

• В economy.tax-rate задаётся комиссия со сделки: например, 0.05 удерживает 5% от суммы продажи.
• В orders.min-amount, orders.max-amount и orders.expiration-minutes настраиваются минимальное и максимальное количество предметов в заявке, а также срок её действия. Значение -1 у максимума или срока означает отсутствие ограничения.
• В commodities.allowed можно разрешить все предметы пустым списком [] либо указать конкретные. В commodities.categories создаются категории для меню.
• В limits.global-daily-limit и limits.daily-limits задаются дневные ограничения на общий объём торгов и отдельные предметы; 0 отключает общий лимит.
• В price-bounds включаются минимальные и максимальные цены для всех предметов либо для отдельных товаров. Это помогает защитить рынок от переводов денег через фиктивные сделки и завышенных цен.
• В lore настраиваются рыночные данные в подсказках предметов и число точек истории цены.
• В anvil-rework включаются переработка наковальни, извлечение зачарований, максимальная стоимость и базовые цены материалов.
• В gui включается меню, задаются его заголовок, размер, звуки и значки категорий.
• Для общего рынка на нескольких серверах включите sync.enabled и укажите параметры Redis. Для одиночного сервера синхронизация не нужна.
• В database.type выберите sqlite для локального файла базы данных или mysql для внешней базы, например при работе нескольких серверов.

Требования

Нужен сервер на Paper, Spigot, Bukkit или совместимом с ними ядре, а также экономический плагин: EssentialsX, CMI или PlayerPoints. Для связи с экономикой используется Vault. Для работы нескольких серверов требуется Redis; общую историю заявок и данные игроков можно хранить в MySQL.