Minecraft Villager Trade Manager V12.0 - Полный контроль над экономикой жителей

Minecraft Villager Trade Manager - это мощный плагин для серверов Paper и Spigot, который даёт администраторам полный контроль над торговлей с жителями в Майнкрафт. Если вы когда-нибудь сталкивались с тем, что игроки слишком быстро получают алмазы через жителей или цены на книги зачарований выходят из-под контроля - этот плагин решит все проблемы. Он позволяет настраивать цены для каждой профессии, блокировать нежелательные предметы и управлять рестоками так, как удобно именно вам.

Плагин работает на Minecraft 1.20.x - 1.21.x и поддерживает серверные платформы Folia, Paper, Purpur, Spigot и Bukkit. Для работы требуется Java 17 или новее.

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

🤖 ИИ-помощник (новое в V12)

Встроенная система помощи с искусственным интеллектом на базе Groq. Просто напиши /vtrade help askquestion "Как заблокировать алмазные мечи?" - и получишь ответ прямо в игре. Помощник понимает контекст твоего сервера и знает все механики плагина.

Примеры запросов:

• /vtrade help askquestion "How do I set up custom prices for armorers?"
• /vtrade help askquestion "What items should I ban to prevent economy exploits?"
• /vtrade help askquestion "How does the villager leveling system work?"

💰 Универсальные цены для всех профессий

Плагин поддерживает все 13 профессий жителей: Armorer, Butcher, Cartographer, Cleric, Farmer, Fisherman, Fletcher, Leatherworker, Librarian, Mason, Shepherd, Toolsmith, Weaponsmith. Для каждой можно задать свою цену на любой предмет.

Пример: /vt setprice armorer diamond_leggings 30 - теперь алмазные поножи у броневщика стоят 30 изумрудов.

🚫 Система блокировки предметов (новое в V11)

Можно полностью запретить определённые предметы в торговле жителей. При блокировке базового предмета автоматически блокируются и его зачарованные варианты.

Команды:

• /vt banitem diamond_sword - запретить алмазные мечи
• /vt unbanitem diamond_sword - разрешить снова
• /vt listbanneditems - посмотреть список запрещённых предметов

💾 Поддержка нескольких баз данных (новое в V11)

• SQLite - локальная файловая база (рекомендуется)
• Supabase - облачная REST API
• PostgreSQL - прямое JDBC-подключение (новое в V11)
• Автоматическое переключение на SQLite при сбое облачной базы

⚡ Продвинутая система рестока

• Мгновенный ресток: /vt instantrestock on
• Настраиваемые интервалы: /vt restocktime <минуты>
• Дневные лимиты: /vt restocklimit <количество>
• Бесконечный режим: /vt unlimitedrestock on

🎮 Мультиплатформенная совместимость

Плагин оптимизирован для Folia с регионной многопоточностью, полностью совместим с Paper и Purpur, поддерживает Spigot и Bukkit. Все операции потокобезопасны.

📊 Мониторинг в реальном времени

• Аналитика торговли: /vt analyzetrades
• Проверка конкретного жителя: /vt inspectvillager
• Экспорт конфигурации: /vt exporttrades json/yaml

📦 Установка

1. Скачай JAR-файл плагина Minecraft Villager Trade Manager
2. Останови сервер Майнкрафт
3. Помести Minecraft-Villager-Trade-Manager-11.0.jar в папку plugins/
4. Запусти сервер - конфигурационные файлы создадутся автоматически
5. Настрой plugins/VillagerTradeManager/config.yml под свои нужды
6. Перезапусти сервер или используй /reload (не рекомендуется на продакшене)

⚙️ Базовая конфигурация

# Включение/отключение плагина
settings:
  trade_management_enabled: true

# Выбор базы данных
database:
  type: "sqlite"  # Варианты: sqlite, supabase, postgresql

# Настройки рестока
custom_restock_enabled: false
restock_interval_minutes: 30
restock_limit_per_day: 3
unlimited_restock: false
instant_restock_enabled: false

Настройка баз данных

SQLite (рекомендуется):

database:
  type: "sqlite"
  sqlite:
    file: "villager_data.db"

Supabase (облачная REST API):

database:
  type: "supabase"
  supabase:
    url: "https://your-project.supabase.co"
    apiKey: "your-anon-key"
    serviceKey: "your-service-key"
    schema: "public"

PostgreSQL (прямое JDBC-подключение):

database:
  type: "postgresql"
  postgresql:
    connectionString: "postgresql://user:password@host:5432/database"

🖥️ Команды плагина

Основные команды

Команда	Описание	Пример
/vt on/off	Включить/отключить управление торговлей	/vt on
/vt status	Показать текущие настройки и забаненные предметы	/vt status

Управление ценами

Команда	Описание	Пример
/vt setprice <профессия> <предмет> <цена>	Установить цену для торговли	/vt setprice armorer diamond_leggings 30
/vt resetprice <профессия> <торговля>	Сбросить цену до стандартной	/vt resetprice armorer armorer_l4_emerald_13_diamond_boots_1
/vt listtrades <профессия>	Показать все торговли профессии	/vt listtrades armorer

Блокировка предметов (новое в V11)

Команда	Описание	Пример
/vt banitem <предмет>	Запретить предмет в торговле	/vt banitem diamond_sword
/vt unbanitem <предмет>	Разрешить предмет в торговле	/vt unbanitem diamond_sword
/vt listbanneditems	Показать все запрещённые предметы	/vt listbanneditems

Управление рестоком

Команда	Описание	Пример
/vt restock on/off	Включить кастомный ресток	/vt restock on
/vt restocktime <минуты>	Установить интервал рестока	/vt restocktime 45
/vt restocklimit <количество>	Установить дневной лимит рестока	/vt restocklimit 5
/vt unlimitedrestock on/off	Бесконечный ресток	/vt unlimitedrestock on
/vt instantrestock on/off	Мгновенный ресток	/vt instantrestock on

Аналитика и продвинутые команды

Команда	Описание	Пример
/vt analyzetrades	Показать статистику торговли	/vt analyzetrades
/vt inspectvillager	Проанализировать ближайшего жителя	/vt inspectvillager
/vt exporttrades json/yaml	Экспортировать конфигурацию торговли	/vt exporttrades json
/vt tradedetection on/off/status	Управление динамическим обнаружением торговли	/vt tradedetection status
/vt cleardynamictrades	Очистить старые динамические данные торговли	/vt cleardynamictrades

🔧 Продвинутые возможности

Система блокировки предметов на практике

# Запрещаем алмазные мечи (автоматически блокируются все зачарованные варианты)
/vt banitem diamond_sword

# Запрещаем зачарованные золотые яблоки
/vt banitem enchanted_golden_apple

# Проверяем список запрещённых предметов
/vt listbanneditems

Примеры настройки цен

# Простой формат (рекомендуется)
/vt setprice armorer diamond_leggings 25
/vt setprice librarian protection_4 30
/vt setprice farmer emerald 2

Миграция базы данных

Плагин автоматически обрабатывает обновления схемы базы данных. При обновлении с более старых версий он:

1. Определяет разницу версий
2. Применяет миграции автоматически
3. Сохраняет существующие данные
4. Логирует процесс миграции

🔧 Решение проблем и производительность

Частые проблемы и их решения

Плагин не загружается: проверь Java 17+ и совместимую версию Minecraft. Ошибка подключения к базе данных: проверь учётные данные и сетевое подключение для облачных баз. Плагин автоматически переключится на SQLite. Команды не работают: проверь права доступа и возможные конфликты с другими плагинами. Высокая нагрузка на CPU: уменьши trade_monitor_frequency в конфиге или включи Folia для лучшей производительности.

Настройка производительности в config.yml:

performance:
  trade_monitor_frequency: 60  # Тики между проверками (60 = 3 секунды)
  villager_scan_radius: 32     # Радиус сканирования жителей в блоках

📊 Метрики и мониторинг (опционально)

Плагин поддерживает Prometheus для сбора метрик. Включи в config.yml:

metrics:
  enabled: true
  prometheus:
    enabled: true

Также доступен HTTP-эндпоинт для проверки здоровья сервера.

📋 Системные требования и идеальные сценарии использования

• RAM: от +50 МБ (зависит от объёма торговли)
• CPU: минимальная нагрузка, оптимизирован для Folia и Paper/Purpur/Pufferbacked серверов.
• Хранилище: ~1 МБ для SQLite базы данных.
• Сеть: требуется только для облачных баз данных.
• Идеально подходит для: экономических серверов с жителями; быстрых игровых режимов или ивентов; крупных Folia-серверов с сотнями жителей; серверов на BungeeHost (https://bungee.host), где можно установить плагин в один клик.
• Тестировался на: Minecraft 1.20.x - 1.21.x, Folia, Paper, Purpur, Spigot, Bukkit.
• Лицензия: MIT License - свободное использование для личных и коммерческих целей.
• Разработчик: AlanTheDev (Villager Trade Manager Team). Благодарности сообществам SpigotMC, PaperMC и всем администраторам серверов Minecraft.

---

Скачайте плагин Minecraft Villager Trade Manager и возьмите под контроль экономику вашего сервера Майнкрафт уже сегодня!