my-bot-mod

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 config commands, 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） · 命令参考 · 行为系统 · 配置指南 · 常见问题