# HuHoBot Mod Adapter<\/p>\n
\n
\n<\/p>\n
\u7b80\u4f53\u4e2d\u6587<\/p>\n
**This Mod\/Plugin is only applicable to users who use Tencent QQ in the China region.**<\/p>\n
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.<\/p>\n
## \ud83c\udf1f Core Advantages<\/p>\n
| Feature | Traditional Solutions | HuHoBot |
\n|———|———————-|———|
\n| Account Security | \u274c Requires real QQ account, risk of ban | \u2705 No QQ third-party client dependency, zero risk control |
\n| Deployment Complexity | \u274c Requires setting up complete bot framework | \u2705 Ready to use out of the box, one-click binding |
\n| Server Compatibility | \u274c Some panel servers not supported | \u2705 Full platform compatibility, works with internet connection |
\n| Protocol Update Impact | \u274c Frequent adaptation to new protocols required | \u2705 Protocol-independent design, relatively stable |<\/p>\n
## \ud83d\ude80 Features<\/p>\n
### Core Functions<\/p>\n
– **Seamless Binding**: Instant server and control terminal binding via WebSocket
\n– **Cross-Platform Support**: Adapted for Fabric
\n– **Smart Risk Control Avoidance**: Event-driven non-intrusive communication protocol<\/p>\n
### Feature List<\/p>\n | Command | Description | ### Advanced Features<\/p>\n – **Extended API** ## \ud83d\udce5 Installation Guide<\/p>\n ### Requirements<\/p>\n – Java 17+ Runtime ### Quick Start<\/p>\n 1. **Visit GitHub Releases Page**: 2. **Place Plugin File**: 3. **Restart Server**: 4. **Add the Bot** 5. **Complete Binding**: ### Advanced Configuration (Optional)<\/p>\n – For custom functionality, please refer to `\u2699\ufe0f Configuration Example` for detailed settings<\/p>\n —<\/p>\n #### Notes:<\/p>\n – Ensure the server has Java 17+ runtime environment properly installed ## \u2699\ufe0f Configuration Example<\/p>\n “`yaml chatFormat: motd: whiteList: #Custom execution commands – key: “\u7ba1\u7406\u52a0\u767d\u540d” ## \u2753 Frequently Asked Questions<\/p>\n Completely unnecessary! This solution adopts a brand-new communication protocol, completely eliminating dependency on third-party chat platforms. \u2705 Tested versions: 1.16 – 1.21 <\/p>\n \u2705 Theoretically supports all Fabric-based cores Supports hot-reloading configuration: When using `\/\u53d1\u4fe1\u606f`, you can `reply to that message 5 times` within `five minutes`, the bot will prioritize the latest message for reply Please modify the Troubleshooting steps: <\/p>\n 1. Check connection status, use 2. Try clearing the motdUrl field: Note the difference in command formats: <\/p>\n – – Please configure the customCommand field as shown in the configuration example above<\/p>\n Usage: Use commands in the group: Current version supports binding only one server per group, multi-server binding feature is under development ### Configuring Custom Commands<\/p>\n #### Via Configuration File<\/p>\n In the `config.yml` file, you can define custom commands through the `customCommand` field. Each custom command contains the following attributes:<\/p>\n – **key**: Trigger keyword for the command (string) Example configuration:<\/p>\n “`yaml – key: “\u7ba1\u7406\u52a0\u767d\u540d” #### View Development Documentation<\/p>\n If you need more detailed development guides and advanced features, please refer to the [Development Documentation](docs\/develop.md).<\/p>\n ## \ud83d\udcc4 Open Source License<\/p>\n [GNU General Public License v3.0](LICENSE) – Free to use, modify and distribute, but must comply with the following terms:<\/p>\n – **Open Source Obligation**: Any derivative works must remain open source For the complete license text, please see the [LICENSE](LICENSE) file<\/p>\n ## \ud83e\udd1d Contributing<\/p>\n Welcome to submit PRs or make suggestions via Discussions<\/p>\n","protected":false},"excerpt":{"rendered":" HuHoBot for Forge,Fabric,NeoForge enabling the official QQ bot to connect to your server.<\/p>\n","protected":false},"featured_media":82656,"template":"","meta":{"_minecraft_slug":"huhobot-mod","_minecraft_project_id":"pM02OyLL","_minecraft_author":"HuoHuas001","_minecraft_license":"LGPL-3.0-or-later","_minecraft_downloads":868,"_minecraft_follows":6,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"huhobot-mod.zip","_minecraft_size_bytes":20671439,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T19:11:42.090287Z","_minecraft_date_created":"2025-09-30T00:43:28.000482Z","_minecraft_date_modified":"2025-12-31T18:49:24.023558Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/huhobot-mod","_minecraft_icon_attachment_id":82656,"_minecraft_imported_at":"2026-06-04T17:45:50+00:00","_minecraft_import_hash":"3b5529c568a3e6ebf8cfa625499f7536","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,126,158],"mod_loader":[99],"minecraft_version":[36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-82655","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-management","mod_category-neoforge","mod_loader-fabric","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n\ud83d\udcdc Click to View<\/summary>\n
\n|———|————-|
\n| \/\u6dfb\u52a0\u767d\u540d\u5355 | Add a player to the server whitelist |
\n| \/\u5220\u9664\u767d\u540d\u5355 | Remove a player from the server whitelist |
\n| \/\u7ed1\u5b9a | Bind the server |
\n| \/\u8bbe\u7f6e\u540d\u79f0 | Set your name for group-server communication in this group |
\n| \/\u53d1\u4fe1\u606f | Send messages from group to server communication |
\n| \/\u6267\u884c\u547d\u4ee4 | Send command execution request to the server |
\n| \/\u67e5\u767d\u540d\u5355 | Query the server’s built-in whitelist |
\n| \/\u67e5\u5728\u7ebf | Query the server’s online player list |
\n| \/\u5728\u7ebf\u670d\u52a1\u5668 | Query online servers |
\n| \/\u6267\u884c | Execute custom commands |
\n| \/\u7ba1\u7406\u5458\u6267\u884c | Run custom content as administrator |<\/p>\n<\/details>\n
\n – Custom command system (see below for details)<\/p>\n
\n– **Any supported Fabric core** (including but not limited to versions 1.16+)<\/p>\n
\n – Open your browser and go to HuHoBot Releases
\n – Download the latest version of the `huhobot-vx.x.x-mcx.x.x-SNAPSHOT` file<\/p>\n
\n – Put the downloaded `huhobot-vx.x.x-mcx.x.x-SNAPSHOT` file for the corresponding MC version into your server’s `mods` directory<\/p>\n
\n – Restart your Minecraft server to load the new plugin<\/p>\n
\n – Join the community group, click on HuHo_Bot’s avatar and add it to the group chat<\/p>\n
\n – Follow the console prompts to complete the server and bot binding operation<\/p>\n
\n– 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)<\/p>\n
\n#Don’t modify
\nserverId: null
\n#Don’t modify
\nhashKey: null<\/p>\n
\n from_game: “<{name}> {msg}” #Text when in-game messages are forwarded to the group
\n from_group: “Group:<{nick}> {msg}” #Text when group messages are forwarded to the game
\n post_chat: true #Whether to send messages from the group to the server
\n post_prefix: “” #Prefix for group messages forwarded to the game<\/p>\n
\n server_ip: “play.hypixel.net” #Motd image address when using “\/\u67e5\u5728\u7ebf” (change to your server address)
\n server_port: 25565 #Motd image port when using “\/\u67e5\u5728\u7ebf” (change to your server port)
\n api: “https:\/\/motdbe.blackbe.work\/status_img\/java?host={server_ip}:{server_port}” #Motd image address API when using “\/\u67e5\u5728\u7ebf” (do not modify unless necessary) (must return an image)
\n text: “Total {online} players online” #Motd text when using “\/\u67e5\u5728\u7ebf”, supports PlaceholderAPI, leave empty to not display
\n output_online_list: true #Whether to display online list
\n post_img: true #Whether to display Motd image<\/p>\n
\n add: “whitelist add {name}” #Command to add to whitelist
\n del: “whitelist remove {name}” #Command to remove from whitelist<\/p>\n
\ncustomCommand:
\n – key: “\u52a0\u767d\u540d” #Execution keyword, use “\/\u6267\u884c keyword parameter1 parameter2” to execute custom commands
\n command: “whitelist add &1” #&1 is parameter placeholder, first parameter is &1, second is &2, and so on
\n permission: 0 #0 is normal permission, greater than 0 is administrator permission<\/p>\n
\n command: “whitelist add &1”
\n permission: 1
\n“`<\/p>\n\ud83e\udd14 Do I need to prepare a QQ account?<\/summary>\n
\n<\/details>\n\ud83d\udee1\ufe0f Which server versions are supported?<\/summary>\n
\n<\/details>\n\ud83d\udd27 How to update configuration?<\/summary>\n
\/huhobot reload<\/code>
\n<\/details>\n\ud83d\udcac About Group-Server Message Intercommunication<\/summary>\n
\n
\nIf no replyable message is found, messages cannot be sent
\n<\/details>\n\ud83c\udf10 Query online shows other server information?<\/summary>\n
motdUrl<\/code> field in the configuration file to your server address
\nExample: motdUrl: \"play.yourserver.com:25565\"<\/code>
\n<\/details>\n\ud83d\udd0d What to do if query online has no response?<\/summary>\n
\/huhobot reconnect<\/code> to reconnect<\/p>\n\"motdUrl\": \"\"<\/code>
\n<\/details>\n\u2328\ufe0f No response when executing commands?<\/summary>\n
\/\u6267\u884c \u52a0\u767d<\/code> \u2192 Used for custom command callbacks<\/p>\n\/\u6267\u884c\u547d\u4ee4 list<\/code> \u2192 Sends commands to the console
\n<\/details>\n\ud83d\udc65 Allow players to self-add to whitelist?<\/summary>\n
\/\u6267\u884c \u52a0\u767d \"PlayerID\"<\/code> (parameters with spaces need quotes)
\n<\/details>\n\ud83d\udc6e How to set up administrators?<\/summary>\n
\n\/\u7ba1\u7406\u5e2e\u52a9<\/code> \u2192 View administrator command list
\n<\/details>\n\ud83c\udff0 Does it support multiple servers?<\/summary>\n
\nIf you need to manage multiple servers, it’s recommended to create separate groups for each server
\n<\/details>\n
\n– **command**: Actual server command to execute (string)
\n– **permission**: Permission level (integer)<\/p>\n
\ncustomCommand:
\n – key: “\u52a0\u767d\u540d” #Execution keyword, use “\/\u6267\u884c keyword parameter1 parameter2” to execute custom commands
\n command: “whitelist add &1” #&1 is parameter placeholder, first parameter is &1, second is &2, and so on
\n permission: 0 #0 is normal permission, greater than 0 is administrator permission<\/p>\n
\n command: “whitelist add &1”
\n permission: 1
\n“`<\/p>\n
\n– **Same License**: Modified versions must use the same license
\n– **Copyright Notice**: Must retain original copyright notice<\/p>\n