Bind a Minecraft server to your chat group, query live server status and online players, and track per-player playtime. Migrated to the new LangBot plugin SDK.
MCBotPlugin
A LangBot plugin for Minecraft server chat groups: bind a Minecraft server to your group, query live server status and online players, and track per-player playtime.
This is the migration of the legacy MCBotPlugin (built for QChatGPT) to the new LangBot plugin SDK. MongoDB storage is replaced by the built-in plugin key-value storage (no external database required), the synchronous
mctoolsping is replaced by asyncmcstatus, and the thread-based playtime routine is replaced by an asyncio background task.
Features
- Bind a server: each group can bind one Minecraft (Java Edition) server
- Status query: live MOTD, version, online count and player list
- Playtime stats: a background task samples online players and aggregates per-player online time over any period
Commands
| Command | Description | Privilege |
|---|---|---|
!mcbot | Show help | Everyone |
!mcbot bind <address[:port]> | Bind a server to this group | Admin |
!mcbot unbind | Unbind the server | Admin |
!mcbot status | Show server status and online players | Everyone |
!mcbot time [minutes] | Show playtime stats (default 1440 min = 24h) | Everyone |
Admins are determined by LangBot's
adminsconfig ({launcher_type}_{launcher_id}).
Config
| Key | Description | Default |
|---|---|---|
track_interval | Background sampling interval in seconds (min 15) | 60 |
ping_timeout | Server ping timeout in seconds | 10 |
Dependencies
mcstatus— Minecraft server status queries
Storage
Bindings and online records are kept in LangBot's built-in plugin KV storage; no MongoDB needed. Online records are retained for 14 days.
Use MCBotPlugin in Feishu/Lark bots, DingTalk bots, WeCom bots, WeChat bots, QQ bots, Slack bots, Discord bots, Telegram bots, LINE Bots, and Matrix Bots.
Host your bot on LangBot Cloud and connect this extension to the collaboration platforms your team already uses.