Mai Arcade 机厅工具

帮助入口

帮助 机厅
机厅help
机厅帮助
arcade help

• 帮助 机厅：打开 PicMenu 分类图片菜单。
• 其余命令：查看插件原有的文字帮助。

本插件按群保存机厅、人数、别名、地图和排卡数据。使用前需要由本群管理员执行 添加群聊 开通功能。人数数据会在每天 0 点清理，机厅和排卡配置不会随人数清理。

开通

添加群聊

开通后才可添加机厅、上报人数和使用排卡。

停用

删除群聊

该命令会从插件数据中移除当前群及其机厅配置，请确认后再执行。两项操作都需要超级用户、群主或群管理员权限。

添加机厅

添加机厅 机厅名

Bot 会搜索 Nearcade，并给出最多 3 个候选。发送 1～3 选择机厅，4 查看更多，5 按原名称直接添加，6 取消。选择 Nearcade 机厅时会尝试自动保存详情地图链接；没有搜索结果时会直接添加输入的名称。

删除与列表

删除机厅 机厅名
删除机厅 1
机厅列表
机厅

机厅列表 会显示当前群的机厅及序号；删除机厅必须使用机厅本名或列表序号，不能直接使用别名。

今日人数总览

mai
机厅人数
jtj
机厅几人

只列出今天已有更新记录的机厅，并显示更新人和时间。

查询单个机厅

机厅名几
机厅名几人
机厅名j

机厅名可以使用已设置的机厅别名。若机厅关联了 Nearcade 地图，查询时会读取并校准云端出勤人数；结果还会根据机台数量估算排队轮数和等待时间。

命令格式

机厅名++       人数加 1
机厅名--       人数减 1
机厅名++3      人数加 3
机厅名--3      人数减 3
机厅名+3       人数加 3
机厅名-3       人数减 3
机厅名=3       直接设为 3
机厅名3        直接设为 3

机厅本名和别名均可使用。单次增减值不能超过 50，更新后的总人数必须在 0～100。

若机厅保存了 Nearcade 地图链接，插件会读取机台数量、校准现有云端人数并上传新的出勤人数，同时给出预计等待时间；未关联地图时只更新本地人数。

加入排卡

排卡 机厅名
排卡 别名

插件使用当前群昵称作为排卡身份。同一个昵称不能同时加入本群多个机厅的队列。

查看队列

排卡现状 机厅名

会按顺序显示当前排队成员。排卡和查询都支持机厅本名或别名；当前实现不支持用机厅序号排卡。

队列操作

上机
延后
退勤

• 上机：只有当前第一位可操作；将队首移到队尾，并提示下一位。队列只有一人时保持不变。
• 延后：将自己与后一位交换；已经是最后一位时无需延后。
• 退勤：将自己的群昵称从当前机厅队列移除。

这些命令会在本群所有机厅队列中查找当前昵称，因此无需再填写机厅名。

示例

闭店 机厅名
闭店 别名

闭店会直接清空指定机厅的排卡名单，但不会删除机厅、别名、地图或人数数据。当前实现支持机厅本名和别名，不支持机厅序号。

添加与查询

添加机厅别名 <机厅名/序号> <别名>
机厅别名 <机厅名/序号>

删除

删除机厅别名 <机厅名/序号> <别名/序号>
移除机厅别名 <机厅名/序号> <别名/序号>

先用 机厅列表 查看机厅序号，用 机厅别名 <机厅> 查看别名序号。添加和删除需要超级用户、群主或群管理员权限。

添加与查询

添加机厅地图 <机厅名/序号> <地图URL>
机厅地图 <机厅名/序号>
音游地图 <机厅名/序号>

删除

删除机厅地图 <机厅名/序号> <URL/序号>
移除机厅地图 <机厅名/序号> <URL/序号>

地图序号可通过查询命令获得。Nearcade 详情链接可用于人数云同步和机台数量识别。

注意：插件原版帮助将添加地图标为管理员操作，但当前源码只对“删除地图”做了管理员权限检查；此菜单按当前实际行为说明。

使用方法

直接向 Bot 发送 QQ 的位置分享消息。插件会读取经纬度，通过 Nearcade 搜索半径 10 km 内的机厅，并展示距离最近的最多 3 家、地址和详情页。

此监听器本身没有要求群聊，也不要求先执行 添加群聊。普通文字地址、截图或图片不含可解析的 QQ 位置数据，无法触发搜索。

序号来源

机厅列表          查看机厅序号
机厅别名 <机厅>   查看别名序号
机厅地图 <机厅>   查看地图 URL 序号

机厅管理、别名管理和地图管理中的多数参数支持对应序号；排卡、排卡现状和闭店当前只支持机厅本名或别名。

Nearcade

添加机厅时选择搜索候选，会尝试自动保存 Nearcade 链接。有关联链接时，人数查询和上报会访问 Nearcade，同步出勤人数并读取 maimai DX 机台数量；外部服务不可用时，云端查询或上传可能失败，但本地数据仍由插件保存。