Что такое OnlineMC и зачем нужен API для списка игроков
В мире Minecraft-серверов часто возникает потребность выводить информацию об онлайне за пределы игры — например, на сайт, в Discord или в стороннее приложение. Плагин OnlineMC решает эту задачу элегантно и минималистично: он создаёт простой HTTP API, который возвращает актуальный список игроков в формате JSON. Никаких сложных конфигураций, баз данных или прав — достаточно открыть нужный порт, и данные становятся доступны любому внешнему сервису.
Изначально плагин разрабатывался для интеграции с Discord-ботом, чтобы участники сервера могли видеть, кто сейчас в игре, не заходя в Minecraft. Однако гибкость решения позволяет использовать его в любых проектах: от веб-виджетов до систем мониторинга. Если вам нужен лёгкий способ получить список игроков через HTTP — OnlineMC станет отличным выбором.
Как работает API OnlineMC
После установки плагина на сервер он начинает слушать порт 11235. При обращении по адресу http://<ip-сервера>:11235/mconline/ клиент получает JSON-массив с никами игроков, находящихся в сети. Никаких дополнительных параметров передавать не нужно — запрос максимально прост. Ответ выглядит примерно так:
["Notch", "Herobrine", "jeb_"]Этот формат идеально подходит для парсинга в любых языках программирования. Вы можете использовать его в своих Discord-ботах, веб-приложениях или системах мониторинга. Плагин не требует настройки эндпоинтов или ключей доступа — всё работает «из коробки» после запуска.
Установка и настройка порта
Для работы OnlineMC необходимо открыть порт 11235 в настройках хостинга или файрвола. Это единственное техническое требование. Сам плагин устанавливается как обычный jar-файл в папку plugins вашего сервера. После перезапуска он автоматически начинает слушать указанный порт. Если вы используете хостинг с панелью управления, убедитесь, что порт не заблокирован провайдером — иногда требуется явно указать его в списке разрешённых.
Кстати, если вы предпочитаете управлять модами и плагинами через удобный лаунчер, обратите внимание на foxygame.net. Этот современный лаунчер для Minecraft позволяет скачивать и устанавливать моды прямо из меню, а гибкая система сборок делает процесс настройки сервера или клиента максимально простым. С ним даже начинающий администратор легко справится с добавлением OnlineMC и других полезных расширений.
Интеграция с Discord и другими сервисами
Основной сценарий использования OnlineMC — отображение онлайна в Discord-канале. Бот может периодически опрашивать API и обновлять сообщение со списком игроков. Это даёт участникам сообщества возможность быстро оценить активность на сервере, не запуская игру. Реализовать такого бота можно на Python, JavaScript или любом другом языке, умеющем отправлять HTTP-запросы и работать с Discord API.
Пример простейшего кода на Python:
- Отправить GET-запрос к
http://<ip>:11235/mconline/ - Распарсить JSON-ответ
- Сформировать читаемое сообщение и отправить в Discord через вебхук или бота
Благодаря отсутствию авторизации, интеграция становится тривиальной. Однако помните о безопасности: если ваш сервер находится в публичной сети, любой сможет получить список игроков. В большинстве случаев это не критично, но для закрытых проектов стоит ограничить доступ к порту по IP.
Совместимость с плагинами на имена и невидимость
Одна из сильных сторон OnlineMC — корректная работа с популярными плагинами, изменяющими отображение игроков. Если на сервере установлен SuperVanish или аналоги, скрытые администраторы не попадут в выдачу API. Это важно для сохранения конфиденциальности персонала и предотвращения утечки информации о присутствии модераторов.
Кроме того, плагин учитывает кастомизированные ники. Если другой плагин (например, LuckPerms или любой префикс-менеджер) добавляет к имени теги вроде [Admin], OnlineMC вернёт именно то имя, которое видят другие игроки в табе. Таким образом, в Discord-боте вы увидите не технический ник, а полное отображаемое имя — [Admin] SuperPlayer. Это делает API более информативным и удобным для конечных пользователей.
Технические детали и формат ответа
API имеет единственную точку входа: /mconline/. Никаких аргументов не требуется. Ответ всегда приходит в виде JSON-массива строк. Если сервер пуст, вернётся пустой массив []. Кодировка — UTF-8, что гарантирует корректное отображение ников с кириллицей или спецсимволами.
Плагин написан с расчётом на минимальную нагрузку. Он не создаёт лишних потоков и не кеширует данные агрессивно — каждый запрос получает актуальный список непосредственно из ядра сервера. Это исключает рассинхронизацию между реальным онлайном и ответом API.
Возможные проблемы и их решение
- Порт 11235 занят. Если на сервере уже используется этот порт, измените его в конфигурации плагина (файл
config.yml). - Брандмауэр блокирует подключения. Убедитесь, что порт открыт для входящих TCP-соединений. На VDS-серверах часто требуется ручная настройка iptables.
- Неверный IP. API доступен только по тому IP, который слушает Minecraft-сервер. При использовании локального хоста указывайте
127.0.0.1. - Плагин не загружается. Проверьте совместимость с версией ядра сервера. OnlineMC поддерживает большинство современных сборок Spigot, Paper и их форков.
Практическое применение: от Discord до веб-виджетов
Помимо классической связки с Discord, API OnlineMC открывает дорогу для множества других идей. Вы можете встроить список игроков на сайт вашего проекта через простой JavaScript-запрос и отображать его в реальном времени. Или использовать данные для системы автоматических уведомлений: например, отправлять сообщение в Telegram, когда на сервер заходит определённый игрок. Возможности ограничены лишь вашей фантазией и навыками программирования.
Для тех, кто только начинает погружаться в мир серверных плагинов, OnlineMC станет отличным примером того, как небольшие инструменты могут значительно расширить функциональность проекта. А благодаря лаунчеру foxygame.net, где можно быстро собрать нужную конфигурацию модов и плагинов, процесс внедрения становится ещё доступнее — вы просто выбираете OnlineMC из каталога и запускаете сервер.
Заключение
OnlineMC — это узкоспециализированный, но крайне полезный плагин для владельцев Minecraft-серверов, желающих вывести информацию об онлайне во внешние сервисы. Простота API, совместимость с плагинами невидимости и кастомизации имён, а также минимальные требования к настройке делают его идеальным решением для Discord-интеграций и не только. Если вам нужен прозрачный и надёжный способ получать список игроков через HTTP, обязательно попробуйте OnlineMC на своём сервере.