koishi-plugin-rcon-command-tool
v1.0.0
Published
增强版Rcon工具,支持多服务器管理,直接返回结果给机器人,完全替代原始rcon插件
Downloads
146
Maintainers
Readme
koishi-plugin-rcon-command-tool
增强版Rcon工具,专为YesImBot设计,支持多服务器管理,直接返回结果给机器人。
🌟 特性
- 🚫 完全绕过聊天输出:不再通过
session.send()发送消息,结果直接内部返回给机器人 - 🖥️ 多服务器支持:可以配置多个rcon服务器,并指定使用哪个服务器
- 🔄 智能重连机制:自动处理连接断开和重连
- 📊 结果优化:针对不同类型的命令提供美化的输出格式
- 🛠️ 三个强大工具:
execute_rcon_command:执行rcon命令并获取结果check_rcon_servers_status:查看所有配置的服务器状态test_rcon_connection:测试指定服务器连接
- 📈 配置页面状态显示:在Web控制台实时显示每个服务器的连接状态
📦 安装
在 Koishi 控制台的插件市场中搜索 rcon-command-tool 并安装。
或者使用命令行:
npm install koishi-plugin-rcon-command-tool⚙️ 配置
plugins:
rcon-command-tool:
enabled: true
defaultServer: main
servers:
- name: main
host: your-server.com
port: 25575
password: your-rcon-password
maxRetry: 3
retryInterval: 1000
- name: test
host: localhost
port: 25575
password: test123
maxRetry: 2
retryInterval: 2000配置说明
enabled: 是否启用插件defaultServer: 默认使用的服务器名称servers: 服务器配置列表name: 服务器名称标识host: 服务器IP地址port: Rcon端口password: Rcon密码maxRetry: 最大重试次数retryInterval: 重试间隔(毫秒)
🎯 使用方式
这个插件专为YesImBot机器人设计,提供以下工具:
1. execute_rcon_command
执行Minecraft服务器的Rcon命令并直接获取结果。
参数:
command: 要执行的Rcon命令(如:list,time set day,weather clear)server: 目标服务器名称(可选,默认使用defaultServer)
2. check_rcon_servers_status
查看所有Rcon服务器的实时连接状态和可用性。
3. test_rcon_connection
测试指定Rcon服务器的连接状态,强制尝试连接以验证可用性。
参数:
server: 要测试的服务器名称
🔧 与原版rcon插件的区别
| 特性 | 原版rcon插件 | 本插件 | |------|-------------|--------| | 结果返回方式 | 直接发送到聊天 | 内部返回给机器人 | | 多服务器支持 | ❌ | ✅ | | 机器人可读性 | ❌ | ✅ | | 结果优化 | ❌ | ✅ | | 状态显示 | 单服务器 | 多服务器状态 | | YesImBot集成 | ❌ | ✅ |
📄 许可证
MIT
🤝 贡献
欢迎提交 Issue 和 Pull Request!
