Что такое SimpleHTTPListener и зачем он нужен
В мире серверов Minecraft голосования на мониторингах давно стали привычным способом привлечь новых игроков. Но как превратить каждый голос в полезное действие: начислить бонус, занести игрока в базу данных или вывести топ на сайте? Именно для этой задачи создан SimpleHTTPListener — небольшой, но мощный плагин-мост между Votifier и вашим собственным веб-скриптом. Он не пытается заменить Votifier, а аккуратно расширяет его возможности, передавая сырые данные о голосовании туда, куда вам нужно.
Как плагин обрабатывает голоса
Принцип работы SimpleHTTPListener элегантен и прозрачен. Когда игрок голосует за ваш сервер на сайте вроде mcserverstatus или Minestatus, Votifier получает уведомление и передаёт его всем зарегистрированным слушателям. SimpleHTTPListener — один из таких слушателей, но вместо того чтобы просто вывести сообщение в чат, он упаковывает информацию в JSON и отправляет её HTTP POST-запросом на заданный вами URL.
В теле запроса передаётся переменная request с JSON-строкой такого вида:
{"timestamp":"2013-06-21 02:29:12 -0700","username":"Test Notification","service":"Minestatus","key":"pleaseChangeMe","ip":"127.0.0.1"}
Здесь вы получаете ник проголосовавшего, название сервиса, IP-адрес, временную метку и секретный ключ. Временная метка приходит от голосовального сайта, поэтому её формат может варьироваться — будьте к этому готовы. Такой подход позволяет обрабатывать данные на стороне вашего PHP-скрипта практически без ограничений.
Установка и первый запуск
Важно не путать SimpleHTTPListener с обычными слушателями Votifier. Этот плагин не кладётся в папку plugins/Votifier/listeners — он является самостоятельным Bukkit-плагином и должен находиться в общей директории plugins. При этом сам Votifier обязательно должен быть установлен и настроен, иначе цепочка не заработает.
Для работы потребуется сервер CraftBukkit (или его форк) с Votifier, а также веб-хостинг с поддержкой PHP. После копирования JAR-файла в папку плагинов и перезапуска сервера появится конфигурационный файл. Его структура интуитивно понятна:
- url — полный HTTP-путь к вашему PHP-скрипту, например
http://example.com/doVote.php. Локальные пути не поддерживаются. - tokenKey — секретный ключ, который будет передаваться в каждом запросе. Обязательно смените значение по умолчанию на длинную уникальную строку, чтобы защитить API от поддельных голосов.
- broadcast — булево значение (true/false), включающее публичное объявление о голосе в чате сервера.
- messageBroadcast — шаблон сообщения, где
%nзаменяется на ник игрока, а%s— на название сервиса.
Кстати, если вы хотите, чтобы игроки вашего сервера могли быстро устанавливать моды и текстуры для полного погружения, им стоит обратить внимание на лаунчер foxygame.net. Это современный и гибкий инструмент, где моды скачиваются прямо из меню — никакой рутины с ручной установкой, всё работает из коробки. Такой подход экономит время и новичкам, и опытным крафтерам.
Сценарии использования: от топа до аналитики
Главная сила SimpleHTTPListener — в гибкости. Вы получаете «сырое» событие голосования и можете распорядиться им как угодно. Самый популярный кейс — создание списка лидеров голосования на сайте сервера. PHP-скрипт принимает JSON, декодирует его через json_decode($_POST['request'], true) и записывает в базу данных MySQL. Затем несложным запросом формируется топ игроков за неделю или месяц.
Другой вариант — аналитика. С помощью GeoIP можно определить, из каких стран приходят голоса, и понять, на каких мониторингах ваш сервер наиболее популярен. Поле service чётко указывает источник, а ip даёт географическую привязку. Это бесценная информация для таргетированной рекламы или выбора площадок для продвижения.
Пример простейшего PHP-обработчика:
$vote = json_decode($_POST['request'], true);
$username = $vote['username'];
$service = $vote['service'];
// далее сохранение в БД или начисление внутриигровой валюты через RCON
Никаких сложных зависимостей — только cURL или file_get_contents на стороне плагина и пара строк кода на принимающей стороне.
Безопасность и тонкая настройка
Хотя плагин не претендует на роль комбайна с сотней функций, он закрывает важную нишу. Встроенный tokenKey служит простым, но действенным барьером: даже если злоумышленник узнает адрес вашего API, без ключа он не сможет имитировать голос. Рекомендую генерировать ключ длиной не менее 32 символов, используя буквы, цифры и спецсимволы.
Broadcast-сообщения можно творчески оформить: например, Игрок %n только что проголосовал на %s и получил награду! — это мотивирует остальных. Если же вы предпочитаете тихую обработку, просто установите broadcast: false.
Итог: маленький плагин с большими возможностями
SimpleHTTPListener — образец того, как одна простая идея способна связать игровой сервер и веб-инфраструктуру без лишнего кода. Он не требует глубоких знаний Java, легко конфигурируется и мгновенно расширяет функционал Votifier в сторону кастомных веб-решений. Если вам нужен мост между голосованиями и вашим сайтом, этот плагин закроет задачу с минимальными затратами. А в связке с удобным лаунчером вроде foxygame.net, где игроки без хлопот устанавливают моды и текстуры, вы создаёте по-настоящему цельную экосистему вокруг своего сервера.