semvec/pypi-packages huggingface dataset:
botroyale 0.1.4
A battle royale for bots.
Requires Python: >=3.9

[![](https://img.shields.io/badge/docs--orange.svg?style=plastic)](https://ariel.ninja/botroyale/docs/)
[![](https://img.shields.io/badge/license-MIT-green.svg?style=plastic)](https://github.com/ArielHorwitz/botroyale/blob/dev/LICENSE)
[![](https://img.shields.io/pypi/v/botroyale?style=plastic&color=blue)](https://pypi.org/project/botroyale/)
[![](https://img.shields.io/pypi/pyversions/botroyale?style=plastic&color=blueviolet)](https://www.python.org/)
[![](https://img.shields.io/discord/1000665419906039839?label=discord&style=plastic)](https://discord.gg/ADss5FRyqG)
# Bot Royale
A battle royale for bots. Write your own bots in Python and watch them play!

![Preview GIF](/botroyale/assets/preview.gif)

## Quickstart
It is recommended to use a [virtual environment](https://docs.python.org/3/tutorial/venv.html). Once activated, install using:
```noformat
pip install botroyale
```
It takes as few as ***7 lines of code*** to [write your own bot](https://ariel.ninja/botroyale/docs/guides/bots/simple.html) and watch it play:

```python
import botroyale as br

class MyBot(br.BaseBot):
    NAME = 'mybot'

    def poll_action(self, state):
      return br.Idle()  # Add bot logic here

br.register_bot(MyBot)
br.run_gui()
```

## Guides and Documentation
Browse the [docs](https://ariel.ninja/botroyale/docs/) for guides and API reference to learn more.

## Community
Join us in the [community discord server](https://discord.gg/ADss5FRyqG).

## Contributing
Browse the [contribution guide](https://ariel.ninja/botroyale/docs/guides/contributing.html).