Skip to content

kjwilcox/brave-rats

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

brave-rats

Brave Rats game engine.

Modelled after the simple, addictive, impossible-to-master card game "BraveRats - A Game by Seiji Kanai". All game design credit to Seiji. You are encouraged to treat your and your friends to a physical copy of the game, which is available on amazon.com and at a game store near you!

This code duplicates the original game mechanics to allow for on-computer gameplay and to enable building and studying Brave Rats AIs.

Usage

###Install

git clone https://github.com/thatneat/brave-rats
pip install -r requirements.txt # OR, at the moment, just 'pip install enum34'
cd brave-rats

To play a game against the AI

python brave_rats.py

Building your own AI

See brains/example_ai.py for an example AI function. To play a game against your own AI:

python
>> import brave_rats
>> from your_module import your_ai_fn
>> brave_rats.play_game(red_brain_fn=your_ai_fn)

blue_brain_fn will default to human input, but you can override that too to watch computers clash. For example:

>> brave_rats.play_game(brave_rats.random_ai_brain_fn, brave_rats.random_ai_brain_fn)

To print the results table for individual fights

python
>> from brave_rats import fight
>> fight.print_results_table()
        b=0     b=1     b=2     b=3     b=4     b=5     b=6     b=7
r=0     h       h       h       h       h       b       h       h
r=1     h       h       b       r       b2      b       b       r
r=2     h       r       h       r       b2      b       b       b
r=3     h       b       b       h       r       b       r       b
r=4     h       r2      r2      b       h       b       b       b
r=5     r       r       r       r       r       h       b       b
r=6     h       r       r       b       r       r       h       b
r=7     h       b       r       r       r       r       r       h

>> brave_rats.print_results_table(red_general_played=True)
        b=0     b=1     b=2     b=3     b=4     b=5     b=6     b=7
r=0     h       h       h       h       h       b       h       h
r=1     h       r       r       h       b2      b       b       r
r=2     h       r       r       b       h       b       b       b
r=3     h       b       b       b       b2      h       r       b
r=4     h       r2      r2      b       r2      r       h       b
r=5     r       r       r       r       r       r       r       h
r=6     h       r       r       b       r       r       r       b
r=7     h       b       r       r       r       r       r       r

Issues

Issues I am aware of are listed on the GitHub issues page: https://github.com/thatneat/brave-rats/issues

Suggestions and pull requests are very welcome!

About

Brave Rats game engine

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%