Shio：partial translation

2026-03-31T06:59:26Z

partial translation

新页面

Due to Tencent's risk control and the sunset of signature support for new QQ versions in Mirai, the old [[部娘bot|bumon-nusome bot]] gradually could not operate stably anymore, and saw its EoL on March 26, 2025. On the same day, [[User:nekochen2333|nekochen2333]] built a bot based on [https://napneko.github.io/ NapCatQQ], and gradually migrated functions from the old bumon-nusome bot. Later [[User:Hexatomic ring|Hexatomic ring]] adopted [https://github.com/MaiM-with-u/MaiBot MaiBot], making the bumon-nusome a comprehensive bot which is able to communicate with the server, use to group chat commands and chat using LLM. This article will introduce the various functions of the bumon-nusome bot.

This article describes the command grammar in the same way as [https://minecraft.wiki/w/Commands#Commands_guide that Minecraft Wiki uses].

== Start from #help ==
Grammar

<code>#help [<command>]</code>

'''DM Only.''' Return the command list. If <code><command></code> is specified, return the help of the command instead.，

== Information Setting & Querying ==
=== Online Players ===
Grammar

<code>#list</code>

Return the online player list, including the fake players.

=== Bot and Server Status ===
Grammar

<code>#test</code>

Return the server status and the online player list. You can use this to check whether the bot is online.

=== User Information ===
Grammar

<code>#info [<query>]</code>

Return the user's Department ID, ''Minecraft'' ID, ''Minecraft'' Skin and QQ number. If <code><query></code> is not specified, return those of the sender, instead <code><query></code> will be parsed as Department ID, ''Minecraft'' ID and QQ number, and {{Tooltip|at-mention using nickname|tooltip=@<nickname>}} if in the group chat, respectively, and then query. All the matching users will be returned.

=== 个人信息设置 ===
语法

<code>setID <id></code>

<code>setMCID <mcid></code>

'''仅限私聊。'''设置自己的{{Tooltip|部门ID|tooltip=setID}}和{{Tooltip|MC ID|tooltip=setMCID}}。这些信息将与你的QQ账号绑定，如果与他人既有的ID产生冲突将导致设置失败。

部门ID发生更改时会通知主群。

Mojang虽然会存储MC ID的大小写情况，但是身份验证服务器实际上对大小写'''不'''敏感。设置MC ID时，bot会存储大小写，但是大小写的差异不会影响白名单。此外，将要设置的MC ID如果与既有的ID只有大小写差异会被视为冲突导致设置失败。

=== 服务器卡顿信息查询 ===
语法

<code>#profile (entities|health) [<tick>]</code>

<code>#tick -> profile</code>

'''仅限主群。'''返回服务器卡顿信息。该功能会调用Carpet模组的相关功能。如果没有指定<code><tick></code>，默认监测100游戏刻，否则监测<code><tick></code>游戏刻。<code><tick></code>最小为20，最大为600。

== 消息互通 ==

发送在主群的消息会通过[https://zh.minecraft.wiki/w/%E8%BF%9C%E7%A8%8B%E6%8E%A7%E5%88%B6%E5%8F%B0%E5%8D%8F%E8%AE%AE RCON]转发至主服，除非满足以下任意一条：
* 消息包含文字、图片和表情之外的内容；
* 消息以<code>#</code>、<code>;;</code>或{{Tooltip|<code>；；</code>|tooltip=U+FF1B 全形分号|offset=7}}开头；
* 消息超过RCON能够转发的长度上限；
* 发送者没有设置部门ID。
如果消息回复了其他人发送的消息，会在转发的消息中产生提示。

发送在主服务器中的消息会通过读取日志的方式获得。如果消息以<code>></code>、<code>》</code>或{{Tooltip|<code>＞</code>|tooltip=U+FF1E 全形大于号|offset=7}}开头，则会转发到主群。可以通过回复bot转发的消息回复发送者。

Bot的群指令和其它功能不会处理自己转发的消息。

== 其它消息提醒与个性化信息设置 ==
=== 玩家信息播报 ===
如果bot能找到服务器中一位玩家的用户信息，那么他/她登入、登出、取得成就或者登陆受阻时，bot会在主群中发送相应信息。

另外，如果一位用户在登出后60秒内登入，bot会撤回之前发送的登入信息，以防止刷屏。

=== 服务器信息播报 ===

当服务器检测到2秒以上的掉刻时，bot会在主群中播报此信息。

服务器启动、停止或崩溃时，bot也会播报相应信息。

=== 个性化信息设置 ===
语法

;<code>#match</code>
:显示命令帮助信息。
;<code>#match show (login|logout)</code>
:显示自定义登入/登出消息列表。
;<code>#match add (login|logout) <message></code>
:添加自定义登入/登出消息。
;<code>#match del (login|logout) <index></code>
:删除自定义登入/登出消息。
;<code>#match reset (login|logout)</code>
:重置自定义登入/登出消息。
;<code>#match test [<times>]</code>
:测试自定义登入/登出消息。

'''仅限私聊。'''管理自定义登入/登出消息。默认值情况下，登入和登出消息的默认值分别是'''[Login]<部内id>加入了游戏'''和'''[Logout]<部内id>退出了游戏''' 。当设置了自定义消息后，登入和登出消息将从设置的消息列表中抽取。

参数

<code>login</code>和<code>logout</code>分别代表登入和登出消息。

<code><message></code>是贪婪字符串，命令剩余部分都会被视为此参数。<code>%</code>为部内ID的占位符，替换时会带上<code><></code>，一条消息至少要使用此占位符1次，至多4次。含占位符的消息总长度不能超过61个半角字符，1个全角字符将视为2个半角字符。因没有转义功能，消息无法包含字面量<code>%</code>。字面量<code><</code>和<code>></code>也受到限制而无法包含。

<code><index></code>为消息的编号，可以通过<code>#match show</code>查看。

<code><times></code>为要测试的次数，不指定时默认为1。

返回值

<code>#match</code>返回命令帮助信息。

<code>#match (show|add|del)</code>返回操作后对应类型的消息列表。

<code>#match reset</code>返回“重置成功”的消息。

<code>#match test</code>返回指定次数的测试结果，每次测试包含登入和登出消息各一条。

=== 警钟长鸣 ===
语法

<code>#alert [add <content>]</code>

敲警钟或添加警钟。不使用<code>add</code>时，将会随机返回一条警钟消息，否则将会把<code><content></code>的内容作为警钟消息添加到数据库中并返回此消息的复述。<code><content></code>是贪婪字符串，命令剩余部分都会被视为此参数。

在主群中，每人每天至多分别使用一次<code>#alert</code>和<code>#alert add</code>。

=== 电击幻翼 ===
语法

<code>#djhy</code>

'''仅限主群。'''解释“电击幻翼”是什么意思。

== 实用功能 ==
=== 切换为假人 ===
语法

<code>#shadow [{{Tooltip|...|tooltip=详细语法参见下文。|offset=7}}]</code>

'''仅限私聊。'''控制假人。语法详见[https://github.com/gnembon/fabric-carpet/wiki/Commands#player 此处]，不支持<code>spawn</code>和<code>drop</code>子命令。如果没有指定参数，则以假人登录，否则按照参数执行假人指令。返回值为执行<code>/player</code>的结果，如果执行成功正常应该返回'''（无结果）'''。

=== 踢出自己 ===
语法

<code>#kick</code>

'''仅限私聊。'''使自己下线。返回一条提示信息。

=== 获取实时高清地图 ===
语法

<code>#img (world|DIM-1|DIM1) <start> <end> {{Tooltip|<nowiki>{[marker=(off|on)] [maxpix=<maxpix>] [format=<format>]}</nowiki>|tooltip=这些关键字参数的出现顺序无关紧要。|offset=7}}</code>

'''仅限私聊。'''返回指定区域的地图图片。

参数<sup>{{Tooltip|[需要更多信息]|tooltip=关键字参数的功能未测试。}}</sup>

<code>world</code>、<code>DIM-1</code>和<code>DIM1</code>分别指主世界、下界和末地。

<code><start></code>和<code><end></code>为2维整数坐标，指定起止点。任意坐标轴方向上的长度不能超过4000格。

== 模拟群友功能 ==
<div style="background-color:#cceeff; line-height:1.7; padding:0px 10px;width:fit-content; min-width:30%; max-width:60%; font-size:16px; border-left:5px solid #99ddff">
'''本章节所记载的内容已不符合当前THUnion的情况。'''<br>
部娘的聊天功能已被禁用。
</div>

在主群中可以与部娘bot进行对话，功能包括但不限于长期记忆、识别图片、检索wiki、在线检索、发送表情包等。<s>（我们新式的ai已经完爆了老式的随机复读机）</s>

具体实现原理详见[https://github.com/MaiM-with-u/MaiBot 麦麦bot]。

== 主服聊天框功能 ==

以下功能通过在主服聊天框打字触发。

=== 计算器 ===
语法

<code><expression>=?</code>

返回由python计算的算式结果。<code><expression></code>只能包含以下字符：<code>0123456789+-*/ </code>。

=== 轨迹记录 ===
语法

;<code>#</code>
:记录当前位置，如果没有进行中的记录则开始一次记录。
;<code>(!|!!)</code>
:记录当前位置，并停止正在进行的记录。
;<code>#track <interval></code><br>
:开始一次自动记录。

记录玩家的位置，并在记录结束时将记录通过QQ发送给玩家。自动记录的间隔<code><interval></code>以秒为单位，不能小于0.2秒。使用<code>!</code>结束记录时，近似在一条直线上的点只会保留两端，使用<code>!!</code>则不会有上述行为。

[[Category:其他]]

部娘bot(新)/en - 版本历史

Shio：​partial translation

Shio：partial translation