使用手册

本手册介绍了 Xinbot 的核心概念，并提供了内置命令的完整参考。

1. 核心概念

Bot (机器人)

连接到 Minecraft 服务器的核心客户端。它负责处理网络会话、身份验证并协调所有子系统。

Plugin (插件)

用于为机器人添加自定义逻辑的模块。Xinbot 采用插件优先架构，支持热重载。

Event (事件)

机器人内部触发的信号（例如：收到消息、登录成功）。插件可以监听并做出反应。

Command (命令)

通过控制台执行的手动指令，支持 Tab 补全和语法高亮。

2. 命令参考

Xinbot 命令可以直接在控制台中输入（不区分大小写）。

命令	别名	用法	描述
help	-	help [命令]	显示命令帮助信息。
say	chat	say <消息>	发送公共聊天消息。
command	cmd	cmd <指令>	向服务器发送指令（如 cmd home）。
pm	PluginManager	pm <子命令>	管理插件（加载、卸载、重载等）。
plugins	-	plugins	列出已加载插件。
list	-	list [uuid]	列出在线玩家。
disconnect	-	disconnect	断开当前连接。
stop	-	stop	停止并安全关闭程序。

插件管理 (pm) 子命令

• pm list: 列出所有插件。
• pm load <文件名>: 从目录加载插件。
• pm unload <插件名>: 卸载插件。
• pm reload <插件名>: 重载插件。

3. 进阶功能

Tab 补全

在控制台中按下 Tab 键，可以补全命令、子命令、插件名，甚至是服务器侧的指令建议。

语法高亮

合法的命令和参数会高亮显示，错误的输入将显示为红色。

服务器指令执行

若要发送 /w 等服务器原版指令，必须加 cmd 前缀：

cmd w <用户名> <消息>

4. 使用技巧

• 管理员设置: 确保 config.conf 中的 owner 字段正确设置。
• 自动处理: 使用 cmd 发送指令时，无需手动输入开头的 /。
• 安全退出: 始终推荐使用 stop 命令退出，以保证插件正确卸载和数据保存。