https://github.com/arielhorwitz/botroyale

A battle royale for bots
https://github.com/arielhorwitz/botroyale

ai battle-royale educational game kivy python

Last synced: 2 months ago
JSON representation

A battle royale for bots

• Host: GitHub
• URL: https://github.com/arielhorwitz/botroyale
• Owner: ArielHorwitz
• License: mit
• Created: 2022-06-11T17:18:54.000Z (over 2 years ago)
• Default Branch: dev
• Last Pushed: 2024-03-14T16:04:02.000Z (10 months ago)
• Last Synced: 2024-04-16T06:59:15.566Z (8 months ago)
• Topics: ai, battle-royale, educational, game, kivy, python
• Language: Python
• Homepage:
• Size: 6.06 MB
• Stars: 4
• Watchers: 2
• Forks: 0
• Open Issues: 6
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![](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).