Command your Minecraft AI companion over QQ

Your world keeps running while you are away from the keyboard. Message your Numen companion on QQ — "harvest the wheat at home" — and it plans the job, does the work in-game, then messages you back: "Harvested 64 stacks, stored in the chest."

This mod bridges QQ chat and the Numen AI companion through NapCatQQ (OneBot 11 protocol).

Features

• Direct-chat mode — bind the companion to a QQ bot account; whitelisted users command it by private message;
• Group mode — add the bot to a QQ group and let your friends put the companion to work; it reports back in the group;
• Replies are the AI's own decision — sending a QQ message is registered as one of the companion's tools, on the same footing as swinging a pickaxe. When the job is done, it knows what to say and to whom: private requests get private replies, group requests get group replies;
• Deny-by-default whitelists — an empty whitelist accepts nothing. Messages from anyone not explicitly allowed are dropped at the bridge layer and never reach the model, so they never spend a single token of your API quota;
• Zero third-party dependencies — JDK built-in WebSocket plus Gson; no bot framework embedded.

Requirements

1. Numen installed (required dependency, version 0.0.4 or newer);
2. NapCatQQ deployed and logged into a dedicated bot QQ account, with a forward WebSocket server enabled;
3. config/numen/qq_bridge.json filled in (endpoint, token, whitelists);
4. Add the bot account as a QQ friend from your own account, then start chatting.

Step-by-step setup, the full config reference and a troubleshooting table are in the GitHub README.

Notes

• Client-side mod — install it on the player's client, alongside Numen;
• Numen itself requires your own OpenAI-compatible LLM API key;
• Everyone on your whitelist spends your API quota — only authorize people you trust;
• QQ is a chat platform used primarily in China; this bridge is most useful for players with a QQ account.