🤖 UFBot CLI

Advanced Minecraft bot platform with intelligent pathfinding, natural language AI control, and professional movement capabilities.

✨ Features

🧠 Advanced AI Control

• Natural Language Processing: Understands commands like "go forward 100 blocks and then backward 60 blocks"
• Smart Combat: Strafing, jumping, tactical positioning
• Intelligent Pathfinding: Parkour, bridging, tower building
• No API Required: Works offline without external AI services

🎯 Enhanced Movement

• Advanced Pathfinding: Obstacle avoidance, optimal routing
• Parkour Skills: Auto-jump gaps, climb ledges
• Combat Movement: Strafing, jiggling, critical hits
• Building: Auto-bridging, tower construction
• 64-block Detection: 4x better entity detection range

🛠️ Quick Commands

• /kill - Smart combat with strafing
• /travel - Pathfinding with parkour
• /collect - Enhanced item collection
• /build - Bridge and tower building
• /ai - Natural language control

🚀 Installation

Global Installation

npm install -g ufbot

Local Development

git clone https://github.com/your-username/ufbot.git
cd ufbot
npm install
npm run server  # Terminal 1
npm run cli     # Terminal 2

🎮 Usage

Start Bot

ufbot
# Or for development
npm run cli

Basic Commands

/join              # Start bot session
/leave             # Stop bot session
/kill zombie       # Combat with strafing
/travel 100 64 200 # Smart pathfinding
/collect diamonds  # Enhanced collection
/build bridge      # Auto-bridging
/ai "go forward 100 blocks" # Natural language

AI Commands

/ai "go forward 100 blocks and then backward 60 blocks"
/ai "go to nearest player"
/ai "attack zombie"
/ai "build bridge to 100 64 100"
/ai "collect all diamonds nearby"
/ai "jump and dig"
/ai "look around for villages"

🔧 Configuration

Server Setup

# Start UFBot server
npm run server

# Server runs on http://localhost:3001

Environment Variables

MONGODB_URI=mongodb://localhost:27017/ufbot
JWT_SECRET=your-secret-key
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret

📦 Dependencies

Core Dependencies

• mineflayer - Minecraft bot framework
• mineflayer-pathfinder - Advanced pathfinding
• mineflayer-collectblock - Item collection
• express - Web server
• mongoose - Database
• jsonwebtoken - Authentication

CLI Dependencies

• @inquirer/prompts - Interactive prompts
• chalk - Terminal styling
• ora - Loading spinners
• axios - HTTP client

🏗️ Architecture

ufbot/
├── cli/                 # CLI interface
│   ├── commands/        # Command handlers
│   ├── prompts/         # User prompts
│   └── index.js        # CLI entry point
├── server/             # Backend server
│   ├── controllers/     # Route handlers
│   ├── services/        # Business logic
│   ├── models/          # Database models
│   └── index.js        # Server entry point
└── core/              # Shared bot engine
    └── botEngine.js     # Mineflayer integration

🤖 Bot Capabilities

Movement

• ✅ Smart pathfinding with obstacle avoidance
• ✅ Parkour (jump gaps, climb ledges)
• ✅ Sprint and walk modes
• ✅ Strafing and evasive maneuvers
• ✅ Tower building and bridging

Combat

• ✅ Advanced combat with strafing
• ✅ Critical hit jumping
• ✅ Tactical positioning
• ✅ 64-block entity detection
• ✅ Hostile mob targeting

Intelligence

• ✅ Natural language understanding
• ✅ Sequential command execution
• ✅ Context-aware responses
• ✅ No external API required

📝 API

Bot Commands

// Movement
botEngine.travel(x, y, z, method) // 'walk', 'sprint', 'parkour'

// Combat
botEngine.killEntity(type, name, radius) // 'player' or 'mob'

// Building
botEngine.build(type, x, y, z, buildType) // 'bridge', 'tower', 'place'

// Collection
botEngine.collectItem(itemName, radius)

Server API

// Start bot session
POST /start-bot
{
  "username": "botname",
  "host": "localhost",
  "port": 25565,
  "version": "1.21"
}

// Execute command
POST /command
{
  "action": "kill",
  "data": {
    "targetType": "mob",
    "targetName": "zombie",
    "radius": 64
  }
}

🔒 Authentication

UFBot uses Google OAuth for authentication:

• Credit-based system
• Session management
• Usage tracking
• Multi-user support

📄 License

MIT License - see LICENSE file for details.

🤝 Contributing

1. Fork the repository
2. Create feature branch
3. Make your changes
4. Add tests
5. Submit pull request

🆘️ Support

• 📧 Email: [email protected]
• 🐛 Issues: GitHub Issues
• 📖 Documentation: Wiki

UFBot - Professional Minecraft automation with intelligence.