MineCortex combines the power of mineflayer (Minecraft bot framework) with Voyager-inspired AI capabilities to create intelligent, autonomous Minecraft bots that can learn, adapt, and coordinate with each other.

🧠 MineCortex = Mine (Mining/My) + Cortex (Brain)
Your personal intelligent Minecraft brain system

• 🤖 Multi-AI Coordination - 5 synchronized AI players working together
• 🧠 Voyager-Inspired Learning - Memory-based learning without file I/O
• 🎮 Autonomous Gameplay - Self-directed exploration, mining, and crafting
• 🛠️ Extensible Skills - Modular skill system for custom behaviors
• 🔧 Simple Setup - Single command deployment (npm start)

• Node.js >= 16.13.0
• Minecraft Java Edition 1.21 server (local or remote)

# Clone the repository
git clone https://github.com/Laplash1/minecortex.git
cd minecortex

# Install dependencies
npm install

# Launch 5 AI players (default)
npm start

# Launch with custom player count
MULTIPLE_PLAYERS_COUNT=3 npm start

# Enable debug mode
DEBUG_MODE=true npm start

# Custom server settings
MINECRAFT_HOST=your-server.com MINECRAFT_PORT=25565 npm start

• Autonomous Exploration - Smart pathfinding and world discovery
• Resource Management - Intelligent mining and inventory optimization
• Skill Learning - Dynamic skill generation and improvement
• Multi-Player Coordination - Synchronized teamwork and resource sharing

• Full Minecraft 1.21 Support - Latest minecraft-data compatibility
• Chat Commands - Natural language and structured command interface
• Real-time Adaptation - Responds to game events and player interactions
• Survival Mechanics - Food management, health monitoring, respawn handling

• Modular Architecture - Easy to extend and customize
• ESLint Integration - Consistent code quality
• Comprehensive Documentation - Detailed guides and references
• Hot-Reload Development - Fast iteration cycles

Measured on modern development hardware with real-world workloads

!status              # Health, food, position report
!goto <x> <y> <z>    # Move to coordinates
!follow <player>     # Track and follow a player
!stop                # Stop current task
!learn               # Show learning statistics
!curriculum          # Generate new AI curriculum

minecortex/
├── 🚀 examples/
│   └── multiple-players.js    # Main entry point
├── 🧠 src/                    # AI Components
│   ├── MinecraftAI.js         # Core AI controller
│   ├── VoyagerAI.js           # Learning engine
│   ├── SkillLibrary.js        # Skill management
│   ├── TaskPlanner.js         # Task orchestration
│   ├── MultiPlayerCoordinator.js # Team coordination
│   └── utils/                 # Shared utilities
├── ⚙️ config/                 # Configuration
├── 📚 docs/                   # Documentation
└── 📝 dev_daily/             # Development logs

# Check code style
npm run lint

# Auto-fix issues
npm run lint:fix

# Minecraft Connection
MINECRAFT_HOST=localhost
MINECRAFT_PORT=25565
MINECRAFT_USERNAME=AIPlayer
MINECRAFT_AUTH=offline

# AI Features (Optional)
OPENAI_API_KEY=your_api_key
OPENAI_MODEL=gpt-4o-mini

# Bot Configuration
DEBUG_MODE=true
AUTO_RESPAWN=true
MULTIPLE_PLAYERS_COUNT=5

Add New Skills:

class MyCustomSkill extends Skill {
  constructor() {
    super('my_skill', 'Description of what this skill does');
  }
  
  async execute(bot, params) {
    // Your implementation here
    return { success: true, result: 'Task completed' };
  }
}

We welcome contributions! Please see our Contributing Guide for details.

1. 🍴 Fork the repository
2. 🌟 Create a feature branch
3. 💻 Make your changes
4. ✅ Run npm run lint to ensure code quality
5. 🧪 Test with npm start
6. 📝 Update documentation as needed
7. 🚀 Submit a pull request

• ✅ Multi-player AI coordination (5 bots tested)
• ✅ Autonomous exploration and mining
• ✅ Real-time learning and adaptation
• ✅ Minecraft 1.21 full compatibility
• ✅ Memory-efficient architecture

• 🔮 Enhanced natural language processing
• 🏗️ Advanced building and construction
• 🌐 Multi-server support
• 📱 Web dashboard interface

This project is licensed under the MIT License - see the LICENSE file for details.

• mineflayer - Excellent Minecraft bot framework
• Voyager - AI learning architecture inspiration (MIT License)
• PrismarineJS - Minecraft protocol implementation
• OpenAI - GPT-4 for intelligent skill generation