Metadata-Version: 2.4
Name: bunny-mc
Version: 0.1.0
Summary: A modern Python framework for Minecraft bot development
Project-URL: Homepage, https://github.com/bunny-mc/bunny
Project-URL: Documentation, https://docs.bunny-mc.dev
Project-URL: Repository, https://github.com/bunny-mc/bunny
Project-URL: Issues, https://github.com/bunny-mc/bunny/issues
Author: Bunny Contributors
License: MIT
License-File: LICENSE
Keywords: automation,bot,game,minecraft,mineflayer
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.12
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: asyncio
Requires-Dist: construct>=2.10.0
Requires-Dist: cryptography>=41.0.0
Requires-Dist: pydantic>=2.0.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: mypy>=1.5.0; extra == 'dev'
Requires-Dist: pre-commit>=3.4.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: nbt
Requires-Dist: amulet-nbt>=4.0.0; extra == 'nbt'
Provides-Extra: uvloop
Requires-Dist: uvloop>=0.17.0; extra == 'uvloop'
Description-Content-Type: text/markdown

# 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

```bash
pip install bunny-mc
```

For development with optional dependencies:

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

## Quick Start

```python
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](https://docs.bunny-mc.dev)

## Contributing

Contributions are welcome! Please see our contributing guidelines.

## License

MIT License - see LICENSE file for details.
