MineFlow

MineFlow

File Details

Mine Flow 1.2.0

  • R
  • May 29, 2026
  • 31.27 KB
  • 0
  • 1.21.10
  • NeoForge

File Name

mineflow-1.2.0.jar

Supported Versions

  • 1.21.10

Curse Maven Snippet

NeoForge

implementation "curse.maven:mineflow-1557028:8166900"
Curse Maven does not yet support mods that have disabled 3rd party sharing

Learn more about Curse Maven

✨ Features

  • 🤖 Fully autonomous mining — scans nearby blocks, walks to them, aims and breaks automatically
  • 🎯 Custom target block list — mine any block(s) you want, including modded blocks
  • 🔦 Auto torch placement — places torches automatically when the area is completely dark (light = 0)
  • ⚔️ XP Farm mode — stays in place and attacks nearby mobs on cooldown to grind XP
  • 📦 Auto chest dump — walks to a configured chest and deposits mined blocks when inventory is full, then resumes mining
  • 🔧 Auto tool selection — automatically switches to the best tool in your hotbar for each block
  • 🧱 Obstacle avoidance — detects walls, steps up blocks, and reroutes automatically
  • ⚠️ Stuck detection — if the bot gets stuck it jumps and changes direction; if stuck twice it triggers a random escape maneuver
  • 🛑 Auto-stop: inventory full — stops and notifies when no free slots remain (unless a chest is configured)
  • 🛑 Auto-stop: low durability — stops when your held tool drops below 5% durability
  • 🚫 No cheats required — works on any client without server-side permissions or LAN mode
  • 💾 Persistent config — your target list, mode, torch threshold and chest position are saved to config/mineflow.json

🎮 Modes

Mode Description
⛏️ Mine Wanders and breaks all configured target blocks within 8 blocks
🔦 Torch Same as Mine, but also places torches when light level reaches 0
⚔️ XP Farm Stands still and attacks nearby mobs on attack cooldown for XP grinding

🎮 Usage

Keybind

Key Action
G Toggle bot on / off

Commands

Command Description
/mineflow mine Start mining mode
/mineflow xp Start XP farm mode
/mineflow torch Start torch mode (mine + place torches in the dark)
/mineflow torch light <0-15> Set the light threshold for torch placement
/mineflow off Disable the bot
/mineflow set <block> Set a single target block (with Tab completion)
/mineflow add <block> Add a block to the target list
/mineflow remove <block> Remove a block from the target list
/mineflow clear Clear all targets
/mineflow list Show current target list
/mineflow chest set <x> <y> <z> Set the dump chest position (supports ~ relative coords)
/mineflow help Show command reference in chat

Quick Example

/mineflow set minecraft:diamond_ore
/mineflow add minecraft:deepslate_diamond_ore
/mineflow chest set ~ ~ ~
/mineflow mine

The bot will now mine all diamond ore nearby, and dump everything into your chest when the inventory fills up.


⚙️ How It Works

  1. Every 2 ticks the bot scans an 8-block radius around the player for target blocks
  2. It uses a DDA voxel raycast (no ClipContext — fully compatible with Sodium and Lithium) to verify line-of-sight to each candidate block
  3. Once a target is found, the camera rotates smoothly and the player walks toward it
  4. Within reach (3.5 blocks) it calls the standard game API to start and continue breaking the block
  5. The best tool in the hotbar is selected automatically for each block type
  6. After breaking, the bot immediately looks for the next target

🛡️ Safety Stops

Condition Behavior
Inventory full (no chest) Bot stops and displays a chat warning
Inventory full (chest configured) Bot walks to chest, dumps mined blocks, resumes
Tool durability < 5% Bot stops and displays the remaining uses in chat
Bot stuck (moved < 0.4 blocks in 20 ticks) Jumps and changes direction; after 2 failures triggers a 30-tick random escape