qShadowTrader — таинственный странник с уникальными предложениями в Minecraft
Представьте: вы исследуете мир, строите ферму или сражаетесь с мобами, и вдруг рядом материализуется загадочный торговец с редкими товарами. Плагин qShadowTrader добавляет в Minecraft именно такую механику — случайные появления NPC с настраиваемыми предметами, лимитами покупок и даже выполнением команд. Он идеально вписывается в серверы с экономикой, RPG-элементами или просто для оживления геймплея. Установить плагин можно быстро и без лишних хлопот через лаунчер foxygame.net — удобный и современный инструмент, который позволяет загружать моды и плагины прямо из меню, экономя время на ручной настройке.
Основные возможности qShadowTrader
Плагин создаёт динамичного торговца, который появляется рядом со случайным игроком и предлагает товары с ограниченным количеством покупок. Вот ключевые особенности:
- Случайный спавн рядом с подходящим игроком через настраиваемые интервалы и шанс.
- Гибкая система миров: можно запретить появление в определённых мирах или, наоборот, разрешить только в избранных.
- Два формата товаров: простые предметы (материал и количество) и кастомные с поддержкой названий, описаний, model-data, чар, флагов и неразрушимости.
- Глобальные лимиты покупок на текущую сессию торговца, отображаемые прямо в описании предмета.
- Выполнение команд при покупке — от снятия валюты до выдачи прав или запуска цепочек событий.
- Защита от двойного клика, чтобы избежать случайных повторных покупок.
- Чат-уведомления о появлении и исчезновении торговца.
- Сохранение кулдаунов игроков в data.yml для предотвращения частого спавна на одного и того же человека.
Жизненный цикл теневого торговца
Появление торговца — не хаотичный процесс, а продуманная последовательность проверок. Сначала плагин ожидает случайный промежуток времени между spawn-interval-min и spawn-interval-max. Затем срабатывает шанс spawn.chance. Если проверка пройдена, система ищет подходящего игрока: он должен быть онлайн, жив, не в креативе и не в спектаторе, находиться в разрешённом мире и не иметь активного кулдауна. После этого торговец появляется на безопасной локации в радиусе spawn-distance от цели.
Торговец остаётся в мире до истечения lifetime или до тех пор, пока все его предложения не будут раскуплены — если включён параметр despawn-when-empty. Каждый раз при спавне генерируется новый набор офферов с учётом весовых шансов из файла trades.yml, а лимиты покупок обнуляются.
Команды и права
Управление плагином осуществляется через основной псевдоним /st или полную команду /shadowtrader. Доступные действия:
- /st spawn — принудительный спавн торговца рядом с отправителем (если это игрок) или случайной целью (из консоли).
- /st spawn random — спавн на случайном валидном игроке.
- /st spawn <игрок> — спавн рядом с указанным игроком с учётом всех ограничений.
- /st despawn — удаление активного торговца.
- /st reload — перезагрузка конфигураций.
- /st info — просмотр текущего статуса.
Права разделены на базовые и административные: qshadowtrader.use для использования команд, qshadowtrader.admin для полного доступа, а также отдельные qshadowtrader.spawn и qshadowtrader.reload.
Настройка плагина
config.yml
Основной конфиг управляет поведением торговца. Ключевые секции:
- spawn — интервалы, шанс, список миров (blocked-worlds и allowed-worlds).
- player-cooldown — время, через которое игрок снова может стать целью.
- spawn-distance — минимальное и максимальное расстояние от игрока до точки появления.
- messages — кастомизация чат-уведомлений.
- lifetime — время жизни торговца в секундах.
- despawn-when-empty — исчезновение после скупки всех товаров.
- trader — настройки самого моба (тип, имя, защита от урона).
- menu — параметры GUI.
- protection.double-click-window-ms — защита от двойного клика в миллисекундах.
trades.yml — сердце экономики
Все предложения описываются в файле trades.yml. Каждый товар имеет уникальный идентификатор и может быть задан в кратком формате (material и amount) или расширенном (item.* с поддержкой кастомных названий, описаний, model-data, чар, флагов и неразрушимости). Дополнительно настраиваются:
- limit — максимальное число покупок этого предмета у текущего торговца.
- chance — вес вероятности появления в ассортименте.
- lore — описание в интерфейсе, где можно использовать плейсхолдеры %CURR_LIMIT% и %MAX_LIMIT% для отображения прогресса покупок.
- commands — список команд, выполняемых при покупке. Префикс [console] запускает команду от имени консоли, [player] — от имени игрока. Поддерживаются плейсхолдеры <player> и %player%.
Пример товара «Тотем бессмертия»: материал TOTEM_OF_UNDYING, количество 1, лимит 1, шанс 10, описание с ценой и счётчиком лимита, команда на снятие 2500 единиц валюты через консоль. Такой подход позволяет легко интегрировать плагин с любыми экономическими системами.
Практические советы и заключение
qShadowTrader отлично подходит для серверов с активной экономикой, где важно поддерживать интерес игроков через редкие и лимитированные предложения. Благодаря гибкой настройке миров и кулдаунов можно избежать дисбаланса, а выполнение команд открывает безграничные возможности — от выдачи кейсов до запуска мини-ивентов. Если автоматический спавн не работает, проверьте spawn.enabled, фильтры миров и наличие подходящих игроков онлайн.
Плагин легко встраивается в любую сборку, а для максимально быстрой установки стоит обратить внимание на лаунчер foxygame.net — современное решение, где моды и плагины загружаются прямо из интерфейса, без ручного поиска файлов. Это экономит время и позволяет сосредоточиться на творческой настройке сервера. qShadowTrader добавит в ваш мир элемент неожиданности и живую торговлю, которую игроки обязательно оценят.