Features

About 764 wordsAbout 3 min

UniBot offers a rich set of features, covering group-server interop, image rendering, WebUI management, and more.

Group-Server Interop

UniBot's core capability is letting Minecraft and chat platforms communicate in real time:

See QQ group messages in-game in real time
See in-game chat in QQ groups, supporting message types like text and images
Broadcasts of all player join / leave / death events
Automatic notifications of server start / stop
Cross-server message relay, building a distributed MC network

Direction	Config Item	Description
Group → Server	`sync_all_qq_message`	Group messages are automatically forwarded to the game
Server → Group	`sync_all_game_message`	In-game messages are automatically forwarded to the group
Server → Server	`sync_message_between_servers`	Cross-server message relay

Event Broadcast

Supported broadcast events:

Player join / leave
Player death
Player achievements
Server start / stop

The player death and achievement events require the MoreGameEvents plugin on the MCDR side.

Sensitive Word Filtering

Through the sync_sensitive_words configuration, messages that hit a sensitive word are not forwarded to the group; instead, a violation reminder is sent.

Image Rendering

Image rendering sends the bot's command output as images, supporting commands such as list, fortune, and status. It is provided by rendering engine, template, and resource extensions.

Image rendering is a fairly independent feature — see Image Rendering for the complete steps to enable, configure, and customize it.

UniBot ships with a web admin panel built on Vue 3 + Vite, interacting with the backend through a REST API. It provides real-time dashboard monitoring, server / player management, visual configuration, extension management, log viewing, and more — with WebUI, you'll basically never need to manually edit configuration files.

Dashboard: real-time running status + "Quick Start" guide card
Visual configuration: grouped editing of Config.toml / .env / Messages.toml with Schema validation
Server / Player / Adapter / Plugin / Extension: one-stop management
Log viewing: real-time WebSocket streaming + level filtering
Login authentication: JWT + HttpOnly Cookie, admin account system

Note

Detailed explanations of each page, how to enable it, initializing the admin, and FAQ, see WebUI Admin Panel.

Extension System

UniBot is built on NoneBot2 and seamlessly integrates with the NB plugin registry — community plugins work out of the box; the built-in extension mechanism lets you freely combine bot capabilities like building blocks:

Five extension types: command, service, rendering engine, template, and resource — install and enable/disable on demand.
Out of the box: built-in commands and templates are preinstalled, no additional configuration needed.
Stable and reliable: an exception in a single extension won't bring down the whole bot; a failing extension is automatically isolated with the reason noted.
Dependency aware: dependencies between extensions are resolved automatically, with clear notifications about missing or version-incompatible dependencies.
Visual management: enable/disable extensions, configure them, and switch rendering engines / templates right in WebUI.

For more details, see Extension System.

Whitelist Management

A complete binding system between platform accounts and game IDs:

Supports whitelist sync across multiple servers.
Configurable binding count (qq_bound_max_number).
Manageable directly with the /bound command.

Comparison with Similar Solutions

Feature	UniBot	Traditional Solutions
Multi-platform support	QQ / Telegram / Discord / Kook…	Usually QQ only
Multi-server interconnection	Native support, message relay	Requires self-modification
WebSocket communication	Real-time persistent connection	Mostly HTTP polling
Extension system	Command / service / rendering / template / resource — plug-and-play	Monolithic coupling
NoneBot2 ecosystem	Seamless access to the NB plugin registry	Closed-source self-developed
WebUI	Vue 3 admin panel	None
Image rendering	HTML/CSS template engine	None
Whitelist management	Complete binding system	None or basic

Comparison with Similar Solutions