@baipiaodajun/mcbots/README.md

Minecraft bot and status dashboard for multi-server management

# 🛡️ Minecraft 保活机器人及监控面板 - @baipiaodajun/mcbots

## 特性

- 多服务器配置：支持通过 SERVERS_JSON 文件一次性定义多个 MC 服务器，并为每个服务器自动创建对应的机器人连接。
- 智能网络检测：支持连接超时监控，自动在 30 秒后尝试重连。
- 实时监控面板：机器人运行状态即时更新，便于统一管理与观察。
- 多实例支持：同一服务器可同时连接并管理多个机器人。
- 可配置行为变量：通过设置 CHAT 与 MOVE 环境变量，灵活控制机器人聊天或移动行为。


## 用法

### nodejs
新建一个 index.js 文件，内容如下：
其中内容替换成你自己的MC服务器地址和端口，其他可以根据情况改变，可以添加多台服务器。
```
process.env.SERVERS_JSON='[{"host":"mc-yy.io","port":25565,"minBots":1,"maxBots":3,"version":"1.20.1"},{"host":"mc-xx.io","port":25565,"minBots":1,"maxBots":3,"version":"1.20.1"}]';

const { initialize, shutdown } = require('@baipiaodajun/mcbots');

initialize().then(() => {
  console.log('mcbots start successed');
}).catch(err => {
  console.error('mcbots start fail:', err);
});

process.on('SIGINT', shutdown);
process.on('SIGTERM', shutdown);
```

再新建一个package.json，内容如下：
```
{
  "name": "mc",
  "version": "1.0.0",
  "description": "mcbots",
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  },
  "dependencies": {
    "@baipiaodajun/mcbots": "latest"
  }
}
```
接下来运行启动nodejs就可以
```
npm install && npm run start
```
### docker 
```
docker run -d \
  --name mcbot \
  -e SERVERS_JSON='[{"host":"mc-yy.io","port":25565,"minBots":1,"maxBots":3,"version":"1.20.1"},{"host":"mc-xx.io","port":25565,"minBots":1,"maxBots":3,"version":"1.20.1"}]' \
  -p 3000:3000 \
  mingli2038/mcbot:latest
```
## 来源
这个东西不是我的原创，思路来自Tweek白嫖群的[这种事可以花点钱]用户给的镜像[ghcr.io/oprmg/mcbot:latest](https://ghcr.io/oprmg/mcbot:latest)，我通过AI重构其实现并加入自己的想法从而重新发布出来。