在线列表配置¶

/查在线 用于在群内查询服务器当前在线玩家。服主可以通过 motd 配置控制在线列表的显示方式，也可以创建 online.md，让查询结果附带自定义 Markdown 内容。

基础配置¶

在线列表相关配置位于 motd 下。不同适配器可能使用 config.json 或 config.yaml，字段含义一致。

config.json¶

{
  "motd": {
    "server_ip": "play.example.com",
    "server_port": 19132,
    "api": "http://motd.txssb.cn/api/app_img?ip={server_ip}&port={server_port}&dark=true",
    "text": "共{online}人在线",
    "output_online_list": true,
    "post_img": true,
    "markdown": true,
    "customMarkdown": false
  }
}

config.yaml¶

motd:
  server_ip: "play.hypixel.net"
  server_port: 25565
  api: "http://motd.txssb.cn/api/app_img?ip={server_ip}&port={server_port}&dark=true"
  text: "共{online}人在线"
  output_online_list: true
  post_img: true
  markdown: true
  customMarkdown: false

字段说明¶

字段	类型	说明
`motd.server_ip`	字符串	服务器地址
`motd.server_port`	数字	服务器端口
`motd.api`	字符串	Motd 图片接口，支持 `{server_ip}` 和 `{server_port}` 占位符
`motd.text`	字符串	普通文本模式下的提示文本，`{online}` 会替换为当前在线人数
`motd.output_online_list`	布尔值	普通文本模式下是否输出在线玩家列表
`motd.post_img`	布尔值	是否发送 Motd 图片
`motd.markdown`	布尔值	是否使用 Markdown 模式返回在线玩家列表
`motd.customMarkdown`	布尔值	是否读取并返回自定义 `online.md` 内容

Note

motd.customMarkdown 默认为 false。关闭时，查询在线结果中不会包含自定义 Markdown 内容。

Markdown 模式¶

当 motd.markdown 为 true 时，HuHoBot 会使用 Markdown 模式返回在线玩家列表。

如果你想使用普通文本模式，可以关闭它：

{
    "motd": {
        "markdown": false
    }
}

motd:
    markdown: false

关闭 Markdown 模式后，motd.output_online_list 和 motd.text 会参与生成普通文本内容。

自定义 online.md¶

如果你想在 /查在线 的结果中附带公告、规则、群链接、服务器介绍等内容，可以开启 motd.customMarkdown。

{
    "motd": {
        "customMarkdown": true
    }
}

motd:
    customMarkdown: true

然后在 HuHoBot 配置文件同目录下手动创建：

plugins/HuHoBot/online.md

也就是说，online.md 要和 config.json 或 config.yaml 放在同一个文件夹中。

Warning

online.md 不会自动生成，需要服主手动创建。

online.md 示例¶

下面是一个可以直接使用的 online.md 示例：

# {{.server}}查在线结果

***

![Motd #700px #389px]({{.img_url}})

- **当前服内有**`{{.online_num}}`**位玩家**
- **名单如下:**

{{.player}}

保存后，下一次群内使用 /查在线 时，HuHoBot 会读取 online.md，并把文件内容作为自定义 Markdown 返回。

可用变量¶

变量	说明
`{{.server}}`	服务器名称
`{{.img_url}}`	Motd 图片链接
`{{.online_num}}`	当前在线人数
`{{.player}}`	在线玩家列表

本Markdown需遵守QQ开放平台规则，若出现链接、违禁词等会导致无法发送
Markdown规则可参考QQ开放平台文档
注：图片需要在[]内填写图片大小，如示例所示

故障排查¶

查询在线时没有自定义内容¶

请检查：

config.json 或 config.yaml 中 motd.customMarkdown 是否为 true
online.md 是否放在 HuHoBot 配置文件同目录下
文件名是否完全为 online.md，不要写成 online.md.txt
修改配置后是否已经重载或重启插件

控制台提示无法读取 online.md¶

如果控制台出现：

无法读取online.md，请检查文件是否存在（该文件需要手动创建）。

说明已经开启了 motd.customMarkdown，但插件没有成功读取到 online.md。请确认文件存在，并且服务器进程有权限读取该文件。

读取失败时，普通在线列表仍会正常返回，自定义 Markdown 内容会为空。