{"_id":"@baipiaojuntuan/mcbots","name":"@baipiaojuntuan/mcbots","dist-tags":{"latest":"1.2.8"},"versions":{"1.2.8":{"name":"@baipiaojuntuan/mcbots","version":"1.2.8","description":"Minecraft bot and status dashboard for multi-server management","main":"index.js","scripts":{"start":"node index.js"},"bin":{"mcbots":"index.js"},"keywords":["minecraft","bot","mineflayer"],"author":{"name":"mingli2038"},"license":"MIT","publishConfig":{"access":"public"},"dependencies":{"cookie-parser":"^1.4.7","express":"^4.18.2","mineflayer":"4.35.0","node-fetch":"^2.7.0"},"_id":"@baipiaojuntuan/mcbots@1.2.8","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-0OBd1ke+u4Am/LwBtmjRGgZYp2G5dNLxKDxtHHuKq94eLDwXMqwx54V/Crqfcb6bcCUR1oLdr4s040Ue2xSK5Q==","shasum":"4e16e4f12931095c326e7ae5e4852dfda5498e28","tarball":"https://registry.npmjs.org/@baipiaojuntuan/mcbots/-/mcbots-1.2.8.tgz","fileCount":3,"unpackedSize":64046,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHNlXWmZCWB1RhjcLOkR3Yi6fsUqiLQuRkKq4QvdtwfNAiEAle2MapO7/px+5nHu2zMsCJmzXSR7262hg50tqFQ6WGE="}]},"_npmUser":{"name":"jdwan","email":"mlr95lflnq@outlook.com"},"directories":{},"maintainers":[{"name":"jdwan","email":"mlr95lflnq@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcbots_1.2.8_1788539684919_0.5345539226592406"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-04T16:34:44.765Z","1.2.8":"2026-09-04T16:34:45.042Z","modified":"2026-09-04T16:34:45.305Z"},"maintainers":[{"name":"jdwan","email":"mlr95lflnq@outlook.com"}],"description":"Minecraft bot and status dashboard for multi-server management","keywords":["minecraft","bot","mineflayer"],"author":{"name":"mingli2038"},"license":"MIT","readme":"# @baipiaojuntuan/mcbots\n\nMinecraft 多服务器保活机器人及监控面板。面向资源回收策略严格的免费服务器环境，通过模拟客户端连接维持服务器在线，并提供统一的实时监控界面。\n\n## 能力一览\n\n- **多服务器管理**：通过 `SERVERS_JSON` 环境变量一次性配置多台 MC 服务器，自动为每台服务器创建对应机器人连接\n- **智能重连**：内置连接超时监控，30 秒后自动重连\n- **实时监控面板**：各机器人运行状态即时刷新，统一管理\n- **多实例并发**：同一服务器可同时连接多个机器人\n- **行为可配置**：通过 `CHAT` 与 `MOVE` 环境变量控制机器人的聊天与移动行为\n\n## 快速上手\n\n### 方式一：npx 直接运行\n\n```bash\nexport SERVERS_JSON='[{\"host\":\"mc-yy.io\",\"port\":25565}]'\nnpx @baipiaojuntuan/mcbots\n```\n\n### 方式二：Node.js 项目\n\n创建 `index.js`，将地址端口替换为你的服务器（可添加多台）：\n\n```js\nprocess.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\"}]';\n\nconst { initialize, shutdown } = require('@baipiaojuntuan/mcbots');\n\ninitialize().then(() => {\n  console.log('mcbots start successed');\n}).catch(err => {\n  console.error('mcbots start fail:', err);\n});\n\nprocess.on('SIGINT', shutdown);\nprocess.on('SIGTERM', shutdown);\n```\n\n配套 `package.json`：\n\n```json\n{\n  \"name\": \"mc\",\n  \"version\": \"1.0.0\",\n  \"description\": \"mcbots\",\n  \"main\": \"index.js\",\n  \"scripts\": {\n    \"start\": \"node index.js\"\n  },\n  \"dependencies\": {\n    \"@baipiaojuntuan/mcbots\": \"latest\"\n  }\n}\n```\n\n启动：\n\n```bash\nnpm install && npm run start\n```\n\n### 方式三：Docker\n\n```bash\ndocker run -d \\\n  --name mcbot \\\n  -e SERVERS_JSON='[{\"host\":\"mc-yy.io\",\"port\":25565,\"minBots\":1,\"maxBots\":3},{\"host\":\"mc-xx.io\",\"port\":25565,\"minBots\":1,\"maxBots\":3}]' \\\n  -p 3000:3000 \\\n  mingli2038/mcbot:latest\n```\n\n## 版本更新记录\n\n- **1.2.8** 修复配置复制不准确的问题：此前复制的是配置 JSON 的初始值，现在复制的是正在运行的真实配置（环境变量 `SERVERS_JSON`）\n- **1.2.7** 支持通过 npx 直接执行\n- **1.2.6** mineflayer 升级至 4.35：可直连 1.21.8-1.21.11 离线模式服务器，无需兼容插件；MC 版本、最大/最小机器人数变为可选项（有默认值），MC 版本使用上游自动识别\n- **1.2.5** 支持服务备注，便于区分无域名的服务器\n- **1.2.4** 优化机器人断开逻辑，避免幽灵机器人\n- **实验功能**：`SERVER_JSON` 热更新，可能引发预期之外的问题；如需稳定使用，建议使用 1.1 版本\n\n## 监控面板\n\n页面底部新增修复入口：**【更新 MC 机器人配置】**\n\n该功能涉及服务器配置修改，所有操作均已加入认证保护。\n\n## 密钥配置\n\n- 默认密钥从 [Telegram 频道](https://t.me/boost/wanjulaji) 获取\n- 也支持环境变量自定义：\n  - `HOTUPDATE_SECRET`：设置密钥\n  - `HOTUPDATE_SALT`：加盐，防止彩虹表破解\n\n## 项目来源\n\n本项目的实现思路源自 Tweek 白嫖群成员 [这种事可以花点钱] 提供的镜像 [ghcr.io/oprmg/mcbot:latest](https://ghcr.io/oprmg/mcbot:latest)。作者通过 AI 对其实现进行重构并加入自己的想法后重新发布。\n","readmeFilename":"README.md","_rev":"1-5197e95f2872b89ce3f7cadd0bcaa39f"}