# HuHoBot Spigot Adapter<\/p>\n
\n
\n<\/p>\n
**This Mod\/Plugin is only applicable to users who use Tencent QQ in the China region.**<\/p>\n
\u7b80\u4f53\u4e2d\u6587<\/p>\n
A next-generation Minecraft server management bot solution that breaks through the limitations of traditional bot frameworks and provides a more secure and stable interactive experience.<\/p>\n
## \ud83c\udf1f Core Advantages<\/p>\n
| Feature | Traditional Solutions | HuHoBot |
\n|———————–|————————————–|————————————–|
\n| Account Security | \u274c Requires a physical QQ account, with risk of account ban | \u2705 No dependency on third-party QQ clients, zero risk control issues |
\n| Deployment Complexity | \u274c Requires setting up a complete bot framework | \u2705 Ready-to-use, one-click binding |
\n| Server Compatibility | \u274c Not supported by some panel servers | \u2705 Cross-platform compatibility, works anywhere with internet |
\n| Protocol Update Impact| \u274c Frequent adaptation to new protocols required | \u2705 Protocol-agnostic design, relatively stable |<\/p>\n
## \ud83d\ude80 Functional Features<\/p>\n
### Core Functions<\/p>\n
– **Seamless Binding**: Instant binding between server and control terminal via WebSocket
\n– **Cross-Platform Support**: Compatible with all Spigot\/Paper versions 1.8+
\n– **Intelligent Risk Control Avoidance**: Event-driven non-intrusive communication protocol
\n– **Folia Support**: Works with Folia server cores<\/p>\n
### Feature List<\/p>\n | Command | Description | ### Advanced Features<\/p>\n – **Extended API** ## \ud83d\udce5 Installation Guide<\/p>\n ### Environment Requirements<\/p>\n – Java 8+ Runtime ### Quick Start<\/p>\n 1. **Visit the GitHub Releases page**: 2. **Place the plugin file**: 3. **Restart the server**: 4. **Add the bot**: 5. **Complete the binding**: ### Advanced Configuration (Optional)<\/p>\n – For customizing features, refer to the `\u2699\ufe0f Configuration Example` below for detailed settings<\/p>\n —<\/p>\n #### Notes:<\/p>\n – Ensure the server has the Java 8+ runtime environment installed correctly ## \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 Not at all! This solution uses an all-new communication protocol, completely eliminating dependencies on third-party chat platforms. \u2705 Tested versions: 1.8 – 1.21 <\/p>\n \u2705 Theoretically supports all Spigot-based cores Configuration hot-reload is supported: When using Please modify the Troubleshooting steps: <\/p>\n 1. Check the connection status and reconnect using 2. Try clearing the motdUrl field: Note the difference in command formats: <\/p>\n – – Configure the Usage: Use the command in the group: The current version only supports binding one server per group. Multi-server binding is under development. ### Configuring Custom Commands<\/p>\n #### Setting via Configuration File<\/p>\n In the `config.yml` file, you can define custom commands through the `customCommand` field. Each custom command includes the following attributes:<\/p>\n – **key**: The keyword to trigger the command (string) Example configuration is as follows:<\/p>\n “`yaml – key: “\u7ba1\u7406\u52a0\u767d\u540d” #### View Development Documentation<\/p>\n For 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 subject to the following terms:<\/p>\n – **Open Source Obligation**: All derivative works must remain open source For the full text of the license, please refer to the [LICENSE](LICENSE) file.<\/p>\n ## \ud83e\udd1d Contributing<\/p>\n Contributions via PR are welcome. You can also submit suggestions through Discussions.<\/p>\n","protected":false},"excerpt":{"rendered":" HuHoBot for Spigot, enabling the official QQ bot to connect to your server.<\/p>\n","protected":false},"featured_media":82656,"template":"","meta":{"_minecraft_slug":"huhobot-spigot","_minecraft_project_id":"Xnw5GoIX","_minecraft_author":"HuoHuas001","_minecraft_license":"LGPL-3.0-only","_minecraft_downloads":198,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"huhobot-spigot.zip","_minecraft_size_bytes":18404011,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T12:44:47.804474Z","_minecraft_date_created":"2025-09-29T02:42:55.879977Z","_minecraft_date_modified":"2026-02-06T13:25:45.554019Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/huhobot-spigot","_minecraft_icon_attachment_id":82656,"_minecraft_imported_at":"2026-06-04T17:45:59+00:00","_minecraft_import_hash":"b585e1f532a66e6060a7d6453b39a506","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,126,127,128,129],"mod_loader":[130,131,132,133,134],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-82657","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","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","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n\ud83d\udcdc Click to View<\/summary>\n
\n|——————|———————————————-|
\n| \/\u6dfb\u52a0\u767d\u540d\u5355 | Add a whitelist entry to the server |
\n| \/\u5220\u9664\u767d\u540d\u5355 | Remove a whitelist entry from the server |
\n| \/\u7ed1\u5b9a | Bind to the server |
\n| \/\u8bbe\u7f6e\u540d\u79f0 | Set your cross-server-group display name |
\n| \/\u53d1\u4fe1\u606f | Send a message from the group to the server |
\n| \/\u6267\u884c\u547d\u4ee4 | Send a command execution request to the server |
\n| \/\u67e5\u767d\u540d\u5355 | Query the server’s built-in whitelist |
\n| \/\u67e5\u5728\u7ebf | Query the list of online players on the server |
\n| \/\u5728\u7ebf\u670d\u52a1\u5668 | Query online servers |
\n| \/\u6267\u884c | Execute custom commands |
\n| \/\u7ba1\u7406\u5458\u6267\u884c | Run custom content with administrator privileges |<\/p>\n<\/details>\n
\n – Custom command system (see details below)<\/p>\n
\n– **Any supported Spigot\/Paper core** (including but not limited to versions 1.8+)<\/p>\n
\n – Open your browser and go to HuHoBot-SpigotAdapter Releases
\n – Download the latest version of the `HuHoBot-vx.x.x-Spigot.jar` file<\/p>\n
\n – Move the downloaded `HuHoBot-vx.x.x-Spigot.jar` file into the server’s `plugins` directory<\/p>\n
\n – Restart your Minecraft server to load the new plugin<\/p>\n
\n – Join the support group, click on the avatar of “HuHo_Bot” and add it to the group chat<\/p>\n
\n – Follow the console prompts to finish binding the server to the bot<\/p>\n
\n– The plugin is compatible with all supported Spigot\/Paper core versions; refer to the official documentation for specific version details<\/p>\n
\n# Ignore this field
\nserverId: null
\n# Ignore this field
\nhashKey: null<\/p>\n
\n from_game: “<{name}> {msg}” # Text format when in-game messages are forwarded to the group
\n from_group: “\u7fa4:<{nick}> {msg}” # Text format when group messages are forwarded to the server
\n post_chat: true # Whether to forward group messages to the server
\n post_prefix: “” # Prefix for group messages forwarded to the server<\/p>\n
\n server_ip: “play.hypixel.net” # MOTD image URL for “\/\u67e5\u5728\u7ebf” (replace with your server address)
\n server_port: 25565 # MOTD image port for “\/\u67e5\u5728\u7ebf” (replace with your server port)
\n api: “https:\/\/motdbe.blackbe.work\/status_img\/java?host={server_ip}:{server_port}” # MOTD image API for “\/\u67e5\u5728\u7ebf” (do not modify unless necessary; must return an image)
\n text: “\u5171{online}\u4eba\u5728\u7ebf” # MOTD text for “\/\u67e5\u5728\u7ebf” (supports PlaceholderAPI; leave empty to hide)
\n output_online_list: true # Whether to display the online player list
\n post_img: true # Whether to display the MOTD image<\/p>\n
\n add: “whitelist add {name}” # Command to add a whitelist entry
\n del: “whitelist remove {name}” # Command to remove a whitelist entry<\/p>\n
\ncustomCommand:
\n – key: “\u52a0\u767d\u540d” # Trigger keyword; use “\/\u6267\u884c \u5173\u952e\u8bcd \u53c2\u65701 \u53c2\u65702” to run the custom command
\n command: “whitelist add &1” # &1 is a parameter placeholder (1st parameter = &1, 2nd = &2, etc.)
\n permission: 0 # 0 = normal permission; values > 0 = 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 the configuration?<\/summary>\n
\/huhobot reload<\/code>
\n<\/details>\n\ud83d\udcac About cross-communication between group and server<\/summary>\n
\/\u53d1\u4fe1\u606f<\/code>, you can reply to the message up to 5 times within 5 minutes<\/b>; the bot will prioritize the latest message for replying.
\n
\nIf no message available for replying is found, the message cannot be sent.
\n<\/details>\n\ud83c\udf10 Does “\/\u67e5\u5728\u7ebf” display information for other servers?<\/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 No response when using “\/\u67e5\u5728\u7ebf”?<\/summary>\n
\/huhobot reconnect<\/code><\/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 add themselves to the whitelist?<\/summary>\n
customCommand<\/code> field as shown in the configuration example above.<\/p>\n\/\u6267\u884c \u52a0\u767d \"\u73a9\u5bb6ID\"<\/code> (add quotes for parameters with spaces)
\n<\/details>\n\ud83d\udc6e How to set up administrators?<\/summary>\n
\n\/\u7ba1\u7406\u5e2e\u52a9<\/code> \u2192 View the list of administrator commands
\n<\/details>\n\ud83c\udff0 Does it support multiple servers?<\/summary>\n
\nFor managing multiple servers, it is recommended to create a separate group for each server.
\n<\/details>\n
\n– **command**: The actual server command to execute (string)
\n– **permission**: Permission level (integer)<\/p>\n
\ncustomCommand:
\n – key: “\u52a0\u767d\u540d” # Trigger keyword; use “\/\u6267\u884c \u5173\u952e\u8bcd \u53c2\u65701 \u53c2\u65702” to run the custom command
\n command: “whitelist add &1” # &1 is a parameter placeholder (1st parameter = &1, 2nd = &2, etc.)
\n permission: 0 # 0 = normal permission; values > 0 = 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**: Original copyright notices must be retained<\/p>\n