# astrbot_plugin_beammp_server_info

**Repository Path**: slimeabc/astrbot_plugin_beammp_server_info

## Basic Information

- **Project Name**: astrbot_plugin_beammp_server_info
- **Description**: AstrBot BeamMP 服务器查询插件，支持延迟检测、多服务器状态监控及玩家/模组信息展示。
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-27
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: AstrBot

## README

BeamMP 服务器信息查询插件
astrbot_plugin_beammp_server_info
**AstrBot BeamMP 服务器查询插件，支持延迟检测、多服务器状态监控及玩家/模组信息展示。**

功能
- 异步 ICMP Ping 获取延迟，不阻塞主程序
- 支持查询多个 BeamMP 服务器状态
- 完全匹配触发词 "beammp" 或 "bmp"（不区分大小写，如 BeaMmP、bMp 均可）
- 自动解析服务器名称、在线人数、模组列表、版本等信息
- 可自定义显示项目和分隔符
- 服务器离线时自动提示

触发方式

```
beammp
或
bmp
```

查询配置文件中所有服务器的信息

配置 ⚙️

配置项说明：

- 服务器列表 - BeamMP 服务器地址，格式 `ip:port`，可添加多个（默认空数组）
- 显示服务器名称 - 是否显示服务器名（默认 `true`）
- 显示服务器地址 - 是否显示 IP:端口（默认 `true`）
- 显示延迟 - 是否显示 Ping 延迟（默认 `true`）
- 显示玩家人数 - 是否显示当前/最大人数（默认 `true`）
- 显示在线玩家 - 是否显示玩家列表（默认 `true`）
- 显示模组 - 是否显示模组数量和大小（默认 `true`）
- 显示模组列表 - 是否显示具体模组名（默认 `true`）
- 显示版本 - 是否显示服务器版本（默认 `true`）
- 分隔符 - 多个服务器间的分隔线（默认 `———————————`）
- Ping 次数 - 每个服务器 Ping 几次取平均（默认 `2`）
- 超时时间 - Ping 和连接超时秒数（默认 `3`）

输出示例

```
SXMY1
bng.example.com:30814
延迟：29ms
人数：0/12
在线玩家：
    无

模组：22个，共1.3GB
模组列表：
    mod1
    mod2
    cktodbox
    SlimesDriftMapV3
    ...
版本3.9.0

———————————

SXMY2
bng.example.com:30815
延迟：32ms
人数：1/12
在线玩家：
    player1

模组：12个，共1.1GB
模组列表：
    mod5
    mod3
    cktodbox
    SlimesDriftMapV3
    ...
版本3.9.0
```

离线提示

```
bng.example.com:30814 离线
```