Minecraft UniBot Docs

Truly Cross-Platform

Not just QQ — also Telegram, Discord, Kook, QQ Guilds and more. One command set that works across every platform.

Multi-Server Interconnection

Connect multiple Minecraft servers simultaneously with inter-server messaging and zero-latency cross-server chat.

Compatible with All Server Types

Supports Fabric, Forge, Spigot, Paper and other mainstream server platforms — plug-and-play, no extra adaptation needed.

Extension System

Five extension types — commands, services, rendering engines, templates and resources — plug-and-play with automatic failure isolation.

WebUI Admin Panel

A modern management interface with visual configuration, real-time monitoring and log viewing, out of the box.

NoneBot2 Ecosystem

Built on NoneBot2, seamlessly compatible with the NB plugin store — community plugins work out of the box.

Whitelist Management

A complete platform-account to game-ID binding system with multi-server whitelist synchronization.

Image Rendering Mode

Freely combine rendering engines and templates to turn command output into beautiful images, with custom backgrounds.

Project Components

Sub-project	Description	Tech Stack
UniBot	The main bot framework, responsible for message sending/receiving, command handling and WebUI management	NoneBot2 / Python
MC Adapter	The Minecraft protocol adapter for NoneBot, providing UniBot with MC communication capabilities	NoneBot Adapter

Sub-project

Description

Tech Stack

UniBot

The main bot framework, responsible for message sending/receiving, command handling and WebUI management

NoneBot2 / Python

MC Adapter

The Minecraft protocol adapter for NoneBot, providing UniBot with MC communication capabilities

NoneBot Adapter

Tip

In this documentation, "QueQiao" (鹊桥) refers to the third-party communication protocol maintained by 17TheWord / QueQiao, which supports MCDReforged, Spigot, Paper, Fabric, Forge, NeoForge, Vanilla, Folia, Velocity and other server platforms. UniBot communicates with QueQiao through the MC Adapter.

Quick Navigation

Get Started — deploy your UniBot from scratch

WebUI Admin Panel — visual configuration, real-time monitoring, log viewing

Configuration Guide — detailed reference for all configuration options

Command Reference — all built-in commands at a glance

Features — group-server interop, image rendering, extension system and more

Extension System — extension types, rendering system and visual management

Architecture — dive into the project architecture

MC Adapter — QueQiao protocol and server-side integration

Acknowledgements — thanks to every contributor and sponsor

Minecraft UniBotSeamlessly connect Minecraft with your chat world