This release is a pre-release and may not be stable for production use.
📖 介绍
- 支持同时查询多个服务器。
- 生成 Minecraft 多人游戏服务器列表样式图片。
- 显示服务器图标 (Favicon)。
- 解析并渲染 Minecraft 颜色代码 (MOTD)。
- 详细的延迟测试（预热、多次测试取平均值、去极值）。
🎨 效果图
💿 安装
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装nb plugin install nonebot-plugin-mcserver-status-check --upgrade
使用 pypi 源安装
nb plugin install nonebot-plugin-mcserver-status-check --upgrade -i "https://pypi.org/simple"
使用清华源安装
nb plugin install nonebot-plugin-mcserver-status-check --upgrade -i "https://pypi.tuna.tsinghua.edu.cn/simple"
使用包管理器安装
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令uv
uv add nonebot-plugin-mcserver-status-check
安装仓库 master 分支
uv add git+https://github.com/leiuary/nonebot-plugin-mcserver-status-check@master
pdm
pdm add nonebot-plugin-mcserver-status-check
安装仓库 master 分支
pdm add git+https://github.com/leiuary/nonebot-plugin-mcserver-status-check@master
poetry
poetry add nonebot-plugin-mcserver-status-check
安装仓库 master 分支
poetry add git+https://github.com/leiuary/nonebot-plugin-mcserver-status-check@master
打开 nonebot2 项目根目录下的 pyproject.toml 文件, 在 [tool.nonebot] 部分追加写入
plugins = ["nonebot_plugin_mcserver_status_check"]
使用 nbr 安装(使用 uv 管理依赖可用)
nbr 是一个基于 uv 的 nb-cli，可以方便地管理 nonebot2
nbr plugin install nonebot-plugin-mcserver-status-check
使用 pypi 源安装
nbr plugin install nonebot-plugin-mcserver-status-check -i "https://pypi.org/simple"
使用清华源安装
nbr plugin install nonebot-plugin-mcserver-status-check -i "https://pypi.tuna.tsinghua.edu.cn/simple"
⚙️ 配置
在 nonebot2 项目的.env文件中添加下表中的配置
# 服务器列表
MSC_SERVER_LIST='[]'
# 延迟测试间隔(秒)
MSC_LATENCY_INTERVAL=0.1
# 延迟测试预热次数
MSC_LATENCY_WARMUP=2
# 延迟测试次数
MSC_LATENCY_COUNT=3
# 是否去极值
# true: 去掉最大最小，取平均 (默认，次数自动加二)
# false: 不去极值，直接取平均
# "best": 最低延迟优先 (适用于校园网等多运营商宽带聚合环境，此时建议调高测试次数)
MSC_LATENCY_TRIM=true
# 是否在控制台显示详细信息
MSC_SHOW_TIMING_DETAILS=false
# 触发指令列表
MSC_COMMAND_TRIGGERS=["查服"]
# 汇总图片是否显示服务器响应附带的玩家样例（不是完整名单；单服查询不受此项影响）
MSC_SHOW_PLAYER_LIST=false
服务器列表配置示例
MSC_SERVER_LIST='[
{"address": "mc.hypixel.net", "alias": "Hypixel"},
{"address": "play.example.com"}
]'
🎉 使用
指令列表
- 查服
- 查询所有配置的服务器状态，生成汇总图片。
- 查服 [IP/别名]
- 单独查询指定服务器的状态。
- 查服列表
- 查看当前配置的服务器列表及别名。
💡 特性
- 🎨 原版风格：按 Minecraft 多人游戏服务器列表布局绘制。
- ⚡ 高效并发：支持多服务器并行查询，速度飞快。
- 📊 精准延迟：内置预热和去极值算法，提供最真实的延迟数据。
- 📝 颜色支持：完整支持 Minecraft 样式代码 (§) 和 JSON 格式 MOTD。
- 🖼️ 图标显示：自动获取并显示服务器 Favicon。
- 👥 玩家样例：显示服务器状态响应提供的内容；服务器可能省略或自定义，未必是玩家名称。
📝 TODO
- 支持不同群聊存放不同列表。
- 支持基岩版服务器查询.
1 maintainer
Metadata
1 maintainer
Release files for nonebot-plugin-mcserver-status-check 0.2.0b1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nonebot_plugin_mcserver_status_check-0.2.0b1.tar.gz | 4.5 MB | With provenance | Details for nonebot_plugin_mcserver_status_check-0.2.0b1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nonebot_plugin_mcserver_status_check-0.2.0b1-py3-none-any.whl | Python 3 | none | any | Details for nonebot_plugin_mcserver_status_check-0.2.0b1-py3-none-any.whl |
Total release size: 9.1 MB
Release files / nonebot_plugin_mcserver_status_check-0.2.0b1.tar.gz
| Download URL | nonebot_plugin_mcserver_status_check-0.2.0b1.tar.gz |
|---|---|
| Size | 4.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4d454e928da4982794a2f0fe1f20c4c8cb49a1b722875c65eee477ca3141a2e2
|
|
BLAKE2b-256 checksum How to use checksums |
dc39d5616000faaf130d147c9cb6297f0aede2fd57cc16afd954702676269f76
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logRelease files / nonebot_plugin_mcserver_status_check-0.2.0b1-py3-none-any.whl
| Download URL | nonebot_plugin_mcserver_status_check-0.2.0b1-py3-none-any.whl |
|---|---|
| Size | 4.6 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
de3f5505a05d3fab732e6ee4bb9ac23ac51a70197a5d1971b3694f99aa2d64db
|
|
BLAKE2b-256 checksum How to use checksums |
f737b3fee1f7348b5cc016443c37f8de89b63a251af8d7a89039a60231d0212d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logSecurity for nonebot-plugin-mcserver-status-check 0.2.0b1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for nonebot_plugin_mcserver_status_check-0.2.0b1.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 1, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
