HuHoBot Mod Adapter

简体中文

Этот мод/плагин предназначен только для пользователей, использующих Tencent QQ в Китае.

HuHoBot - это новое поколение решений для управления сервером Minecraft через QQ. Он ломает ограничения традиционных ботов и обеспечивает более безопасное и стабильное взаимодействие.

Ключевые преимущества

Особенность	Традиционные решения	HuHoBot
Безопасность аккаунта	Требует реальный QQ аккаунт, риск бана	Не зависит от стороннего клиента QQ, нулевой риск
Сложность настройки	Требуется установка полного фреймворка бота	Работает из коробки, привязка в один клик
Совместимость с серверами	Некоторые панельные серверы не поддерживаются	Полная поддержка любых платформ, работает при наличии интернета
Влияние обновлений протокола	Частая адаптация под новые протоколы	Независимость от протоколов, относительная стабильность

Возможности

Основные функции

• Мгновенная привязка: сервер и управляющий терминал соединяются через WebSocket
• Кроссплатформенность: поддержка Fabric, Forge, NeoForge
• Умный обход рисков: событийно-ориентированный неинтрузивный протокол связи

Список команд

Команда	Описание
/添加白名单	Добавить игрока в белый список сервера
/删除白名单	Удалить игрока из белого списка сервера
/绑定	Привязать сервер
/设置名称	Установить имя для общения группы с сервером в этом чате
/发信息	Отправить сообщение из группы на сервер
/执行命令	Отправить команду на выполнение серверу
/查白名单	Запросить встроенный белый список сервера
/查在线	Запросить список игроков онлайн
/在线服务器	Запросить список онлайн-серверов
/执行	Выполнить пользовательские команды
/管理员执行	Выполнить пользовательские команды от имени администратора

Продвинутые возможности

• Расширенное API: система пользовательских команд (см. пример конфигурации ниже)

Установка

Требования

• Java 17+
• Любой поддерживаемый загрузчик модов (Fabric, Forge, NeoForge) для версий Minecraft 1.16+

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

1. Скачайте мод:

   • Перейдите на страницу релизов HuHoBot (например, на GitHub)
   • Загрузите последнюю версию файла huhobot-vx.x.x-mcx.x.x-SNAPSHOT

2. Поместите файл:

   • Скопируйте скачанный jar-файл в папку mods вашего сервера

3. Перезапустите сервер:

   • Перезапустите Minecraft сервер, чтобы подгрузить мод

4. Добавьте бота:

   • Вступите в сообщество QQ, найдите HuHo_Bot и добавьте его в групповой чат

5. Завершите привязку:

   • Следуйте инструкциям в консоли, чтобы завершить привязку сервера и бота

Дополнительная настройка (опционально)

• Для настройки пользовательских функций смотрите пример конфигурации ниже

---

Примечания:

• Убедитесь, что на сервере установлена Java 17+
• Мод совместим со всеми поддерживаемыми версиями загрузчика. Если нужной версии нет, можно собрать мод самостоятельно

Пример конфигурации

#Не изменять
serverId: null
#Не изменять
hashKey: null

chatFormat: from_game: "<{name}> {msg}" #Текст при пересылке сообщений из игры в группу from_group: "Group:<{nick}> {msg}" #Текст при пересылке сообщений из группы в игру post_chat: true #Отправлять ли сообщения из группы на сервер post_prefix: "" #Префикс для сообщений из группы, пересылаемых в игру

motd: server_ip: "play.hypixel.net" #Адрес сервера для изображения MOTD при использовании "/查在线" (изменить на адрес вашего сервера) server_port: 25565 #Порт сервера для изображения MOTD при использовании "/查在线" (изменить на порт вашего сервера) api: "https://motdbe.blackbe.work/status_img/java?host={server_ip}:{server_port}" #API для изображения MOTD (не менять без необходимости, должен возвращать изображение) text: "Всего {online} игроков онлайн" #Текст MOTD при использовании "/查在线", поддерживает PlaceholderAPI, оставьте пустым, чтобы не отображать output_online_list: true #Отображать ли список онлайн игроков post_img: true #Отображать ли изображение MOTD

whiteList: add: "whitelist add {name}" #Команда для добавления в белый список del: "whitelist remove {name}" #Команда для удаления из белого списка

#Пользовательские команды customCommand:

• key: "加白名" #Ключевое слово, используйте "/执行 ключевое_слово параметр1 параметр2" для выполнения command: "whitelist add &1" #&1 - placeholder для параметра, первый параметр &1, второй &2 и т.д. permission: 0 #0 - обычное разрешение, больше 0 - администраторское

• key: "管理加白名" command: "whitelist add &1" permission: 1

## Часто задаваемые вопросы

**Нужно ли подготавливать QQ аккаунт?**

Совершенно не нужно! Решение использует новый протокол связи, полностью устраняющий зависимость от сторонних платформ.

**Какие версии сервера поддерживаются?**

Протестированные версии: 1.16 - 1.21. Теоретически поддерживаются все версии на Fabric/Forge/NeoForge.

**Как обновить конфигурацию?**

Поддерживается горячая перезагрузка: `/huhobot reload`

**Как работает пересылка сообщений между группой и сервером?**

При использовании `/发信息` можно ответить на это сообщение в течение пяти минут, бот ответит на последнее сообщение. Если нет сообщений для ответа, отправить нельзя.

**Почему при запросе онлайн отображается информация другого сервера?**

Измените поле `motdUrl` в конфиге на адрес вашего сервера. Например: `motdUrl: "play.yourserver.com:25565"`.

**Нет ответа при запросе онлайн?**

Проверьте подключение, используйте `/huhobot reconnect`. Также попробуйте очистить поле `motdUrl`: `"motdUrl": ""`.

**Команды не выполняются?**

Обратите внимание на формат:
- `/执行 加白` используется для вызова пользовательских команд
- `/执行命令 list` отправляет команду в консоль

**Можно ли дать игрокам возможность самим добавляться в белый список?**

Да, настройте поле `customCommand` как в примере конфигурации. Использование: `/执行 加白 "ИмяИгрока"` (параметры с пробелами нужно в кавычках).

**Как настроить администраторов?**

Используйте команду в группе: `/管理帮助` для просмотра списка команд администратора.

**Поддерживается ли несколько серверов?**

Текущая версия поддерживает привязку только одного сервера на группу. Если нужно управлять несколькими серверами, создайте отдельные группы для каждого.

### Настройка пользовательских команд

В файле `config.yml` через поле `customCommand` можно определить свои команды. Каждая команда содержит:
- **key**: ключевое слово (строка)
- **command**: фактическая команда сервера (строка), где &1, &2 - плейсхолдеры параметров
- **permission**: уровень доступа (целое число): 0 - обычный, >0 - администратор

Пример уже есть в конфигурации выше.

---

HuHoBot делает управление сервером через QQ простым и безопасным. Скачайте мод и настройте привязку в несколько шагов.