my-bot-mod

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 placeNewPlayer path, 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+Scroll to 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.

• Teleport mode is Creative-only by default; open it up with allowBatonTeleportNonCreative, or require OP with batonRequiresOp.
• 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