#cards #state #card-game #state-machine #machine

spades

A popular four person card game implemented in Rust

4 releases (1 stable)

Uses old Rust 2015

1.0.0 Jul 18, 2018
0.1.2 Jul 9, 2018
0.1.1 Jul 9, 2018
0.1.0 Jul 9, 2018

#1850 in Game dev

MIT license

37KB
822 lines

Spades · MIT Licence · Build Status

Spades is a four person trick-taking card game. For the complete rules of spades, click here.

Getting Started

Add this line to your Cargo.toml:

[dependencies]
spades = "1.0"

Bidding Features

Currently allows bidding nil by placing a bet of zero (the bonus is +100 points, and penalty is -100 points), but blind bets are not yet supported.

How to use

extern crate spades;
extern crate uuid;

use spades::{Game, GameTransition};
use spades::result::{TransitionSuccess, TransitionError, GetError};

let mut g = Game::new(uuid::Uuid::new_v4(), 
        [uuid::Uuid::new_v4(), 
         uuid::Uuid::new_v4(), 
         uuid::Uuid::new_v4(), 
         uuid::Uuid::new_v4()], 
         500);

g.play(GameTransition::Start);

//Each round starts with a round of betting

assert_eq!(g.play(GameTransition::Bet(3)), TransitionSuccess::Bet);
g.play(GameTransition::Bet(4));
g.play(GameTransition::Bet(4));
g.play(GameTransition::Bet(2));

//The game is now in the card playing stage
assert_eq!(g.play(GameTransition::Bet(3)), TransitionFailure::Bet);


let hand = g.get_hand(g.current_player).clone();

let valid_card = g.last().unwrap().clone();
g.play(GameTransition::Card(valid_card));

//...

Documentation

For a complete description of the crate, check the docs.rs page.

Contributing

If there is a feature you would like to see added, please feel free to make an open an issue or pull request!

Dependencies

~1MB
~11K SLoC