MCRest: REST API для управления сервером Minecraft
В мире серверов Minecraft автоматизация и удалённое управление становятся всё более востребованными. Плагин MCRest предлагает элегантное решение — встроенный HTTP-сервер, который превращает ваш Bukkit-сервер в полноценный RESTful API. С его помощью можно получать данные об игроках, мирах и чате, а также выполнять административные задачи через простые HTTP-запросы. Это открывает широкие возможности для интеграции с веб-панелями, ботами и внешними сервисами.
Что такое MCRest и как он работает
MCRest — это плагин для серверов на базе Bukkit (CraftBukkit, Spigot и их производных), который запускает внутри серверного процесса легковесный HTTP-сервер. После установки и старта сервера плагин начинает прослушивать заданный порт и обрабатывать запросы по определённым маршрутам. В ответах возвращаются структурированные JSON-данные, что делает взаимодействие удобным для любых современных инструментов.
При активации плагина в консоли появляются характерные сообщения:
- Уведомление о включении McREST.
- Запуск внутреннего HTTP-сервера на порту 8281 (по умолчанию).
- Подтверждение успешного старта и адрес прослушивания:
0.0.0.0:8281/mcrest.
Установка и настройка
Плагин устанавливается как обычный Bukkit-плагин: файл McRest.jar помещается в папку plugins сервера. После перезапуска или выполнения команды reload он автоматически создаёт конфигурационный файл, где можно изменить порт, префикс URL и параметры аутентификации. Кстати, для тех, кто предпочитает удобные лаунчеры с гибкой системой управления модами, foxygame.net позволяет быстро собрать серверную сборку с нужными плагинами и загрузить их прямо из интерфейса — это экономит время и избавляет от ручного копирования файлов.
Конфигурация
Файл настроек содержит несколько ключевых параметров:
- port — порт, на котором плагин принимает HTTP-запросы (по умолчанию 8281).
- prefix — префикс URL, определяющий базовый путь API (по умолчанию
mcrest). - auth — секция для включения аутентификации. Если
enable: true, доступ к указанным вprotectedэндпоинтам потребует логина и пароля.
Пример конфигурации:
port: 8281 prefix: mcrest auth: enable: false user: mcrest password: mcrest protected: - / - /player - /world
Основные API-эндпоинты
Плагин предоставляет несколько маршрутов для получения информации о сервере. Все запросы выполняются методом GET, а ответы приходят в формате JSON.
Информация об игроках
Эндпоинт /player возвращает список всех игроков, когда-либо заходивших на сервер. Для каждого указываются имя, уникальный идентификатор (UUID), статус онлайн, наличие в белом списке, бане и дата первого входа. Пример запроса:
GET /mcrest/player— полный список игроков.GET /mcrest/player/<имя>— данные конкретного игрока по нику.GET /mcrest/player/<uuid>— поиск по UUID.
Ответ сервера выглядит примерно так:
[
{
"name": "Maeksein",
"uniqueId": "efc3d000-119c-4923-afcd-cb6ffafaaf08",
"online": false,
"whitelisted": false,
"banned": false,
"firstPlayed": 1426216252338
}
]
Информация о мирах
Эндпоинт /world возвращает массив миров с их настройками: разрешены ли животные и монстры, список активных игровых правил (game rules), название мира и список игроков, находящихся в нём в данный момент. Это удобно для мониторинга состояния миров и автоматического сбора статистики.
Чат и сервер
Через /chat можно получить последние сообщения чата. По умолчанию возвращаются 100 последних строк, но параметр /chat/<число> позволяет указать нужное количество. Эндпоинт /server предоставляет общую информацию о сервере, а /whitelist — список игроков в белом списке.
Аутентификация и безопасность
По умолчанию аутентификация отключена, что подходит для локальной разработки. Однако при открытии API во внешнюю сеть настоятельно рекомендуется включить защиту. В конфигурации можно задать логин и пароль, а также перечислить защищаемые эндпоинты. Плагин использует базовую HTTP-аутентификацию, поэтому запросы должны содержать заголовок Authorization.
Примеры использования
С помощью MCRest можно легко интегрировать сервер Minecraft в системы мониторинга или веб-интерфейсы. Например, curl-запрос curl -X GET http://127.0.0.1:8281/mcrest/world вернёт JSON с информацией о всех мирах. Это позволяет строить дашборды, отслеживать онлайновых игроков или автоматически публиковать статистику в Discord-канал через бота.
Благодаря REST-архитектуре плагин не зависит от языка программирования клиента: вы можете использовать Python, JavaScript, PHP или любой другой инструмент, способный отправлять HTTP-запросы. Это делает MCRest универсальным мостом между сервером Minecraft и внешним миром.
Заключение
MCRest — это компактный, но мощный инструмент для администраторов, которые хотят вывести управление сервером на новый уровень. Простота настройки, читаемые JSON-ответы и поддержка аутентификации делают его отличным выбором для проектов любой сложности. Если вы стремитесь к автоматизации, мониторингу или созданию собственных веб-панелей, этот плагин определённо заслуживает внимания. Установите его, настройте порт и префикс, и ваш Bukkit-сервер станет частью современной API-экосистемы.