Minecraft Villager Trade Manager

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

Возможности

• Настраивает цены сделок у всех профессий жителей.
• Запрещает выбранные предметы во всех сделках; запрет базового предмета распространяется и на его зачарованные варианты.
• Позволяет включить мгновенное обновление сделок, задать интервал обновления, дневной лимит или убрать ограничения.
• Ведёт статистику торговли, показывает сделки ближайшего жителя и умеет обнаруживать новые сделки.
• Сохраняет данные в SQLite, Supabase или PostgreSQL. При недоступности облачной базы используется SQLite.
• Встроенный помощник отвечает на вопросы о настройке плагина через Groq API.

Команды

• /vt on и /vt off — включить или отключить управление торговлей.
• /vt status — показать текущие настройки и запрещённые предметы.
• /vt setprice <profession> <item> <cost> — установить цену сделки в изумрудах.
• /vt resetprice <profession> <trade> — вернуть стандартную цену сделки.
• /vt listtrades <profession> — вывести сделки профессии.
• /vt banitem <item>, /vt unbanitem <item>, /vt listbanneditems — управлять запрещёнными предметами.
• /vt restock on/off, /vt restocktime <minutes>, /vt restocklimit <count>, /vt unlimitedrestock on/off, /vt instantrestock on/off — настроить обновление сделок.
• /vt analyzetrades — показать статистику торговли; /vt inspectvillager — проверить сделки ближайшего жителя.
• /vt exporttrades json/yaml — экспортировать конфигурацию сделок.
• /vt tradedetection on/off/status и /vt cleardynamictrades — управлять обнаружением сделок и его данными.
• /vtrade help askquestion "<question>" — задать вопрос встроенному помощнику.

Настройка

Основные параметры находятся в plugins/VillagerTradeManager/config.yml.

• settings.trade_management_enabled — включает управление торговлей.
• database.type — выбирает sqlite, supabase или postgresql.
• custom_restock_enabled, restock_interval_minutes, restock_limit_per_day, unlimited_restock и instant_restock_enabled управляют обновлением сделок.
• performance.trade_monitor_frequency и performance.villager_scan_radius помогают снизить нагрузку на крупных серверах.
• Для отладки доступны logging.debug_database, logging.debug_trades и logging.debug_restock.

Требования

Плагин работает на серверах Paper, Purpur, Spigot, Bukkit и Folia; требуется Java 17 или выше. Для Supabase и PostgreSQL нужны параметры подключения, а для облачной базы — доступ к сети.