Auto Player

[2.0.0] — 2026-07-12

The bot started in v1.0.0 as a single-purpose woodcutter — it located trees and chopped them down. v2.0.0 turns it into a full client-side survival/combat assistant while keeping the original woodcutting behavior.

Woodcutting (unchanged from v1.0.0)

- Automatically finds and chops nearby trees.

Added — Mining & world interaction

- Mining zones: mark two corners with B and the bot mines the whole volume; optional staircase mode.
- Auto-climb: pillars up with dirt or mines upward to reach high targets.
- Tool-tier filtering: configurable use of wood / stone / iron tools.

Added — Inventory & chests

- Per-material chests: assign a chest per category (wood, stone, iron, dirt) with B.
- Auto-deposit: drops off materials into the assigned chest when the inventory fills up.
- Death recovery mode: walks back to your last death point to recover your items.

Added — Building

- Construction zones: mark corners and the bot places blocks to build the shape, sourcing materials from chests.

Added — Navigation

- Goto mode: walk to a target X/Y/Z coordinate (surface-routes if no Y is set).
- Boat usage: uses a boat to cross water when it's faster.
- A* pathfinding for movement planning.

Added — Survival automation

- Auto-eat when hunger/health drops below threshold.
- Auto-torch placement in dark areas.
- Auto-armor equipping from the inventory.
- Water rescue / MLG water bucket: places water on dangerous falls.
- Anti-burn: uses a water bucket when on fire.
- Hazard escape: moves out of lava / avoids drowning.
- Humanize: micro-pauses and look-variation to mimic a real player.

Added — Combat & PvP

- Hostile-mob defense (fight or flee).
- Enemy blacklist: press V to mark/unmark the player under your crosshair as a priority enemy.
- Melee aim-assist (sword/axe/fist) while attacking.
- Bow / crossbow ballistic aim-assist plus ranged combat against distant targets.
- Reactive shield: auto-raises against explosions and projectiles; shield aim-assist faces the threat while blocking.
- Auto-eat retreat behavior during combat.
- Auto-totem: moves a Totem of Undying to the off-hand below a health threshold, then restores the previous item.
- Arrow collection after combat ends.
- Support / bridging: sneak-bridge on sustained double-W, optional jump-block placement.

Added — Quality of life

- Status HUD overlay (objective progress + coordinates).
- In-game config menu on K.
- Manual click override: the bot never steals your own manual block-break/place clicks.
- Client-only messaging: all [AutoMine] chat/action-bar messages are local — other players can't see them, so it's safe on public servers.

Keybinds

┌─────┬─────────────────────────────────┐
│ Key │             Action              │
├─────┼─────────────────────────────────┤
│ L   │ Start / stop the bot            │
├─────┼─────────────────────────────────┤
│ K   │ Open config menu                │
├─────┼─────────────────────────────────┤
│ R   │ Force re-target                 │
├─────┼─────────────────────────────────┤
│ B   │ Mark zone corner / assign chest │
├─────┼─────────────────────────────────┤
│ V   │ Mark/unmark enemy               │
├─────┼─────────────────────────────────┤
│ P   │ Toggle all support features     │
└─────┴─────────────────────────────────┘

Notes

- Targeted at Minecraft 1.16.5 with Forge 36.x.
- Several features (e.g. autoSmelt) are scaffolded in config but not yet active and are intentionally omitted here.