AI 制作声明：本项目采用生成式 AI 参与协议设计、编码、文档编写与测试；AI 生成或修改的内容均由项目维护者审阅、验证并承担最终维护责任。
声明：本项目的核心底层交互基于优秀的开源框架 mineflayer 开发，特此致谢！本项目主要致力于提供开箱即用的可视化 UI 界面，降低新手使用门槛。
本项目由 ARCbot 改版而来，在保留原有功能的基础上进行了重命名与大量功能增强。原 ARCbot 官网（bot.myarc.icu）已关闭，本仓库为当前维护版本。
欢迎使用 Bakabot！本指南将手把手教你如何通过控制面板快速配置并召唤你的专属 AI 机器人。
- NapCat DLL 完整性自检：QQ 功能页在「机器人 QQ 号」与「NapCat 协议端」之间新增手动「检验完整性」入口，点击后先弹窗确认，再主动检查 NapCat 依赖的 crypto.dll / ssl.dll 是否就位，并把完整检验结果展示在状态栏。若发现缺失，会按启动兜底逻辑自动补齐：先递归查找 NapCat 包内是否自带，找不到再从本机 QQ 安装目录复制（只复制、不移动、不覆盖已有文件），解决官方包漏打包导致的启动即报错问题。
- QQ 登录状态可视化（QQ 排查结果落地）：排查确认 v2.6.0 起的 QQ 代码链路正常，"QQ 用不了"的典型原因是机器人 QQ 号与 NapCat 本地登录会话不一致，NapCat 一直停在扫码阶段而未真正登录。新版会监听 NapCat 的登录输出：检测到"快速登录失败 / 请扫描二维码"时，状态栏明确显示"等待扫码登录"并给出二维码图片路径，不再把"进程已启动"误当成"QQ 已就绪"；扫码登录成功或 OneBot 连接建立后自动恢复正常状态。
- NapCat 运行库缺失兜底确认：NapCat 官方截至 v4.18.19 仍未修复 Windows 包漏打包 crypto.dll/ssl.dll 的问题；启动器启动前仍会自动补齐（包内优先，其次从本机 QQ 安装目录复制），缺失时日志会给出明确提示。
- 26.1 / 26.1.2 原生直连完善：修复机器人在 26.x 服务器"已自动接受资源包"后卡住不进服的问题——资源包响应改用兼容写法，服务器能正确收到确认并放行；同时适配 26.1 新增的多时钟时间包格式（clockUpdates），进服后不再因时间解析崩溃。配合已内置的 26.1 协议数据与配置阶段补包逻辑，机器人现在可以完整原生直连 26.1 / 26.1.2 服务器（协议 775），26.2 等更高版本仍走 ViaProxy 转换。
- MCP 接入集成进启动器：设置页新增 MCP 区块——支持本地 stdio 模式（外部 AI 以
Bakabot.exe --mcp-stdio直接拉起）与云端 HTTP 模式（启动器内置/mcp端点，可配 API Key 与 IP 白名单），支持 MCP 协议的 AI 客户端（Claude、Cursor 等）可自由操控机器人，无需再部署独立服务；访问 Token 首次开启自动生成、一键复制。 - QQ 只回 AI 消息：QQ 功能新增开关，开启后群里只回 AI 的回复，屏蔽其他行动播报/报错消息。
- @机器人 触发只认自己：群里只有 @到机器人本尊才会触发（@别人/@全体不再误触发），触发关键词不受影响。
- ViaProxy 使用提示：设置页启用 ViaProxy 处新增醒目提示——连接使用了 ViaVersion 的服务器时，请在正版账号界面选择确定版本或关闭 ViaProxy，避免双方自动兼容导致无法进服。
- 狂暴清障间隔自定义：行动设置新增"狂暴清障模式间隔"输入框（秒），可自定义狂暴模式的触发间隔。
- 挖矿下潜防摔：向下挖掘优先走寻路计算（A* 目标层），失败才回退直挖并预判深洞/岩浆/水，不再笔直下挖摔进洞穴。
- 界面与构建优化：启动器改为图形子系统，启动不再闪现黑色控制台窗口；开发/开源构建自动兼容更高版本 .NET 运行库，无需精确安装 .NET 8。
- 穿上/脱下装备：支持"穿上xx / 脱下xx / 脱下所有装备"指令，穿上会自动按物品类型穿到正确部位（头盔→头、胸甲/鞘翅→躯干、护腿→腿、靴子→脚），工具/武器/火把等非装备物品会拿在手上。
- 26.1 / 26.1.2 原生直连：两者协议号同为 775，基础包已内置协议数据，无需 ViaProxy、无需服务器安装 ViaVersion 即可直连；26.2 等更新版本仍走 ViaProxy 转换。
- OneBot 通用接入：新增"OneBot 接入"页，开放固定端口 6700 的 OneBot11 反向 WebSocket 通道，llbot、Lagrange 等外部协议端可直接接入（可选 Token 鉴权），与内置 NapCat 互斥运行，白名单/触发/转发逻辑完全一致。
- QQ 触发修复：修复配置触发关键词后仅 @机器人 不再生效的问题——现在 @机器人 始终有效，关键词作为可选触发，两者可同时使用。
- QQ 回复通道修复：修复 msg/私信模式下 QQ 回复失效的问题——系统/行动反馈等消息不再中途切走 QQ 回复通道，回复不再误走游戏内私信。
- 挖矿脱困优化：默认不再用垫方块（仅目标明显高于脚底时才允许垫脚），狂暴模式不再挖脚下方块，连续卡住自动触发狂暴脱困，避免垫脚死循环。
- 进服问候语开关：行动设置新增"进服问候语"开关，可关闭进服时的"主人好，底层框架已启动，等待指令！"提示。
- QQ 桥接接入：内置 NapCat 协议端（一键下载、启动器托管进程），通过 OneBot11 反向 WebSocket 与启动器通信；支持全局白名单（QQ 号 → 玩家名 / 绑定实例）、生效群聊与触发关键词、@机器人 唤起；AI 回复与行动播报可发回群里，游戏内与 QQ 各自独立回复。
- 命令提示词（纯关键词模式）：侧边栏新增"命令提示词"页，可配置关键词直达命令（如
!回→/home），支持全部或单个实例；游戏与 QQ 触发可分别设置屏蔽开关和行动播报开关。 - 行动设置拆分："登录自动传送"拆分为接受 TPA、自动登录、死亡 back 三个独立开关，新增"仅接受主人 TPA"开关与 TPA 触发关键词（不同服务器的消息格式也能兜底识别）。
- 挖矿逻辑优化：深层矿物优先下挖到目标层再开采，下挖与采集前自动切换合适工具，扫描半径不足时自动扩大并重扫。
- 切换手持物品：支持"切换空手 / 拿火把 / 拿钻石剑"等指令。
- 模型 ID 放宽：支持
minimaxai/minimax-m3这类带斜杠的格式，输入框校验与提示同步更新。 - 内置默认背景：内置预载背景图（pid:126375185），首次启动自动设为默认背景，"恢复默认（无背景）"仍可正常使用。
- 稳定性修复：思考模型整段输出
<think>内容导致的计划解析失败；调试台清屏导致实例失效的问题（日志恢复 5000 行上限，接收改为异步投递，UI 卡顿不再阻塞机器人进程）。
- 调试日志导出：主页每个实例可一键导出调试日志 txt（调试台记录 + 实例配置摘要 + 环境诊断信息，敏感字段自动脱敏），方便排查故障后直接反馈。
- 调试记录清理：实例卡片支持一键删除该实例的调试记录；主页顶部新增"一键删除调试记录"，可清空所有实例的调试台记录与 console.log（不影响实例数据）。
- 村民交易大幅增强：
- 支持指定具体附魔与等级交易附魔书（如
锋利5、enchanted_book mending、精准采集），机器人会精确匹配交易产出的附魔书，不再分不清附魔种类； - 找不到对应交易的村民会自动换下一个，全部没有才报错；
- 交易成功后自动确认到货并停止，不再出现"买到了还在继续找"的卡循环；
- 适配部分服务器交易后不回窗口更新包的情况（ViaVersion 转换服），超时也能正确判定交易结果。
- 支持指定具体附魔与等级交易附魔书（如
- 容器取物增强：按距离从近到远逐个打开箱子/木桶/潜影盒寻找目标物品，一个没有自动找下一个；支持
container_type限定只搜箱子 / 只搜木桶 / 只搜潜影盒。 - 投掷对准修复：丢物品给玩家前会先转身并等服务器确认，物品不再扔偏。
- 实体交互修复：右键村民交易、右键玩家互动改用带命中点的交互包，兼容 ViaVersion / ViaProxy 转换服。
- 界面改进：
- 设置页新增"改版作者 (Bakabot)"信息和 GitHub 按钮（跟随外观强调色）；
- 创建/编辑实例的端口输入框上方增加默认端口提示；
- 服务器配置区排版对齐优化。
- 首次改版发布：基于 ARCbot 重命名，内置 ViaProxy、第三方登录、视觉功能、微软登录引导、自动修补、外观个性化、自动更新、单文件独立版等。
- ViaProxy 协议代理内置：一键下载并启动 ViaProxy，机器人可接入任意版本的服务器（26.1 / 26.1.2 已原生直连，26.2 等更新版本经 ViaProxy 协议翻译进入）。程序自动在本地起代理并完成协议翻译，无需手动配置；还支持代理自动接受服务器强制资源包、使用正版账号登录正版验证服务器。
- 第三方登录支持:支持了第三方登录，皮肤站登录的服务器也可以开机器人了
- 视觉功能加入:可以填入支持图片的大模型，已达到使用机器人视觉功能的能力
- 微软登录智能引导：机器人进行微软账号认证时，程序会自动识别控制台输出的设备登录码，并弹出引导窗口，不用再手动翻控制台找验证码。
- 自动修补：下载的基础机器人包会自动注入 Bakabot 补丁（环境变量桥接、资源包自动接受、聊天触发模式等），开箱即用；支持使用自己的自定义基础包(可以去交流群下载)。
- 外观个性化：暗色模式切换、背景遮罩透明度调节、拖入图片即可更换背景、自定义按钮强调色。
- 软件自动更新：启动时自动检查新版本，弹窗提示一键下载安装，支持"跳过此版本"。
- 单文件独立版：可发布为单个 exe（自带运行时，无需安装 .NET），拷走即用。
- 数据目录平滑迁移：改名后首次启动会自动把旧
%APPDATA%/ARCbot下的实例、配置等数据整体迁移到%APPDATA%/Bakabot，点击"一键刷新"即可同步功能，老用户无缝升级。 - 体验优化增加了更多门禁与开关，优化了启动器界面，增加了本地的帮助文档，可以更快上手。
在开始创建机器人之前，请先进入设置页面完成基础环境的配置：
- 下载并安装 Node.js 运行时。
- 下载机器人运行所需的基础包。
- （可选）如需接入 26.2 等新版本服务器，在「协议代理」中下载 ViaProxy，并确认本机有 Java 17+（26.1 / 26.1.2 原生直连，无需 ViaProxy）。
- （推荐）直接点击一键下载把俩都装上
环境准备就绪后，回到首页点击创建机器人。接下来请根据提示填写各项配置：
- 服务器地址 (MC_HOST)：填写你要加入的服务器 IP（如果是你本地开的服务器，请填写
localhost）。 - 端口 (MC_PORT)：服务器端口（默认通常为
25565）。 - 版本 (MC_VERSION)：填写游戏版本。如果是代理/群组服务器，建议使用
1.20.1并配合 ViaVersion 插件跨版本；26.1 / 26.1.2 原生直连；26.2 等新版本服务器请开启内置的 ViaProxy 代理。 - 用户名 (MC_USERNAME)：给你的机器人起个名字（即它在游戏内的 ID）。
- 认证方式 (MC_AUTH_TYPE)：正版账号选择
microsoft，离线服务器选择offline。 - 登录密码 (MC_LOGIN_PASSWORD)：选填。如果服务器有登录插件（如 AuthMe），填入密码后机器人会自动执行
/l 密码进行登录。如果服务器没有密码请留空。 - 主人名称 (MC_OWNER_NAME)：填写你自己的游戏 ID。机器人非常忠诚，它只会听从主人的指令。
- API Key (LLM_API_KEY) & API URL：这是机器人的“大脑”，需要你自己购买并填写。
- 提示：如果不了解如何获取，可以询问 AI。推荐使用 DeepSeek，价格比较便宜，性价比极高。如果暂时无法购买，也可以去寻找提供免费体验额度的 API。
- 对话模式：
- 默认推荐使用 whisper（私聊模式），这需要服务器安装支持
/tell指令的插件。 - 如果服务器没有安装相关插件，请选择 public（公屏模式）。
- 默认推荐使用 whisper（私聊模式），这需要服务器安装支持
在行为设置中，你可以开启机器人的各种“被动本能”：
- 登录自动传送：已拆分为「接受 TPA」「自动登录」「死亡 back」三个开关——接受 TPA 会自动回应主人的传送请求（默认仅接受主人，可改为接受所有人）；自动登录会在进服后自动执行登录指令；死亡 back 会在死亡后自动回城。
- 你还可以根据需求勾选自动防御、自动进食、自动切换工具、自动丢弃垃圾等实用功能。
保存配置并创建后，启动机器人，它应该就能成功加入游戏了！
⚠️ 注意：机器人加入游戏时可能会触发某些服务器的反作弊系统。如果被踢出，请检查服务器的反作弊设置或调整机器人的行为频率。
- 游戏内指令：如果使用的是
whisper模式，请在游戏聊天框输入：例如：/tell <机器人名字> <你想让它做的事>/tell MyBot 过来一下或/tell MyBot 帮我挖32个铁矿石（注意：机器人只听主人的话！） - 控制台交互：你在控制台输入的所有内容，都会被机器人直接发送到游戏中。
你的机器人接入了 AI 大脑，你可以直接用自然语言（大白话）给它下达指令！以下是一些常用的指令示例：
- 移动与跟随：过来一下 / 跟着我 / 去坐标 100 64 -200 那里等我
- 采集与挖掘：帮我挖32个铁矿石 / 去附近砍一组橡木原木 / 去附近帮我剪点羊毛
- 加工与合成：帮我合成一个工作台并放下 / 帮我把身上的粗铁烧成32个铁锭
- 组合任务：帮我挖3个铁矿，找点煤炭，然后烧成3个铁锭
- 建筑与破坏：在你脚下放一个箱子 / 帮我用橡木木板把坐标 0 64 0 到 10 64 10 这片区域填平
- 农业与养殖：帮我把这些种子种下去 / 用骨粉把附近的庄稼催熟一下 / 拿点小麦去喂一下附近的牛
- 战斗与安保：去帮我杀几只僵尸 / 去揍那个叫 Steve 的玩家 / 在附近30格范围内巡逻一下
- 物品管理：把你身上的东西都放进箱子里 / 从箱子里帮我拿一组钻石出来 / 扔给我一把剑
在复杂的 Minecraft 世界中，机器人偶尔也会遇到一些小麻烦，你可以用以下指令控制它：
- 卡住不动了？ 机器人底层有“自动脱困”机制，通常稍微等待一下即可。
- 任务执行失败 / 卡循环？
- 发送
/tell <机器人名字> retry：让机器人重新尝试当前任务。 - 发送
/tell <机器人名字> skip：跳过当前任务，执行下一步。
- 发送
- 想让它立刻停下？
- 发送
/tell <机器人名字> stop：机器人会紧急刹车并清空当前的任务计划。
- 发送
- 遇到无法解决的 Bug？
- 直接在面板关闭机器人然后重新开启即可，重启能解决 99% 的问题！
- 底层机器人框架：mineflayer
- 协议代理：ViaProxy（ViaVersion 团队）
- 前身项目：ARCbot
快去服务器里召唤你的专属赛博打工人吧！祝你游玩愉快！