Skip to content

Shanehealy43/ffai

 
 

Repository files navigation

FFAI: Fantasy Football AI

FFAI is a python package that includes a framework for playing and developing bots for Blood Bowl. Our aim is to develop a bot that can beat the best humans at the game.

FFAI

Please cite our paper if you use FFAI in your publications.

@inproceedings{justesen2019blood,
  title={Blood Bowl: A New Board Game Challenge and Competition for AI},
  author={Justesen, Niels and Moore, Peter David and Uth, Lasse M{\o}ller and Togelius, Julian and Jakobsen, Christopher and Risi, Sebastian}
  booktitle={2019 IEEE Conference on Games (COG)},
  year={2019},
  organization={IEEE}
}

Read more about the challenges and acheivements in Papers.md

Bot Bowl

Bot Bowl is an AI competition using the FFAI framework. Go read all about the upcoming Bot Bowl III.

Installation

Make sure python 3.6 or newer is installed, together with pip. Then run:

pip install git+https://github.com/njustesen/ffai

Here's a more detailed guide on how to set up FFAI.

Tutorials

Head over to our tutorials to learn about how to use FFAI.

Run FFAI's Web Server

python -c "import ffai.web.server as server;server.start_server(debug=True, use_reloader=False, port=5000)"

Or download the examples folder and run:

python examples/server_example.py

Go to: http://127.0.0.1:1234/

The main page lists active games. For each active game you can click on a team to play it. If a team is disabled it is controlled by a bot and cannot be selected. Click hot-seat to play human vs. human on the same machine.

Get involved

We'd love you to join us in creating really good bots for Blood Bowl! There are mainly two ways. First is developing your own bot to compete in the competition. Head over to the tutorials to get started creating your own awesome bot. The second way is contributing to the project itself with development. Head over to Development.md to learn more.

Join the FFAI Discord server for questions, discussions and the latest news!

Disclaimers and Copyrighted Art

FFAI is not affiliated with or endorsed by any company and/or trademark. FFAI is an open research framework and the authors have no commercial interests in this project. The web interface in FFAI currently uses a small set of icons from the Fantasy Football Client. These icons are not included in the license of FFAI. If you are the author of these icons and don't want us to use them in this project, please contact us at njustesen at gmail dot com, and we will replace them ASAP. The team icons are from FUMBBL and are used with permission. The license described in LICENSE only covers the source code - not any of the graphics files.

About

A Blood Bowl AI framework.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 58.2%
  • JavaScript 35.3%
  • HTML 4.4%
  • Less 2.1%