Happy Filter
Если ваш Minecraft-сервер когда-нибудь захлёстывало волной ботов, вы знаете, как это выглядит: лаг-спайки, забитые слоты, спам в чате и бесконечные фейковые подключения. Классические капчи с вводом кода или нажатием кнопки боты давно обходят. Happy Filter — это плагин, который заставляет пройти настоящий игровой квест, и боты на нём сыпятся. Давайте разберёмся, что это за зверь и как его поставить.
Что такое Happy Filter
Happy Filter (в технической документации — HappyFilterCaptcha) — это анти-бот капча для Minecraft, построенная на реальной игровой механике. Никаких «введи слово» или «нажми на блок». Игрок попадает в отдельный void-мир, и ему нужно выполнить цепочку действий: сундук → еда → шалкер → кирка → воронка. Живой человек справляется примерно за 20 секунд, а бот просто не понимает, что от него хотят, и отваливается.
Фишка в том, что проверка идёт не по каким-то абстрактным признакам, а по точному совпадению предметов. Сундук генерируется каждый раз заново: еда трёх видов по 1–4 штуки плюс мусор (8–12 предметов) в случайных слотах. Нужно переложить всю еду в шалкер, сломать его киркой в главной руке и бросить в воронку. В момент засасывания воронкой срабатывает проверка через InventoryPickupItemEvent: метка PersistentDataContainer плюс сверка один к одному по типу и количеству. Прошёл — Connect lobby через BungeeCord-канал. Ошибся — кик.
Как это работает на практике
Алгоритм простой, но эффективный:
- Игрок заходит на сервер — его телепортирует в void-мир капчи, инвентарь очищается, выдаётся кирка с меткой сессии.
- В сундуке появляется случайный набор еды и мусора в произвольных слотах.
- Задача: переложить всю еду в шалкер, сломать его киркой в главной руке и выбросить в воронку.
- Успех — переход в лобби. Любая ошибка — кик. Выход во время капчи — без кика, можно попробовать заново.
Комната одна, поэтому остальные игроки ждут в очереди в замороженном состоянии. Это создаёт небольшой «шлюз», который дополнительно фильтрует наплыв подключений.
Технические особенности и совместимость
Happy Filter написан только на Bukkit API, без NMS. Это значит, что он работает на Spigot, Paper и Purpur в диапазоне версий Minecraft 1.14–1.21. Плагин ставится за прокси BungeeCord или Velocity, при этом на прокси желательно держать ViaVersion, чтобы игроки с разными версиями клиента могли заходить без проблем.
Мир капчи копируется автоматически: из plugins/HappyFilterCaptcha/World в ./captcha, и ваш собственный мир он никогда не перезапишет. В настройках мира выставлены PEACEFUL, doMobSpawning false, а чанки всегда загружены — так что никаких сюрпризов с мобами или выгрузкой не будет.
Все тексты лежат в messages.yml с поддержкой &-цветов, есть title и actionbar-таймер на 30 секунд. Кики пишутся в консоль, исключения — в errors.log. Управление через команды /happycaptcha reload | test | status, права — happyfilter.bypass и happyfilter.admin.
Кстати, если не хочется возиться с ручной установкой плагинов и зависимостей, обратите внимание на лаунчер foxygame.net: там дополнения вроде Happy Filter ставятся в один клик прямо из каталога, а версии подбираются автоматически под ваш сервер.
Что нужно для установки
Happy Filter — это BETA-версия, поэтому важно учесть пару моментов. Для работы нужны backend-сервер капчи, лобби и прокси, а в конфиге режим mode: PROXY. Координаты сундука, воронки и шалкера берутся из вашего мира в config.yml.
Обязательно скачайте сам мир капчи — без него плагин не заработает. Его нужно положить в папку plugins\HappyFilterCaptcha\. Полная документация доступна на русском языке, там же расписаны все тонкости настройки.
Как установить Happy Filter
Процесс установки выглядит так:
- Скачайте Happy Filter для Minecraft и поместите jar-файл в папку plugins вашего прокси-сервера.
- Загрузите мир капчи и распакуйте его в plugins\HappyFilterCaptcha\.
- Настройте config.yml: укажите координаты сундука, воронки и шалкера из вашего мира.
- Проверьте messages.yml — при желании переведите тексты под свой сервер.
- Запустите сервер и выполните /happycaptcha test для проверки.
Если что-то не работает, команда /happycaptcha status покажет текущее состояние, а errors.log подскажет, где именно возникла проблема.
Стоит ли ставить Happy Filter
Если ваш сервер страдает от бот-атак, Happy Filter — одно из самых изящных решений. Он не требует от игроков вводить капчу, не ломает погружение и при этом надёжно отсеивает автоматизированные подключения. Живой игрок проходит квест за считаные секунды, а бот застревает на первом же шаге. Учитывая поддержку актуальных версий Minecraft и работу через BungeeCord и Velocity, плагин легко вписывается в инфраструктуру большинства проектов. Главное — не забудьте скачать мир капчи, иначе чуда не случится.