Bunny

A modern, open-source Python framework for Minecraft bot development inspired by Mineflayer, designed from the ground up for Python developers.

Philosophy

"If Mineflayer is the Node.js standard, Bunny should become the Python standard."

Bunny prioritizes:

• Beginner friendly - Simple API for newcomers
• Fully typed - Type hints throughout
• Async-first - Built on asyncio for performance
• Modular - Plugin-based architecture
• Cross-platform - Works everywhere Python does
• AI-ready - Perfect for AI agents and reinforcement learning
• Production quality - Robust and well-tested

Installation

pip install bunny-mc

For development with optional dependencies:

pip install bunny-mc[dev,uvloop,nbt]

Quick Start

import asyncio
from bunny_mc import Bot

async def main():
    bot = Bot()
    
    @bot.on("spawn")
    async def on_spawn():
        print("Bot spawned!")
        bot.chat("Hello, world!")
    
    await bot.connect(
        host="localhost",
        port=25565,
        username="Steve"
    )

asyncio.run(main())

Features

• Event System - Async event handlers with priorities and filters
• Plugin API - Extensible plugin ecosystem
• World System - Complete world representation
• Entity System - Track players, mobs, and items
• Inventory API - Manage items and equipment
• Pathfinding - A* with advanced movement
• Physics - Minecraft-accurate movement
• Navigation - High-level movement commands
• Combat - PvP and PvE support
• Mining - Automated mining strategies
• Building - Blueprint-based construction
• Farming - Automated farming
• Crafting - Recipe-based crafting
• Chat API - Chat and command handling
• Authentication - Offline and Microsoft OAuth

Documentation

Full documentation is available at docs.bunny-mc.dev

Contributing

Contributions are welcome! Please see our contributing guidelines.

License

MIT License - see LICENSE file for details.