{"_id":"@baipiaojuntuan/mcbot","name":"@baipiaojuntuan/mcbot","dist-tags":{"latest":"1.0.8"},"versions":{"1.0.8":{"name":"@baipiaojuntuan/mcbot","version":"1.0.8","main":"index.js","private":false,"scripts":{"test":"echo \"Error: no test specified\" && exit 1","start":"node index.js"},"bin":{"npm-mcbot":"index.js"},"keywords":["minecraft","bot","mineflayer","automation","ai"],"author":{"name":"mingli2038"},"license":"MIT","publishConfig":{"access":"public"},"description":"Minecraft 服务器保活机器人：以 Node.js 模拟客户端持续在线，防止资源回收策略激进的免费主机将空闲的 Paper 服务器休眠。适用于自动关机策略严格的托管环境。","dependencies":{"mineflayer":"^4.35.0","mineflayer-pathfinder":"^2.4.5","pm2":"^6.0.8","vec3":"^0.1.10"},"engines":{"node":">=18"},"_id":"@baipiaojuntuan/mcbot@1.0.8","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-GVmuQGNeQ051oQzTFwvFG+SuP4avCJSSsu9lrRZsTgUQ6VXVyNt55xHy975k0K4FZoB/8QfTMIBe7IyYuCPSoQ==","shasum":"68c3e42ed5978cca1609338b10a47b72b4498d6b","tarball":"https://registry.npmjs.org/@baipiaojuntuan/mcbot/-/mcbot-1.0.8.tgz","fileCount":3,"unpackedSize":11415,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIDQFRxuRjRHzrgUwFtN4wXbWW+YHaSh0c1IVf3mnMZduAiAAvs/1voKkSTXfCwbfiTZL//GENrsHUhniNsRHlchVTA=="}]},"_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/mcbot_1.0.8_1788538784938_0.397136104252126"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-04T16:19:44.768Z","1.0.8":"2026-09-04T16:19:45.064Z","modified":"2026-09-04T16:19:45.277Z"},"maintainers":[{"name":"jdwan","email":"mlr95lflnq@outlook.com"}],"description":"Minecraft 服务器保活机器人：以 Node.js 模拟客户端持续在线，防止资源回收策略激进的免费主机将空闲的 Paper 服务器休眠。适用于自动关机策略严格的托管环境。","keywords":["minecraft","bot","mineflayer","automation","ai"],"author":{"name":"mingli2038"},"license":"MIT","readme":"# @baipiaojuntuan/mcbot\n\nMinecraft 服务器保活机器人：以 Node.js 模拟客户端持续在线，防止资源回收策略激进的免费主机将空闲的 Paper 服务器休眠。适用于自动关机策略严格的托管环境。\n\n## 特性\n\n- 模拟 Minecraft 客户端保活连接，阻止服务器进入休眠\n- 支持命令行参数与环境变量两种配置方式\n- 未指定版本号时自动识别服务器版本\n- 可通过 PM2 常驻守护，进程异常退出自动拉起\n- 支持多节点部署，提升保活可靠性\n\n## 安装\n\n```bash\nnpm i @baipiaojuntuan/mcbot\n```\n\n## 使用\n\n新建 `index.js`：\n\n```js\nprocess.env.HOST = 'emerald.magmanode.com'; // 服务器地址\nprocess.env.PORT = 34356;                   // 端口，默认 25565\nprocess.env.USERNAME = 'happybird';         // 玩家名（可选）\nprocess.env.MCVERSION = '1.20.1';           // 版本号（可选，留空自动识别）\nconst mcbot = require('@baipiaojuntuan/mcbot');\n```\n\n启动：\n\n```bash\nnode index.js\n```\n\n看到 `✅ Bot 已成功登录 Minecraft 服务器` 即表示连接成功。\n\n## 守护进程\n\n推荐使用 PM2 防止机器人意外退出：\n\n```bash\nnpx pm2 start index.js --name mcbot\n```\n\n## 服务端配置\n\n确保 `server.properties` 包含以下设置：\n\n| 配置项 | 值 | 作用 |\n| --- | --- | --- |\n| `online-mode` | `false` | 关闭在线验证，允许非正版客户端连接 |\n| `difficulty` | `peaceful` | 和平模式，避免机器人被击杀导致频繁重连 |\n| `white-list` | `false` | 关闭白名单，任何玩家可加入 |\n\n## 旧版本客户端兼容\n\n在服务端 `plugins` 目录放入兼容插件即可支持旧版 MC 客户端：\n\n下载链接：https://drive.google.com/file/d/1-o0zb5P144n-_KX2hPUBrae_2xyTTMk9/view?usp=drive_link\n\n## 参考文档\n\n详细配置与进阶技巧：https://liming.hidns.vip/index.php/archives/59/\n\n## 部署建议\n\n- 至少部署 3 台 512MB+ 内存的 Node.js 主机，多节点协同增强保活效果\n- 可配合 Tampermonkey 脚本实现自动唤醒机制（详见教程）\n\n## 快速验证\n\n```bash\nnpx @baipiaojuntuan/mcbot <host> <port> <playername> <mcversion>\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-62f9baf7349fd9f5f15e88c86c8e4636"}