HELM
- By
Minecraft automation mod. Macros, pathfinding, combat, mining, farming. A better Baritone.
HELM is looking for people to beta test it.
Come join the HELM beta testing team on discord.
Join the Discord much love - vd
Table of Contents
- Features
- What the Pathfinder Handles
- Documentation
- Commands
- Installation
- Quick Start
- Roadmap
- Contributing
- License
Features
| Feature | Description |
|---|---|
| Macro files | Keys, mouse buttons, chat, commands, loops, waits, keybinds, cycles |
| Pathfinding | A* walking to coordinates. Jumps gaps, climbs, breaks through blocks, avoids cliffs and hazards |
| Precise locks | auto goto / auto look snap back the instant you drift |
| No-look pathing | Walk somewhere while your camera stays free, or locked on a fixed view |
| Free camera | F6 detaches your view so you can watch the bot from behind or fly around it freely, with wall collision and smoothing |
| Second camera | A real second render of the world from the bot's aim, shown as an inset |
| Attacking | Find, chase and kill mobs by name or category, with spam or crit mode |
| Following | Follow any mob or player as it moves |
| In-game macro editor | Create, edit and reorder macros from chat, no file juggling |
| Automatic tool selection | Equips the right tool for whatever it is breaking, scored the way Baritone does, and puts yours back afterwards |
| Getting out of a cave | /helm go-up pillars to the overworld, and steers around lava and water instead of balking under it |
| Tunnelling | /helm tunnelforward mines a tunnel ahead at the size you are already in, and stops at a fall, lava or water |
| Farming | /helm farm harvests ripe crops, collects the drops and replants from seed or produce |
| Biome and structure search | /helm lookfor walks you to the nearest biome, or locates a structure and walks you there |
| Automatic eating | /helm autoeat eats before you starve, off by default, with a food buffer and hurt-aware thresholds |
| Doors and torches | Opens doors in the way, shuts them behind, and lights tunnels as it digs |
| Debug tooling | Path status, position, chunk cache inspection and live path rendering |
What the Pathfinder Handles
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Flat walking, diagonals and sprinting with proper run-ups
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> 1 block step-ups and safe 3 block drops
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Parkour across 1 to 4 block gaps
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Pillaring up when you carry throwaway blocks
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Choosing between a tower and a mined step by what it costs, not by habit
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Water bucket clutches for big falls
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Edge sneaking along cliff ledges
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Breaking through walls when it beats detouring
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Walking on closed trapdoors and bottom slabs, walking through thin snow
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Swimming
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Hazard avoidance: fire, cactus, magma, cobwebs, dripstone, powder snow
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Exploring toward goals in unloaded chunks
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Live path rendering
Full breakdown in docs/FEATURES.md.
Documentation
| File | Contents |
|---|---|
| docs/FEATURES.md | What each feature does and how it works |
| docs/USAGE.md | Installation, every command, full macro syntax |
| docs/MACROS.md | Macro file prefix reference |
| docs/BUILDING.md | Building from source and troubleshooting |
Commands
Everything lives under /helm. Macro work sits under /helm macro.
| Command | Description |
|---|---|
/helm |
Help and list of your macros |
/helm macro |
Macro help and list of your macros |
/helm macro load <name> |
Runs a macro file |
/helm macro stop |
Stops everything and releases all inputs |
/helm macro create <name> |
Creates an empty macro and enters edit mode |
/helm macro edit <name> |
Opens an existing macro for editing |
/helm macro action add|remove|list|move |
Edits the actions of the open macro |
/helm attack |
Attacks all mobs |
/helm attack only <namespace:id...> |
Attacks only those, for example /helm attack only minecraft:zombie |
/helm follow [only] <name> |
Follows a mob or player |
/helm combatstop |
Stops attack/follow only |
/helm stop |
Stops everything at once and releases all inputs |
/helm mine <block...> |
Finds the nearest matching block and mines it |
/helm tunnelforward [width] [height] [length] |
Mines a tunnel ahead, defaulting to the tunnel you are already in |
/helm go-up |
Pillars straight up to the overworld surface |
/helm farm |
Harvests ripe crops, collects drops, replants |
/helm lookfor biomes [biome...] |
Walks to the nearest biome, or any different one |
/helm lookfor structures <id...> |
Locates a structure and walks to it |
/helm autoeat |
Toggles automatic eating, off by default |
/helm pathdebug walk <x> <y> <z> |
Tests pathfinding to a coordinate |
/helm set freecam <off|orbit|free> |
Detaches your view, F6 cycles the same modes |
/helm set secondcamera <true|false> |
Toggles the bot aim inset |
/helm set secondcamera orbit <true|false> |
Orbits your character and keeps looking at it |
The full command tree and macro file syntax are in docs/USAGE.md.
Installation
- Install Fabric Loader 0.19.3+ for Minecraft 26.2.
- Install Java 25. Required by 26.2, older versions will not start the game.
- Place
helm-26.2-2.5.6.jarandfabric-api-0.161.0+26.2.jarin.minecraft/mods/. - Launch the Fabric 26.2 profile and run
/helmin game.
Quick Start
Create macros/test.macro inside .minecraft/mods/:
goto 100 70 200
look at 153.5 / 14.2
hold left, wait 5s, release left
goto 0 70 0
attack zombieRun it with /helm macro load test. The macros/ folder is created automatically on the first /helm run.
Roadmap
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Mining to a target ore from the chunk cache
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> Automatic tool selection and eating
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Chest interaction and item sorting in macros
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> Multi goal routes (A then B then C in one run)
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;"> In-game path editor overlay
- <input type="checkbox" disabled style="margin: 0px 0.35em 0.25em -1.6em; vertical-align: middle;" checked> True second 3d client camera (experimental + requires sodium+iris mod.)
Contributing
Issues and pull requests are welcome. Bug reports should include reproduction steps, new features should come with a sample .macro demonstrating them.
License
Released under the MIT License.
The HELM Team
