Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Tags
Creators
Details
My Bot Mod (我的机器人)
A Carpet-style fake player (bot) mod for Minecraft 1.20–1.20.4 (Fabric). Spawn player-like bots, control their actions, send them around with smart pathfinding, and keep them in your world across restarts. One codebase, multiple Minecraft versions.
✨ Features
- 🤖 Bot management — create, remove and control fake players (registered via the vanilla
placeNewPlayerpath, so scoreboards, teleporting and other vanilla logic work normally) - 🎮 Action control — attack, use, move, jump, sneak, sprint, look, drop, swap hands, ride
- 🪄 Command Baton — a handheld item with an on-screen HUD;
Ctrl+Scrollto switch modes; command a bot to pathfind or teleport to wherever you look - 🗺️ Smart pathfinding — non-blocking, frame-sliced A* (no server lag), with swimming, gap-crossing, hazard avoidance and stuck-detour/give-up logic (same-dimension only)
- 🎒 Inventory / Ender Chest / settings panel — right-click a bot to edit its inventory, switch game mode, teleport, delete, and set per-bot options (7 tri-state overrides incl. glowing & fire immunity)
- 🎨 Skin system — Mojang API → local PNG → Base64 → default, with graceful fallback
- 💾 Bot persistence — bots can stay in the world after you leave (optional); their chunks stay loaded, across dimensions
- ⚙️ Configuration — in-game GUI (press B): browser-style tabs, crafting-table home page and a bilingual search box; plus commands + JSON file
- 🌏 Fully bilingual — every message and GUI text in English & 简体中文
- 🔧 Carpet compatible — auto-detects and avoids conflicts
📦 Installation
Supports Minecraft 1.20–1.20.4. Pick the file matching your version:
+1.20.1→ 1.20–1.20.1+1.20.2→ 1.20.2+1.20.4→ 1.20.3–1.20.4
Requires Fabric Loader 0.19.2+, Fabric API and Java 17+. Drop the JAR into .minecraft/mods.
🚀 Quick start
/bot Steve spawn # create a bot
/bot Steve goto 100 64 200 # pathfind to coordinates
/bot Steve attack continuous # keep attacking
/bot list # list bots
/bot Steve kill # remove a bot
Right-click a bot to open its panel (inventory / ender chest / game mode / teleport / delete + per-bot settings). Press B for the global config screen.
🪄 Command Baton
Crafted from two sticks; unstackable. While held, the top-left shows the current mode and the selected bot, and the top-right lists your bots.
| Action | Effect |
|---|---|
Ctrl + Scroll |
Switch mode (Pathfind / Teleport) |
Alt + Scroll / Alt + right-click a bot |
Select a bot |
Right-click somewhere |
Make the selected bot pathfind / teleport to that spot |
- Teleport mode is Creative-only by default; open it up with
allowBatonTeleportNonCreative, or require OP withbatonRequiresOp. - Cross-dimension: teleport works across dimensions; pathfinding is same-dimension only (cross-dimension orders are rejected).
⚙️ Configuration
Config file: config/my-bot-mod.json · Command: /botmod config · GUI: B key.
Common options: attack range, kill aura, max bot count, per-player limit, bot persistence, non-OP control (allowNonOpControlBot), baton permissions (allowBatonTeleportNonCreative, batonRequiresOp), pathfinding distance/parkour/swim toggles, glowing, fire immunity.
📄 License
MIT License. Author: Skyline_hcss. Source & issues: https://github.com/skylhcss/my-bot-mod
我的机器人 (中文说明)
一个类似 Carpet Mod 的**假人(机器人玩家)**模组,用于 Minecraft 1.20–1.20.4 Fabric。可召唤类玩家假人、控制其动作、用智能寻路指挥其移动,并让其在世界重启后保留。单代码库,多版本支持。
✨ 功能特性
- 🤖 假人管理:创建、删除、控制假人玩家(
placeNewPlayer规范注册,计分板/传送等原版逻辑正常) - 🎮 动作控制:攻击、使用、移动、跳跃、潜行、疾跑、视角、丢物、换手、骑乘
- 🪄 指挥棒:手持道具,四周 HUD 显示信息,
Ctrl+滚轮切模式,指挥假人寻路或传送到你看向的位置 - 🗺️ 智能寻路:非阻塞分帧 A*(不卡服),支持游泳、跨越裂谷、危险规避,卡住自动绕行/放弃(仅限同维度)
- 🎒 背包/末影箱/设置面板:右键假人打开,可编辑背包、切换游戏模式、传送、删除,并含每假人 7 项三态个人配置(含发光、免疫火焰)
- 🎨 皮肤系统:Mojang API → PNG → Base64 → 默认,三级回退
- 💾 假人驻留:退出世界后假人可保留(可选),跨维度区块保持加载
- ⚙️ 配置系统:图形界面(B 键)——浏览器式标签页、工作台风格主页、中英文搜索框;另有命令 + JSON 文件
- 🌏 完全双语:所有消息与界面文本均为中/英双语
- 🔧 Carpet 兼容:自动检测并避免冲突
📦 安装
支持 Minecraft 1.20–1.20.4,按版本选择对应文件:
+1.20.1→ 1.20–1.20.1+1.20.2→ 1.20.2+1.20.4→ 1.20.3–1.20.4
需 Fabric Loader 0.19.2+、Fabric API 与 Java 17+。将 JAR 放入 .minecraft/mods 即可。
🚀 快速开始
/bot Steve spawn # 创建假人
/bot Steve goto 100 64 200 # 寻路到坐标
/bot Steve attack continuous # 持续攻击
/bot list # 列出假人
/bot Steve kill # 删除假人
右键假人打开设置面板;按 B 键打开全局配置界面。
📄 许可证
MIT License。作者:Skyline_hcss。源码:https://github.com/skylhcss/my-bot-mod


