1.3.3+1.20.4
Compatibility
Required content
Changes
v1.3.3 — Minecraft 1.20–1.20.4 · In-game behavior editor · Smart path smoothing
Three version-specific JARs — pick the one matching your Minecraft version. Requires Java 17+. Builds for Minecraft 1.20.5–1.21.4 (Java 21+ targets) are not published for this release; only 1.20–1.20.4 is supported.
Behavior editor (editor.zip) — the optional offline Blockly editor: download from GitHub release, or grab it under Files → Additional files on any 1.3.3 version page. Unzip it, open editor/behavior-editor.html in your browser, 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. (v1.3.3 also adds an in-game editor, so the HTML editor is entirely optional.)
Highlights
- Multi-version build system — toolchain upgraded to Gradle 9.7 + Fabric Loom 1.17.19; one codebase builds every target via Stonecutter conditional comments. This release publishes 1.20.1, 1.20.2 and 1.20.4 JARs (Minecraft 1.20–1.20.4).
- In-game behavior editor — write behaviors without leaving the game: category panel, statement list, parameter forms, breadcrumb navigation for nested control flow; output fully compatible with the HTML editor. "Save" writes to the behaviors folder and hot-reloads.
- New export blocks —
outputRaw(raw line),outputTemplate(custom template with{time}{bot}{var:name}placeholders),outputTable(custom header + row-append CSV); existing output blocks gain append/overwrite write modes. - Behavior execution UI rework — live status line with queue progress (x/y), playlist ▲▼ reorder / remove / clear-all, behavior search box, per-row "run only this" and edit shortcuts.
- Creative flight inheritance — bots summoned mid-flight enter flight too; state persisted with preserveBotState.
- Ender chest —
/bot <name> enderchestopens the bot's real ender chest for live editing, auto-saved on close. - Smart path smoothing (
pathfindingSmooth, default on) — width-aware line-of-sight merging of waypoints; jump/fall/swim anchors and ravines unaffected.
Pathfinding rework
- Pathfinder rewritten as a synchronous optimized A* with hard caps (15000 iterations / 25000 nodes); old string-pulling smoothing removed in favor of the width-aware smart smoothing.
Removals
- Group & cooperative building system fully removed:
/botmod group *and/bot <name> build *commands, related UIs, behavior blocks and config options. - Carpet compatibility mode removed (
carpetModCompatibility): the mod can be installed alongside Carpet. - Creative-mode restriction on baton teleport removed (
allowBatonTeleportNonCreative); dead code removed (onMessageevent, ineffectiveconfigMenuKey).
Bug fixes
- Right-click panel "Delete bot" button now actually works (via new
/bot <name> kill confirmwith strictly validated confirmation window). - Skin priority fixed: local
skins/PNG and Base64 skins now take precedence over the Mojang API — offline play no longer stalls on network timeouts. - In-game behavior editor UI text is now fully localized (EN/中文).
- Behavior script exceptions no longer crash the server tick;
broadcastno longer double-executes; behavior restarts no longer leak runtimes; failedcreateBotrolls back ghost players; auto-respawned bots no longer appear dead on other clients; interaction rays are occluded by blocks; backpack UI gains same-dimension & distance checks;/botmod config set/getcovers 7 previously missing options; skin filename traversal validation and concurrent-safe skin cache.
Full changelog: CHANGELOG.md · Behavior guide: BEHAVIORS.md
简体中文
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 版本页的 文件 → 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。
Supplementary resources
| File | Type | Size | |
|---|---|---|---|
| editor.zip | Unknown | 276.63 KiB |
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:IAQ9c3zf:8qqLO5Ks"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:IAQ9c3zf:8qqLO5Ks"
}

