My Bot Mod(我的机器人)
一款面向 Minecraft 1.20–1.21.4 (Fabric) 的 Carpet 风格假人(bot)模组。生成行为如玩家的机器人,指挥它们执行任务,利用智能寻路发送指令,并可选择在登出后将其保留在世界中。同一个代码库可构建适用于所有七个受支持 Minecraft 版本的版本。
机器人通过原版的 placeNewPlayer 路径注册,因此计分板、传送以及其他原版玩家逻辑均可正常对其生效。完全双语支持——每条消息和 GUI 文本均提供英文与简体中文。
功能特性
- 生成、移除和控制假人
- 全面动作控制:攻击、使用、移动、跳跃、潜行、疾跑、看向、丢弃、切换手持物品、骑乘
- Command Baton(指令棒)——一种可制作的物品,带有屏幕 HUD。Ctrl+滚轮切换模式;右键某处以向选中的机器人发送寻路或传送指令
- 智能寻路:基于迭代/节点上限的单次 A* 算法,包含宽度感知路径平滑、游泳、跨沟壑、危险规避及卡住处理
- 行为脚本——通过类 Scratch 的 Blockly 编辑器为机器人编程(支持离线 HTML 编辑器或游戏内编辑器)。拥有 100+ 个积木块,支持多行为播放列表,数据可导出为 txt/JSON/CSV
- 右键点击机器人打开其面板:查看物品栏、末影箱、游戏模式、传送、删除,以及每个机器人的设置(7 种三态覆盖选项)
- 皮肤加载优先级从高到低依次为:Mojang API → 本地 PNG → Base64 编码 → 默认皮肤
- 可选持久化:离开世界后机器人仍保留在原处,且其所在区块在各维度间保持加载状态
- 三种配置方式——游戏内 GUI(B 键)、
/botmod config命令,或 JSON 配置文件
行为编辑器(editor.zip)
离线 Blockly 行为编辑器为可选单独下载组件——请在此获取:
下载 editor.zip(直链,约 277 KB)
该文件也附带于每个 1.3.3 版本条目中——打开任意版本页面,查看 Files → Additional files 部分即可找到。
将其解压至任意位置,在浏览器中打开 editor/behavior-editor.html(完全离线),使用 100+ 个类 Scratch 积木块构建行为,将生成的 .json 文件保存至 .minecraft/config/my-bot-mod/behaviors/,随后在游戏中为其分配给某个机器人。自 v1.3.3 起,游戏内也内置了编辑器(右键机器人 → Behavior Management → New Behavior),因此 HTML 编辑器变为完全可选。
安装
选择与你的 Minecraft 版本匹配的 JAR 文件——文件名后缀会提示你应选用哪一个:
| 文件后缀 | Minecraft | Java |
|---|---|---|
+1.20.1 |
1.20 – 1.20.1 | 17+ |
+1.20.2 |
1.20.2 | 17+ |
+1.20.4 |
1.20.3 – 1.20.4 | 17+ |
+1.20.6 |
1.20.5 – 1.20.6 | 21+ |
+1.21.1 |
1.21 – 1.21.1 | 21+ |
+1.21.3 |
1.21.2 – 1.21.3 | 21+ |
+1.21.4 |
1.21.4 | 21+ |
需要 Fabric Loader 0.19.2+、Fabric API 和 Java 17+(1.20.5 及以上版本需 Java 21+)。支持单人游戏和服务器(两端均需安装)。
链接
源代码与发布版本 (GitHub) · 指令 · 行为 · 配置 · 常见问题
简体中文
一款类似 Carpet Mod 的假人模组,适用于 Minecraft 1.20–1.21.4 Fabric。可以召唤表现如普通玩家的假人、指挥它们执行操作、通过寻路将它们派往远处,退出世界后还可选择将假人保留在世界中。单个代码库同时构建七个游戏版本。
假人通过原版 placeNewPlayer 流程注册,计分板、传送等原版玩家逻辑对其正常生效。所有消息和界面文本均提供中英文。
功能
- 创建、删除、控制假人
- 动作控制:攻击、使用物品、移动、跳跃、潜行、疾跑、视角切换、丢弃物品、换手持物品、骑乘
- 指挥棒:由两根木棍合成,手持时显示 HUD。Ctrl+滚轮切换模式,右键某处使选中的假人寻路或传送至该位置
- 寻路:一次性 A* 搜索(迭代次数/节点数设有硬性上限),具备宽度感知路径平滑、游泳、跨越裂谷、危险规避及卡住处理功能
- 行为脚本:类 Scratch 的 Blockly 编辑器(支持离线 HTML 编辑器或游戏内编辑器),拥有 100+ 积木块;支持在游戏内分配播放列表,数据可导出为 txt/JSON/CSV 格式
- 右键假人打开面板:背包、末影箱、游戏模式、传送、删除,以及每项假人独有的 7 项三态个人设置
- 皮肤加载按 Mojang API、本地 PNG、Base64、默认皮肤的顺序进行回退
- 可选驻留:退出世界后假人得以保留,所在区块跨维度保持加载状态
- 配置方式三选一:游戏内界面(B 键)、
/botmod config命令、JSON 文件
行为编辑器(editor.zip)
离线 Blockly 行为编辑器是可选的独立下载,在此获取:
点击下载 editor.zip(直链,约 277 KB)
它同时也附带在每个 1.3.3 版本条目下——打开任意版本页面,在 Files → Additional files 中即可找到。
解压至任意位置,用浏览器打开 editor/behavior-editor.html(完全离线),使用 100+ 类 Scratch 积木编排行为,将保存的 .json 文件放入 .minecraft/config/my-bot-mod/behaviors/,随后在游戏中分配给假人。从 v1.3.3 起也提供了游戏内编辑器(右键假人 → 行为管理 → 新建行为),HTML 编辑器为完全可选。
安装
根据游戏版本选择对应的 JAR 文件,文件名后缀标明了适用范围:
| 文件后缀 | Minecraft | Java |
|---|---|---|
+1.20.1 |
1.20 – 1.20.1 | 17+ |
+1.20.2 |
1.20.2 | 17+ |
+1.20.4 |
1.20.3 – 1.20.4 | 17+ |
+1.20.6 |
1.20.5 – 1.20.6 | 21+ |
+1.21.1 |
1.21 – 1.21.1 | 21+ |
+1.21.3 |
1.21.2 – 1.21.3 | 21+ |
+1.21.4 |
1.21.4 | 21+ |
需要 Fabric Loader 0.19.2+、Fabric API 和 Java 17+(1.20.5 及以上版本需 Java 21+)。支持单人游戏和服务器(两端均需安装)。
链接
源码与发布(GitHub) · 命令参考 · 行为系统 · 配置指南 · 常见问题
My Bot Mod (我的机器人)
A Carpet-style fake player (bot) mod for Minecraft 1.20–1.21.4 (Fabric). Spawn bots that behave like players, tell them what to do, send them off with smart pathfinding, and optionally keep them in the world after you log off. One codebase builds for all seven supported Minecraft versions.
Bots are registered through the vanilla placeNewPlayer path, so scoreboards, teleporting and other vanilla player logic work on them as usual. Fully bilingual — every message and GUI text comes in English and 简体中文.
Features
- Spawn, remove and control fake players
- Full action control: attack, use, move, jump, sneak, sprint, look, drop, swap hands, ride
- Command Baton — a craftable item with an on-screen HUD. Ctrl+Scroll switches modes; right-click somewhere to send the selected bot pathfinding or teleporting there
- Smart pathfinding: one-shot A* bounded by iteration/node caps, with width-aware path smoothing, swimming, gap-crossing, hazard avoidance and stuck handling
- Behavior scripts — program bots in a Scratch-like Blockly editor (offline HTML editor or the in-game editor). 100+ blocks, multi-behavior playlists, data export to txt/JSON/CSV
- Right-click a bot for its panel: inventory, ender chest, game mode, teleport, delete, plus per-bot settings (7 tri-state overrides)
- Skins fall back from Mojang API to local PNG to Base64 to the default skin
- Optional persistence: bots stay in the world after you leave, with their chunks kept loaded across dimensions
- Configure things three ways — the in-game GUI (B key),
/botmod configcommands, or the JSON file
Behavior editor (editor.zip)
The offline Blockly behavior editor is an optional separate download — grab it here:
Download editor.zip (direct link, ~277 KB)
It's also attached to every 1.3.3 version entry — open any version page and look under Files → Additional files.
Unzip it anywhere, open editor/behavior-editor.html in your browser (fully offline), build behaviors with 100+ Scratch-like blocks, save the .json into .minecraft/config/my-bot-mod/behaviors/, then assign it to a bot in game. Since v1.3.3 there's also an in-game editor (right-click a bot → Behavior Management → New Behavior), so the HTML editor is entirely optional.
Installation
Pick the JAR matching your Minecraft version — the suffix in the file name tells you which one to take:
| File suffix | Minecraft | Java |
|---|---|---|
+1.20.1 |
1.20 – 1.20.1 | 17+ |
+1.20.2 |
1.20.2 | 17+ |
+1.20.4 |
1.20.3 – 1.20.4 | 17+ |
+1.20.6 |
1.20.5 – 1.20.6 | 21+ |
+1.21.1 |
1.21 – 1.21.1 | 21+ |
+1.21.3 |
1.21.2 – 1.21.3 | 21+ |
+1.21.4 |
1.21.4 | 21+ |
Requires Fabric Loader 0.19.2+, Fabric API, and Java 17+ (Java 21+ on 1.20.5 and later). Works in singleplayer and on servers (install on both sides).
Links
Source code & releases (GitHub) · Commands · Behaviors · Config · FAQ
简体中文
一个类似 Carpet Mod 的假人模组,用于 Minecraft 1.20–1.21.4 Fabric。可以召唤表现如普通玩家的假人、指挥它们做事、用寻路把它们派到远处,退出世界后还能(可选)把它们留在世界里。单代码库同时构建七个游戏版本。
假人走原版 placeNewPlayer 流程注册,计分板、传送这些原版玩家逻辑对它照常生效。所有消息和界面文本都有中英文。
功能
- 创建、删除、控制假人
- 动作控制:攻击、使用、移动、跳跃、潜行、疾跑、视角、丢物、换手、骑乘
- 指挥棒:两根木棍合成,手持时有 HUD。Ctrl+滚轮切换模式,右键某处让选中的假人寻路或传送过去
- 寻路:一次性 A* 搜索(迭代/节点有硬上限),带宽度感知的路径平滑、游泳、跨裂谷、危险规避和卡住处理
- 行为脚本:类 Scratch 的 Blockly 编辑器(离线 HTML 编辑器或游戏内编辑器),100+ 积木;游戏内分配播放列表,数据可导出为 txt/JSON/CSV
- 右键假人打开面板:背包、末影箱、游戏模式、传送、删除,还有每假人 7 项三态个人设置
- 皮肤按 Mojang API、本地 PNG、Base64、默认的顺序回退
- 可选驻留:退出世界后假人保留,所在区块跨维度保持加载
- 配置三选一:游戏内界面(B 键)、
/botmod config命令、JSON 文件
行为编辑器(editor.zip)
离线 Blockly 行为编辑器是可选的独立下载,在这里获取:
点此下载 editor.zip(直链,约 277 KB)
它也附加在每一个 1.3.3 版本条目下——打开任意版本页,在 Files → Additional files 里可以找到。
解压到任意位置,用浏览器打开 editor/behavior-editor.html(完全离线),用 100+ 类 Scratch 积木编排行为,把保存的 .json 放进 .minecraft/config/my-bot-mod/behaviors/,再到游戏内分配给假人。v1.3.3 起也有游戏内编辑器(右键假人 → 行为管理 → 新建行为),HTML 编辑器完全可选。
安装
按游戏版本选对应的 JAR,文件名后缀标明了适用范围:
| 文件后缀 | Minecraft | Java |
|---|---|---|
+1.20.1 |
1.20 – 1.20.1 | 17+ |
+1.20.2 |
1.20.2 | 17+ |
+1.20.4 |
1.20.3 – 1.20.4 | 17+ |
+1.20.6 |
1.20.5 – 1.20.6 | 21+ |
+1.21.1 |
1.21 – 1.21.1 | 21+ |
+1.21.3 |
1.21.2 – 1.21.3 | 21+ |
+1.21.4 |
1.21.4 | 21+ |
需要 Fabric Loader 0.19.2+、Fabric API 和 Java 17+(1.20.5 及以上要 Java 21+)。单人和服务器都能用(两端都要装)。
链接
源码与发布(GitHub) · 命令参考 · 行为系统 · 配置指南 · 常见问题
下载 my-bot-mod
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 my-bot-mod
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 my-bot-mod
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 my-bot-mod
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 my-bot-mod
下载 my-bot-mod
下载 my-bot-mod
v1.3.3 — Minecraft 1.20–1.20.4 · 游戏内行为编辑器 · 智能路径平滑
三个版本专用的 JAR 文件——请选择与你的 Minecraft 版本匹配的那个。需要 Java 17+。本版本未发布适用于 Minecraft 1.20.5–1.21.4(基于 Java 21+)的构建;仅支持 1.20–1.20.4。
行为编辑器 (editor.zip) —— 可选的离线 Blockly 编辑器:从 GitHub 发行版下载,或在任意 1.3.3 版本的页面中点击 Files → Additional files 获取。解压后,在浏览器中打开 editor/behavior-editor.html,使用 100 多个类似 Scratch 的模块构建行为,将生成的 .json 文件保存至 .minecraft/config/my-bot-mod/behaviors/,然后在游戏中将其分配给机器人。(v1.3.3 还增加了游戏内编辑器,因此 HTML 编辑器完全是可选的。)
亮点
- 多版本构建系统 —— 工具链已升级至 Gradle 9.7 + Fabric Loom 1.17.19;通过 Stonecutter 条件注释,单一代码库即可构建所有目标平台。本次更新发布了 1.20.1、1.20.2 和 1.20.4 的 JAR 包(对应 Minecraft 1.20–1.20.4)。
- 游戏内行为编辑器 —— 无需离开游戏即可编写行为:包含分类面板、语句列表、参数表单以及用于嵌套控制流的面包屑导航;输出结果与 HTML 编辑器完全兼容。“保存”操作会将行为写入行为文件夹并热重载。
- 新增导出模块 ——
outputRaw(原始行)、outputTemplate(带有{time}{bot}{var:name}占位符的自定义模板)、outputTable(自定义表头 + 逐行追加 CSV);现有的输出模块获得了追加/覆盖写入模式。 - 行为执行 UI 重构 —— 带有队列进度(x/y)的实时状态栏、播放列表 ▲▼ 重排序 / 移除 / 清空全部、行为搜索框,以及每行的“仅运行此项”和编辑快捷键。
- 创造模式飞行继承 —— 在半空中召唤的机器人也会进入飞行状态;状态通过 preserveBotState 持久化保存。
- 末影箱 ——
/bot <name> enderchest命令可打开机器人的真实末影箱以进行实时编辑,关闭时自动保存。 - 智能路径平滑 (
pathfindingSmooth, 默认开启) —— 基于宽度感知的视线合并航点;跳跃/坠落/游泳锚点及峡谷不受影响。
寻路重构
- 寻路器重写为同步优化的 A* 算法,设有硬性上限(15000 次迭代 / 25000 个节点);原有的字符串拉拽式平滑处理已被基于宽度感知的智能平滑所取代。
移除项
- 彻底移除了分组与协同建造系统:
/botmod group *和/bot <name> build *命令、相关 UI、行为模块及配置选项。 - 移除了 Carpet 兼容模式 (
carpetModCompatibility):该模组现在可以与 Carpet 共存安装。 - 移除了对非创造模式下权杖传送的限制 (
allowBatonTeleportNonCreative);删除了死代码(onMessage事件、无效的configMenuKey)。
错误修复
- 右键面板中的“删除假人”按钮现在真正生效了(通过新增的
/bot <name> kill confirm,并附带严格验证的确认窗口)。 - 皮肤优先级已修复:本地
skins/目录下的 PNG 文件和 Base64 编码皮肤现在优先于 Mojang API——离线模式下不再因网络超时而卡住。 - 游戏内行为编辑器的界面文本现已完全本地化(支持英文/中文)。
- 行为脚本异常不再导致服务器 Tick 崩溃;
broadcast不再重复执行两次;行为重启不再泄漏运行时资源;失败的createBot会回滚幽灵玩家;自动重生的假人在其他客户端上不再显示为死亡状态;交互射线会被方块遮挡;背包界面增加了同维度与距离检查;/botmod config set/get覆盖了之前缺失的 7 个选项;包含皮肤文件名路径遍历验证及并发安全的皮肤缓存。
完整更新日志:CHANGELOG.md · 行为指南:BEHAVIORS.md
Simplified Chinese
v1.3.3 — 支持 Minecraft 1.20–1.20.4 · 游戏内行为编辑器 · 智能路径平滑
共提供 3 个对应版本的 JAR 文件,请根据你的 Minecraft 版本进行选择。需要 Java 17+。本次发布不包含 Minecraft 1.20.5–1.21.4(这些版本需 Java 21+ 构建目标),仅支持 1.20–1.20.4。
行为编辑器(editor.zip)——可选的离线 Blockly 编辑器:GitHub 下载,或在任意 1.3.3 版本页面的 Files → Additional files 中获取。解压后使用浏览器打开 editor/behavior-editor.html,利用 100+ 积木块编排行为,将生成的 .json 文件保存到 .minecraft/config/my-bot-mod/behaviors/,即可在游戏内分配给假人。(v1.3.3 也新增了游戏内编辑器,HTML 编辑器完全是可选的。)
主要更新内容
- 多版本构建升级:工具链已升级至 Gradle 9.7 + Fabric Loom 1.17.19,改用 Stonecutter 实现单代码库多版本构建。本版发布了 1.20.1、1.20.2、1.20.4 三个 JAR,覆盖 Minecraft 1.20–1.20.4。
- 游戏内行为编辑器:包含分类面板、语句列表、参数表单、嵌套控制流面包屑导航;产物与 HTML 编辑器完全兼容,保存即热重载,可导出到任意文件夹(服务端校验)。
- 新输出积木:
outputRaw(无前缀原始行)、outputTemplate(自定义模板,支持{time}{bot}{var:名}占位符)、outputTable(自定义表头 + 逐行追加 CSV);原有输出积木增加了追加/覆盖模式。 - 行为执行界面重做:实时状态行显示队列进度(x/y);播放列表支持 ▲▼ 排序、移除、一键清空;新增行为搜索框;每行均可单独快捷执行或直接进入编辑器。
- 创造飞行继承:在飞行状态下召唤的假人同样会进入飞行并悬停;状态随
preserveBotState一起保存。 - 末影箱:
/bot <名字> enderchest可直接绑定假人的末影箱进行实时编辑,关闭自动保存。 - 智能路径平滑(
pathfindingSmooth,默认开启):采用宽度感知视线法合并可直行路标点;跳跃/下落/游泳锚点与裂谷不受影响。
寻路重构
- 寻路器重写为同步一次性优化 A* 算法(硬上限为 15000 次迭代 / 25000 节点);移除了旧的 string-pulling 平滑功能,由宽度感知智能平滑取代。
移除的功能
- 编组与合作建造系统整体移除:包括
/botmod group *与/bot <名字> build *命令、相关界面、行为积木与配置项。 - 移除 Carpet 兼容模式(
carpetModCompatibility):可与 Carpet 同时安装,各自管理假人。 - 移除了指挥棒传送的创造模式限制(
allowBatonTeleportNonCreative);清理了死代码(从未实现的onMessage事件、无效的configMenuKey)。
BUG 修复
- 右键面板中的“删除假人”按钮现在真正生效了(走新增的
/bot <名字> kill confirm,确认窗口经过严格校验)。 - 修复皮肤优先级反了的问题:本地
skins/目录下的 PNG 和 Base64 皮肤优先于 Mojang API,离线模式下不再无谓等待网络超时。 - 行为编辑器界面文案全部改为从语言文件读取(此前为硬编码中文)。
- 行为脚本异常不再导致服务器 Tick 崩溃;
broadcast不再在同一 Tick 内双重执行;重复启动行为不再泄漏运行时资源;createBot失败时会回滚假玩家(不再有幽灵玩家);自动重生的假人在其他客户端上不再显示为死亡状态;交互射线会被方块遮挡;背包界面增加了同维度与距离校验;/botmod config set/get补齐了 7 个缺失的配置项;皮肤文件名增加了防路径穿越验证,缓存机制改为并发安全。
完整变更见 CHANGELOG.md,行为系统指南见 BEHAVIORS.md。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
缓冲的原始输入和线程化的事件轮询
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
原版世界生成优化模组
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
评论 0
登录后参与评分
还没有评论,来抢沙发吧