QueQiao

QueQiao - это мод/плагин для Minecraft, который решает проблему связи между сервером и внешними приложениями. Если ты когда-нибудь хотел, чтобы чат из игры дублировался в Discord, или чтобы бот мог отправлять сообщения игрокам, или чтобы стримерский оверлей показывал смерти и достижения - QueQiao как раз для этого.

По сути, это мост между сервером Майнкрафт и любым внешним софтом через WebSocket. Всё общение идет в формате JSON, так что интегрировать можно с чем угодно - от чат-ботов до дашбордов для админов.

Что умеет QueQiao

Мод работает в обе стороны: он и отправляет события наружу, и принимает команды извне.

События, которые транслируются с сервера:

• Player Chat - сообщения игроков в чате
• Player Command - выполненные команды
• Player Death - смерть игрока (не работает на Velocity)
• Player Join - вход на сервер
• Player Quit - выход с сервера
• Player Advancement(Achievement) - получение достижений

Команды, которые можно отправить на сервер:

• Broadcast - отправить сообщение всем игрокам
• PrivateMessage - личное сообщение конкретному игроку
• Title & SubTitle - показать титры
• ActionBar - сообщение в экшн-баре
• Rcon Command - выполнить любую Rcon-команду

Как это работает на практике

Допустим, ты админишь сервер и хочешь, чтобы в Discord канале отображались все смерти игроков. Ставишь QueQiao на сервер, настраиваешь WebSocket, пишешь небольшого бота (или используешь готовые интеграции) - и готово. Или наоборот: хочешь отправлять игрокам сообщения через бота в Telegram - тоже без проблем.

Быстрый старт

1. Установи мод/плагин на сервер (Fabric, Forge, NeoForge, Quilt, Bukkit/Spigot/Paper - поддерживаются все популярные платформы)
2. В файле config.yml включи WebSocket сервер:
   • enable: true
   • host: "127.0.0.1"
   • port: 8080
3. Запусти сервер и дождись инициализации WebSocket
4. Подключайся через API-клиенты или готовые интеграции
5. В заголовках запроса обязательно укажи:

   {
     "x-self-name": "TestServer", // имя сервера из конфига
     "Authorization": "Bearer 123" // токен доступа (если задан)
   }
   

6. Заходи в игру и тестируй

Готовые интеграции

Для популярных бот-платформ уже есть готовые решения:

• @17TheWord/nonebot-adapter-minecraft - адаптер для NoneBot2
• @17TheWord/nonebot-plugin-mcqq - плагин для NoneBot2
• @CikeyQi/mc-plugin - плагин для YunZai
• @Twiyan0/koishi-plugin-minecraft-sync-msg - плагин для Koishi
• @17TheWord/zerobot-plugin-mcqq - плагин для ZeroBot
• @kterna/astrbot_plugin_mcqq - плагин для AstrBot
• @KroMiose/nekro-agent - AI-агент

Есть также реализация для MCDR от @kterna/queqiao_mcdr, если используешь MCDReforged.

Совместимость с ChatImage

QueQiao дружит с модом ChatImage от @kitUIN - можно отображать картинки прямо в чате Майнкрафт.

Важно знать

Если не нашел подходящей версии мода/плагина под свою платформу - смело создавай Issue на GitHub. Автор открыт к предложениям.

Лицензия MIT, так что можно использовать где угодно.

Скачай QueQiao и свяжи свой сервер Minecraft с внешним миром без лишнего геморроя.