🃏 Card Roulette

A Python package that simulates a thrilling card game where players draw cards, hoping to avoid the deadly one.

Description

Card Roulette is a text-based game where players draw cards in rounds. Each round, players draw cards randomly, and if a player draws the deadly card, they lose the round. The game introduces a new deadly card with each iteration (Iteration n's deadly card is card n). If the deadly card is the only one remaining, all players survive.

Rust Version

You can find the Rust version here.

Requirements

• Python 3.6 or above

Installation

git clone https://github.com/Disciple0fMarx/card_roulette

Usage

cd card_roulette
python3 -m card_roulette

Playing a game

Default settings: 3 players, 3 rounds

python3 -m card_roulette play --players 4 --rounds 2

Simulating games

Default settings: 5 games, 3 players, 3 rounds

python3 -m card_roulette simulate --games 10 --players 4 --rounds 2

Results will be saved in the results folder like so:

results/
├── 3_players/
│   ├── 3_rounds/
│   │   ├── 020549a8-1daf-43c2-a0d9-b0a49e31d860.csv
│   │   └── ...
│   └── 4_rounds/
│       ├── a568cd44-9c4d-4ff2-a604-f100307040e4.csv
│       └── ...
├── 4_players/
│   └── 2_rounds/
│       ├── fe54d3d1-ff4e-41f0-a579-e22d208163ea.csv
│       └── ...
├── ...
└── total_results.json

• <id>.csv contains the scores of all players in each game in the simulation with the given UID.
• total_results.json stores the cumulative scores of each simulation.