QQBot:Rebuild
A Python QQ bot based on Nonebot2 that interacts with Minecraft in various ways. It is feature-rich, easy to use, highly performant, and configurable, requiring only simple setup to get started.
About this Mod
Nonebot2 Minecraft QQ 机器人 | Nonebot2 Minecraft QQ Bot
一款基于 Nonebot2 用多种方式与 Minecraft 交互的 Python QQ 机器人。功能丰富，使用简单，性能高强且可以自行配置，仅需简单配置即可使用。
A Python QQ Bot based on Nonebot2 that interacts with Minecraft in multiple ways. Feature-rich, easy to use, high performance, and highly configurable—ready to use with simple setup.
✨ 核心功能 | Core Features
| 中文 | English |
|---|---|
| 多服互联，群服互通 | Multi-server interconnection, group-server communication |
| 在不同服务器之间转发消息 | Forward messages between different servers |
| 可在游戏内看到 QQ 群的消息 | View QQ group messages in-game |
| 可使用指令在游戏内向 QQ 群发送消息 | Send messages to QQ groups from in-game using commands |
| 可播报服务器开启、关闭，玩家进入离开服务器以及死亡消息 | Broadcast server start/stop, player join/leave, and death messages |
| WebUi 简单配置 | Simple configuration via WebUI |
| 戳一戳机器人发送一言卡片 | Poke the bot to send a hitokoto (quote) card |
| 可自行配置指令的开启或关闭 | Enable or disable commands as needed |
| 可自行配置接入 AI 功能 | Optional AI integration configurable |
📖 服务端以及配置文档 | Server Setup & Docs → Wiki
💬 QQ 群指令 | QQ Group Commands
| 指令 | Command | 功能 | Function |
|---|---|---|---|
luck |
luck |
查看今日幸运指数 | Check today's luck index |
mcdr |
mcdr |
在指定服务器执行 MCDR 指令 | Execute MCDR commands on specified servers |
list |
list |
查询每个服务器的玩家在线情况 | Query online player count for each server |
help |
help |
查看帮助信息 | View help information |
server |
server |
查看在线服务器及编号、占用 | View online servers with IDs and resource usage |
bound |
bound |
绑定白名单相关指令 | Whitelist binding commands |
command |
command |
发送指令到服务器 | Send commands to the server |
🎮 游戏内管理员指令 | In-game Admin Commands
管理员可使用
/qqbot命令 | Admins can use/qqbotcommands
| 指令 | Command | 说明 | Description |
|---|---|---|---|
/qqbot reconnect |
/qqbot reconnect |
重连 WebSocket | Reconnect WebSocket |
/qqbot config |
/qqbot config |
查看配置文件 | View configuration file |
/qqbot config uri "ws://链接" |
/qqbot config uri "ws://link" |
更改配置文件 URI 链接 | Change configuration URI |
/qqbot config token "TOKEN" |
/qqbot config token "TOKEN" |
更改配置文件 Token | Change configuration Token |
/qqbot config reconnect_interval "次数" |
/qqbot config reconnect_interval "count" |
更改重连次数 | Change reconnect interval count |
/qqbot config name "服务器名字" |
/qqbot config name "server_name" |
更改服务器名字 | Change server name |
/qqbot test |
/qqbot test |
测试链接 | Test connection |
/qqbot info 或 /qqbot |
/qqbot info or /qqbot |
查看 QQBOT 状态 | View QQ Bot status |
Available Versions
How to Install QQBot:Rebuild on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (26.1.2).
Install Mod
Open the mod browser in the dashboard and search for "QQBot:Rebuild". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
26.1.2, 1.21.11, 1.21.10
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
QQBot:Rebuild server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (26.1.2). You can switch loaders with one click in the panel.
Is QQBot:Rebuild compatible with fabric?
QQBot:Rebuild officially supports fabric for Minecraft 26.1.2, 1.21.11, 1.21.10. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with QQBot:Rebuild – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if QQBot:Rebuild consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install QQBot:Rebuild with just one click on your server.