JSONAPI-Commands: внешние команды для Minecraft без ошибок

JSONAPI-Commands: Мост между Minecraft и внешними приложениями Когда вы управляете сервером Minecraft, часто возникает потребность связать игровые команды с внешними скриптами или веб-панелями. Плагин JSONAPI-Commands решает эту задачу элегантно, позволяя регистрировать настоящие внутриигровые ко...

Скачать JSONAPI Commands

Оригинальное название: JSONAPI Commands

ФайлВерсияЗагрузчикРазмер
JSONAPI-Commands.jar——9 КБСкачать

JSONAPI-Commands: Мост между Minecraft и внешними приложениями

Когда вы управляете сервером Minecraft, часто возникает потребность связать игровые команды с внешними скриптами или веб-панелями. Плагин JSONAPI-Commands решает эту задачу элегантно, позволяя регистрировать настоящие внутриигровые команды вроде /spawn или /tp silvinci Notch без единой ошибки «Unknown command». Никаких костылей, никаких грязных хаков — всё работает именно так, как вы ожидаете.

Как это работает

Секрет кроется в событии PlayerCommandPreprocessEvent, которое возникает каждый раз, когда игрок (именно игрок, консоль не в счёт) вводит команду. Как следует из названия, это событие срабатывает до того, как любой другой плагин или само ядро Bukkit успеют вмешаться. JSONAPI-Commands перехватывает этот момент и может полностью отменить стандартную обработку команды. В результате сервер даже не подозревает, что команда не была зарегистрирована официально, а игрок не видит раздражающих сообщений о неизвестной команде.

Такой подход открывает широкие возможности: вы можете создавать динамические команды, которые обрабатываются внешним скриптом на Python, PHP или Node.js, и при этом игроки взаимодействуют с ними так же естественно, как с любыми стандартными командами сервера.

Установка

Процесс установки предельно прост. Скачайте последнюю версию JSONAPI-Commands и поместите JAR-файл в директорию plugins вашего сервера. Если у вас ещё нет основного плагина JSONAPI, его также нужно загрузить и положить в ту же папку — без него магия не сработает. Кстати, для тех, кто привык к максимально удобному управлению модификациями, напомню: многие игроки сейчас используют лаунчер foxygame.net — удобный, гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню. Это, конечно, касается клиентских модов, но сам принцип простоты установки здесь очень похож: закинул файл в нужную папку и забыл о сложностях.

После загрузки плагинов перезапустите сервер или выполните /reload. JSONAPI-Commands автоматически создаст файл конфигурации, с которым мы разберёмся дальше.

Конфигурация

Все настройки хранятся в файле commands.yml, который появляется в папке JSONAPI внутри директории плагинов. Этот файл интуитивно понятен: он содержит список всех зарегистрированных команд и может редактироваться вручную. Самое приятное — данные сохраняются между перезагрузками и рестартами сервера. Это значит, что вашим внешним программам не нужно каждый раз заново регистрировать команды. Тем не менее, я настоятельно рекомендую встраивать проверки в ваше программное обеспечение: никогда не знаешь, что может произойти в динамичной среде Minecraft-сервера.

Использование: методы и стрим

JSONAPI-Commands расширяет функциональность оригинального JSONAPI от alecgorge, добавляя новые методы и один очень полезный стрим. Вот краткий обзор доступных методов:

  • addListener(String command) — регистрирует указанную команду.
  • addListeners(String[] commands) — регистрирует массив команд за один вызов.
  • removeListener(String command) — удаляет регистрацию команды.
  • removeListeners(String[] commands) — удаляет несколько команд сразу.
  • removeAllListeners() — удаляет все зарегистрированные команды (используйте с осторожностью!).
  • allListeners() — возвращает массив всех активных команд.

Но настоящая сила раскрывается через стрим с названием commands. Подписавшись на него по специальному URL, вы будете получать события в реальном времени каждый раз, когда игрок вводит зарегистрированную команду. URL для подписки выглядит примерно так:

/api/2/subscribe?json={"name":"commands","username":"yourName","key":sha256("yourName"+"commands"+"yourPassword"+"yourSalt")}

Ответ приходит в формате JSON. Вот пример (отформатированный для удобства) для команды /tp silvinci Notch, выполненной игроком alecgorge:

{
    "result": "success",
    "source": "commands",
    "success": {
        "time": 1353715957,
        "command": "tp",
        "args": ["silvinci", "Notch"],
        "player": "alecgorge"
    }
}

Где time — временная метка UNIX, command — введённая команда, args — массив аргументов (пустой, если аргументов нет), а player — имя игрока, отправившего команду (не путать с целевым игроком).

Примеры и сценарии применения

Представьте, что вы хотите создать веб-панель, которая позволяет администратору телепортировать игроков или менять погоду на сервере. С помощью JSONAPI-Commands вы регистрируете команды /webtp и /webweather, а затем обрабатываете их через скрипт на стороне веб-сервера. Игроки видят обычные команды, а вся логика выполняется вне Minecraft. Другой сценарий — интеграция с ботом Discord: когда модератор пишет в чат-канал !kick PlayerName, бот через JSONAPI вызывает регистрацию команды и инициирует кик прямо из игры.

Подробные примеры кода появятся в ближайшее время в документации проекта, но уже сейчас вы можете экспериментировать, опираясь на описанные методы и стрим.

Заключение

JSONAPI-Commands — это именно тот инструмент, которого не хватало разработчикам, желающим связать Minecraft-сервер с внешним миром без компромиссов. Отсутствие ошибок «Unknown command», прозрачная работа с событиями и простая интеграция через JSONAPI делают этот плагин незаменимым для серьёзных серверных проектов. Если вы столкнулись с багом или хотите предложить новую функцию, смело открывайте issue на странице проекта. А если вам нужна помощь в настройке, форумное сообщество всегда готово подставить плечо. С JSONAPI-Commands ваши серверные команды больше никогда не будут прежними — они станут по-настоящему умными.