craps

A lightweight table game simulator.

· Report Bug · Request Feature

Installation

Install with pip (recommended)

pip install craps

Usage

!pip install craps
from craps import Game, PassBet, LineOddsBet, ComeBet, PointOddsBet

Collecting craps
  Downloading craps-1.1.0-py3-none-any.whl (9.9 kB)
Installing collected packages: craps
Successfully installed craps-1.1.0

# Start a game with $100 at a table with a $10 minimum
g = Game(arrival_cash = 100, minimum_bet=10)

# Place a bet for $10, then roll the dice!
g.bet(PassBet(10))
g.roll()

[Bet] You made a PassBet on the box for 10
[Rail] You have 990.0 on the rail
[Table] The shooter is ready, the point is off
[Table] PassBet for 10 is working on the box
[Roll] Shooter rolled 10
[Roll] The point is 10
[Rail] You have 990.0 on the rail

# Put $20 odds on line bet
g.bet(LineOddsBet(20, g.puck))

# And place an additional come bet for the table minimum
g.bet(ComeBet(g.minimum_bet))

[Bet] You made a LineOddsBet on 10 for 20
[Rail] You have 970.0 on the rail
[Bet] You made a ComeBet on the box for 10.0
[Rail] You have 960.0 on the rail

# Roll!
g.roll()

[Table] The shooter is ready, the point is 10
[Table] PassBet for 10 is working on 10
[Table] LineOddsBet for 20 is working on 10
[Table] ComeBet for 10.0 is working on the box
[Roll] Shooter rolled 8
[Roll] 2+6=8 came easy
[Bet] ComeBet for 10.0 was moved to the 8
[Rail] You have 960.0 on the rail

# Check your bets
g.callout()

[Table] PassBet for 10 is working on 10
[Table] LineOddsBet for 20 is working on 10
[Table] ComeBet for 10.0 is working on 8

# Put $30 odds on your 8
g.bet(PointOddsBet(30, 8))

[Bet] You made a PointOddsBet on 8 for 30
[Rail] You have 930.0 on the rail

# Roll!
g.roll()

[Table] The shooter is ready, the point is 10
[Table] PassBet for 10 is working on 10
[Table] LineOddsBet for 20 is working on 10
[Table] ComeBet for 10.0 is working on 8
[Table] PointOddsBet for 30 is working on 8
[Roll] Shooter rolled 10
[Roll] Winner!!, 10
[Payout] PassBet on 10 paid out 20
[Payout] LineOddsBet on 10 paid out 60.0
[Rail] You have 1010.0 on the rail

(back to top)

Roadmap

• Add Bet types to model.py
  • Add place bets
  • Add side bets
    • Add the Yo first. That's fun.
• Strategy constructor / builder
  • Logic layer to facilitate strategy construction in a low code environment. For example:
    • IF the game puck is off AND I do not have a place bet, THEN make a place bet.
    • IF the game puck is on AND I do not have odds on a place or come bet, THEN put f(x) odds on it.

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE.txt for more information.

Contact

Mike Hegarty - @mjhegarty - mike@petorca.com

Project Link: https://github.com/mhegarty/craps

Acknowledgments

• Thanks to @dhegarty19 for agreeing to celebrate our third aniversary at the casino.
• Big thanks to Othneil Drew for the awesome work on the best readme template
• pikpng.com for the logo image.