HuHoBot

# HuHoBot Mod Adapter (https://img.shields.io/github/v/release/HuHoBot/ArchitecturyAdapter?style=for-the-badge)](https://github.com/HuHoBot/ArchitecturyAdapter/releases) (https://img.shields.io/github/license/HuHoBot/ArchitecturyAdapter?style=for-the-badge)](https://github.com/HuHoBot/ArchitecturyAdapter/blob/main/LICENSE) (https://img.shields.io/github/actions/workflow/status/HuHoBot/ArchitecturyAdapter/build.yml?style=for-the-badge)](https://github.com/HuHoBot/ArchitecturyAdapter/actions) (https://github.com/HuHoBot/ArchitecturyAdapter/) **This Mod/Plugin is only applicable to users who use Tencent QQ in the China region.** A new-generation Minecraft server management bot solution, breaking through the limitations of traditional bot frameworks to provide a safer and more stable interactive experience. ## 🌟 Core Advantages | Feature | Traditional Solutions | HuHoBot | |---------|----------------------|---------| | Account Security | ❌ Requires real QQ account, risk of ban | ✅ No QQ third-party client dependency, zero risk control | | Deployment Complexity | ❌ Requires setting up complete bot framework | ✅ Ready to use out of the box, one-click binding | | Server Compatibility | ❌ Some panel servers not supported | ✅ Full platform compatibility, works with internet connection | | Protocol Update Impact | ❌ Frequent adaptation to new protocols required | ✅ Protocol-independent design, relatively stable | ## 🚀 Features ### Core Functions - **Seamless Binding**: Instant server and control terminal binding via WebSocket - **Cross-Platform Support**: Adapted for Fabric - **Smart Risk Control Avoidance**: Event-driven non-intrusive communication protocol ### Feature List <details> <summary>📜 Click to View</summary> | Command | Description | |---------|-------------| | /添加白名单 | Add a player to the server whitelist | | /删除白名单 | Remove a player from the server whitelist | | /绑定 | Bind the server | | /设置名称 | Set your name for group-server communication in this group | | /发信息 | Send messages from group to server communication | | /执行命令 | Send command execution request to the server | | /查白名单 | Query the server's built-in whitelist | | /查在线 | Query the server's online player list | | /在线服务器 | Query online servers | | /执行 | Execute custom commands | | /管理员执行 | Run custom content as administrator | </details> ### Advanced Features - **Extended API** - Custom command system (see below for details) ## 📥 Installation Guide ### Requirements - Java 17+ Runtime - **Any supported Fabric core** (including but not limited to versions 1.16+) ### Quick Start 1. **Visit GitHub Releases Page**: - Open your browser and go to (https://github.com/HuHoBot/KotlinMergeAdapter/releases) - Download the latest version of the `huhobot-vx.x.x-mcx.x.x-SNAPSHOT` file 2. **Place Plugin File**: - Put the downloaded `huhobot-vx.x.x-mcx.x.x-SNAPSHOT` file for the corresponding MC version into your server's `mods` directory 3. **Restart Server**: - Restart your Minecraft server to load the new plugin 4. **Add the Bot** - (http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=N6tVRxGR8sDwYHBx9YgAhkqRTp1gseyk&authKey=M7Fd3Op6nHjXjSXefBtHBPqIq2wtX8AfufZor9DrfRrJkhyS2rohkt7iuOSwbtn8&noverify=0&group_code=1005746321), click on HuHo_Bot's avatar and add it to the group chat 5. **Complete Binding**: - Follow the console prompts to complete the server and bot binding operation ### Advanced Configuration (Optional) - For custom functionality, please refer to `⚙️ Configuration Example` for detailed settings --- #### Notes: - Ensure the server has Java 17+ runtime environment properly installed - The plugin is compatible with all supported Fabric core versions. If no corresponding version is available, please compile the Mod yourself (see documentation for specific methods) ## ⚙️ Configuration Example ```yaml #Don't modify serverId: null #Don't modify hashKey: null chatFormat: from_game: "<{name}> {msg}" #Text when in-game messages are forwarded to the group from_group: "Group:<{nick}> {msg}" #Text when group messages are forwarded to the game post_chat: true #Whether to send messages from the group to the server post_prefix: "" #Prefix for group messages forwarded to the game motd: server_ip: "play.hypixel.net" #Motd image address when using "/查在线" (change to your server address) server_port: 25565 #Motd image port when using "/查在线" (change to your server port) api: "https://motdbe.blackbe.work/status_img/java?host={server_ip}:{server_port}" #Motd image address API when using "/查在线" (do not modify unless necessary) (must return an image) text: "Total {online} players online" #Motd text when using "/查在线", supports PlaceholderAPI, leave empty to not display output_online_list: true #Whether to display online list post_img: true #Whether to display Motd image whiteList: add: "whitelist add {name}" #Com