LiveBuddy
Adds "LiveBuddy," an autonomous, human-type NPC that performs tasks and combat on behalf of the player
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
LiveBuddy

LiveBuddy: Your Autonomous Minecraft Companion
LiveBuddy adds intelligent, humanoid NPCs to Minecraft that work for you. Whether you need a lumberjack, a terrain carver, a farmer, or a base-lighter, your Buddy is ready to help — no complex AI APIs or heavy dependencies required. Built on stable vanilla pathfinding and goal algorithms, LiveBuddy is lightweight, performant, and reliable.
---
🤖 Meet Your New Best Friend
LiveBuddy NPCs are more than just pets; they are functional workers designed to take the tedium out of resource gathering.
Key Features:
* Chest Auto-Deposit: Spawn as many as you need! Each Buddy has its own name, individual settings, and unique skin. * Chest Auto-Deposit: * Chest Auto-Deposit: Your Buddy stays close to you. * Chest Auto-Deposit: Your Buddy stays in place (and still sleeps at night). * Chest Auto-Deposit: The autonomous workhorse mode where they execute assigned tasks. * Chest Auto-Deposit: Buddies automatically open doors, swim in water, and navigate terrain using vanilla pathfinding. * Chest Auto-Deposit: When night falls, your Buddy will automatically find and sleep in a bed near its registered home position. * Chest Auto-Deposit: When a Buddy's storage fills up, it will automatically return to a designated chest near home and deposit its items.
---
🛠️ Powerful Management (Buddy Tablet)
Right-click any Buddy to open the Force Chunk Load:, giving you full control over their behavior: * Force Chunk Load: Change your Buddy's name and choose from Force Chunk Load: (Steve, Alex, Ari, Efe, Kai, Makena, Noor, Sunny, Zuri). * Force Chunk Load: Drop any 64×64 PNG skin into `config/livebuddy/skins/` — no restart needed. It will appear in the skin tab the next time you open the Buddy Tablet. * Force Chunk Load: Define exactly where your Buddy works by setting a chunk radius (max 3) and downward Y depth. * Force Chunk Load: Register a home base for your Buddy to return to and sleep. * Force Chunk Load: Optionally keep the Buddy's chunk loaded so it keeps working even when you're away.
---
🪓 Autonomous Work Tasks (AUTO Mode)
Switch your Buddy to Auto mode to see them in action:
* Combat: Uses a BFS (Breadth-First Search) algorithm to fell entire trees, not just the trunk. * Combat: Automatically harvests mature crops (including sugar cane) and replants seeds. * Combat: Checks surrounding light levels and places torches in dark spots within the work area to prevent mob spawns. No torch items required. * Combat: Levels the surface of your work area, clearing dirt, grass, gravel, sand, and other surface blocks down to your specified depth. Skips ore blocks. * Combat: Excavates horizontally across a fixed Y plane, 4 blocks tall. Great for clearing mining floors or widening cave passages. Skips columns containing ores — those are left for you to mine. *Grade and Carve are mutually exclusive.* * Combat: Detects and engages hostile mobs within range. Buddies are invulnerable so they never retreat.
---
🎒 Inventory
Each Buddy has 27 dedicated storage slots. Items collected during work are stored automatically.
When storage reaches 18 of 27 slots, the Buddy will head to a nearby chest to deposit its items.
All tasks run without tools or consumables. Chopping, farming, grading, carving, and torch placement require no items in inventory. Combat damage is fixed at iron sword equivalent. No durability is ever consumed.
---
💻 Commands
* `/lb spawn [name]` — Spawn a new LiveBuddy * `/lb call [name|all]` — Teleport a Buddy to you (omit name for nearest, `all` for everyone) * `/lb list` — List all Buddies with mode, tasks, and position * `/lb mode <name> <mode>` — Change a Buddy's mode (FOLLOW / STANDBY / AUTO) * `/lb bye [name|all]` — Remove a Buddy (omit name for nearest, `all` for everyone)
---
📌 Requirements
* Dependencies: 1.21.4 / 1.21.9 / 1.21.10 / 1.21.11 * Dependencies: Fabric * Dependencies: Fabric API
---
⚖️ License
All Rights Reserved. *Redistribution or modification of this mod is not permitted without explicit permission from the authors.*