nonebot-plugin-mccheck
January 29, 2026 · View on GitHub
English|简体中文
📖 Introduction
Minecraft server status query, supporting IPv6.
update synchronously with https://github.com/molanp/zhenxun_plugin_mccheck/.
💿 Installation
One of the methods mentioned below can be selected.
[recommended] install using nb-cli
Open the command line in the root directory of Bot and enter the following instructions to install.nb plugin install nonebot-plugin-mccheck
install using package manager
In the plug-in directory of the nonebot2 project, open the command line and enter the installation command.pip install nonebot-plugin-mccheck
Open the pyproject.toml file in the root directory of the nonebot2 project, and write in the [tool.nonebot] section.
plugins = ["nonebot_plugin_mccheck"]
📈 Implemented functions
- IPv6 support
- Support for all platform adapters
- Support for all Unicode fonts and glyphs
- Motd-style rendering
- Support for double queries to interconnected servers
- Multilingual
- SRV support
📑 Future functions
- And more...
🖼️ Test screenshot
v0.1.45
🎈 Special Notes
Querying an IPv6 server
mcheck [2001:db8:85a3::8a2e:370:7334]:25565 <- IPv6 server address and port, the port and colon can be omitted
or
mcheck [2001:db8:85a3::8a2e:370:7334] <- IPv6 server address
⚙️ Configuration
Add the required configuration in the following table to the .env file of the nonebot2 project.
| Configuration Item | Required | Default Value | Description |
|---|---|---|---|
MCC__LANGUAGE | False | zh-cn | Languages used by the plugin to render images Available languages: [ zh-cn,zh-tw,en] |
MCC__TYPE | False | 0 | The type of message the plugin sends (0 for HTML, 1 for text) |
🎲 Comparison of message types
| Type | Special Styles | Favicon | Fully colored underline/strikethrough | Full Unicode font support |
|---|---|---|---|---|
| Text | ❌ | ⭕ | ❌ | ⭕ |
| HTML | ⭕ | ⭕ | ⭕ | ⭕ |
🎉 Usage
| Command | Parameter | Scope | Description |
|---|---|---|---|
mcheck | [ip]:[port] or [ip] | Private/Group Chat | Check Minecraft server status |
set_lang | Language name | Private/Group Chat | Set the language used by the plugin for rendering images |
lang_now | None | Private/Group Chat | View the current language used by the plugin for rendering images |
lang_list | None | Private/Group Chat | View the list of languages supported by the plugin |