内置命令使用

Bngeuit 框架内置了 6 个常用命令，主要用于机器人管理和调试。所有内置命令都在控制台输入使用。

命令列表

命令	别名	说明
stop	—	停止机器人：卸载全部插件、关闭客户端并退出进程
plugins	pl	列出已加载插件（名称 / 版本 / 状态）
help [页码]	—	分页查看命令列表，每页 8 条
scripts	—	列出所有脚本插件及其来源文件
plugin <load|unload|reload> <插件名>	plg	插件热管理：加载 / 卸载 / 重载（JAR 与 JS 脚本插件均支持）
log level [all|framework|plugin] <级别>	—	热修改日志级别（TRACE/DEBUG/INFO/WARN/ERROR/OFF），立即生效

使用示例

查看帮助

help          # 第一页命令列表
help 2        # 第二页

管理插件

plugins                  # 查看已加载插件列表
plugin load myplugin     # 热加载插件
plugin unload myplugin   # 卸载插件
plugin reload myplugin   # 重载插件（卸载后重新加载）

也可以使用别名：

pl                  # 等同于 plugins
plg reload myplugin # 等同于 plugin reload myplugin

调整日志级别

log level                    # 查看当前日志级别
log level all DEBUG          # 框架 + 插件都调为 DEBUG
log level framework INFO     # 只调框架日志为 INFO
log level plugin DEBUG       # 只调插件日志为 DEBUG
log level all OFF            # 关闭所有日志

日志级别说明（从详细到简略）：

• TRACE - 最详细的跟踪信息
• DEBUG - 调试信息
• INFO - 一般信息（默认）
• WARN - 警告信息
• ERROR - 错误信息
• OFF - 关闭日志

要点：

• log level 无参数时显示框架与插件当前的日志级别
• 目标可选 all（默认）/ framework / plugin，省略目标等价于 all
• 控制台与日志文件一并生效，无需重启

停止机器人

stop    # 停止机器人并退出进程

命令命名空间

每个命令都有一个命名空间，用于区分不同来源的命令：

• 内置命令：命名空间为 bngeuit，如 bngeuit:stop
• 插件命令：命名空间为插件名（小写），如 myplugin:test

当存在同名命令冲突时，可以使用 命名空间:命令 格式精确指定：

bngeuit:stop            # 明确调用内置的 stop 命令
myplugin:test           # 明确调用 myplugin 插件的 test 命令

如果不使用命名空间，框架会按优先级自动匹配可用的命令。

命令冲突处理

当多个插件注册了同名命令时：

1. 使用 help 命令查看所有可用命令（包括被覆盖的冲突命令）
2. 使用 插件名:命令 格式精确调用特定插件的命令
3. 建议插件开发者为命令设置独特的名称，避免冲突