CardStock is a General Game Playing engine for card games implemented in C#. Games are written in RECYCLE, a card game description language, and then simulations are run with random, simple, and complex AI players. CardStock can then analyze the games to determine heuristics about the games such as fairness, decisiveness, drama, or clarity, and generate transcripts of each simulation for further study.

We are currently abstracting and refactoring CardStock to allow for new game functionality and setting up a modular system for a tournament of AI players. Please post any issues you find.

There are currently 70+ games coded in RECYCLE, a mixture of classic and modern games, categorized by genre:

• Adding
  • Caterpillar (2p)
  • Cribbage (2p)
  • Ninety Eight (4p)
  • Poison (5p)
• Catch and Collect
  • 6 Nimmt (5p)
  • Enchère (3p)
  • GOPS (2p)
  • Go Fish (2-4p)
  • Pico (2p)
    • Pico 2
  • Trio (4p)
  • Turn the Tide (3p)
• Climbing
  • Comet (2p)
  • Escalation! (4p)
  • LAMA (2-6p)
  • President (4-5p)
• Deck Building
  • Abandon All Artichokes (2p)
• Drafting
  • Sushi Go! (4p)
• Draw and Discard (or Discard and Draw)
  • Clocktowers (2p)
  • Golf Six (2-4p)
  • Lost Cities (2p)
  • Love Letter (3-4p)
  • Rummy (2p)
  • Spite and Malice (2p)
• Exchange
  • Cuckoo (6p)
  • Schwimmen (5p)
• Fishing
  • Escoba (2p)
  • Scopa (2p)
  • Stealing Bundles (2-4p)
• Poker
  • Kuhn Poker (2p)
  • Leduc Poker (2p)
• Push Your Luck
  • BlackJack (2p)
  • Diamant (8p)
  • Gold Rush (3p)
  • Nanuk (6p)
  • No Thanks (3-5p)
  • Pairs (2-5p)
    • Continuous Pairs (4p)
    • Calamity Continuous Pairs (4p)
    • Port (4p)
• Shedding
  • Crazy Eights (4p)
    • Sane Eights (4p)
  • Page One (3p)
  • Simon's Cat (4p)
  • Skittgube (3p)
• Trick Taking
  • Ace-Ten
    • Briscola (2p)
      • Trifle (2p)
    • Klaverjassen (4p)
    • Sheepshead (5p)
      • Cheesheads (5p)
    • Sueca (4p)
  • All Fours
    • California Jack (2p)
    • Pitch (4p)
    • Shasta Sam (4p)
  • Avoidance
    • Hearts (3-5p)
      • Omnibus Hearts (4p)
      • Broken Hearts (4p)
      • Pure Hearts (4p)
      • Grey Lady (4p)
      • Black Maria (4p)
      • Spot Hearts (4p)
    • Knaves (3-4p)
    • Polignac (4p)
    • Slobberhannes (4p)
  • Whist
    • German Whist (2p)
    • Spades (4p)
    • Whist (4p)
  • Others
    • Agram (2-5p)
    • Duck Soup (2p)
    • Euchre (4p)
    • Scarto (3p)
    • The Fox in the Forest (2p)
    • The Bottle Imp (3-4p)
• Unique
  • Coloretto (4p)
  • Coup (4p)

Please check the wishlist for games that we would love to have implemented in Recycle. Pull requests are welcome and encouraged!

• Visual Studio Code
• .NET Core v 10.0
• C# Dev Kit Extension
• ANTLR4 grammar syntax support

1. Install .NET Install Tool Extension
2. Get .Net Core 10.0
3. Install C# Dev Kit Extension
4. Open CardStock folder in the project using Visual Studio Code.

6. Open the CardStock subdirectory
7. Write up your game in RECYCLE in the games subdirectory.
8. Alter the Program.cs class to specify the name of your game.
9. Run the program in either Release or Debug mode.
   1. For Release mode, in the terminal type "dotnet run --configuration Release"
   2. Choose "Release Mode" to only see the results, or "Debug Mode" to see all game actions (better logs in the future).
10. Analyse your results (found in the output subdirectory) with the Jupyter Notebooks in the Analysis directory.

• The Shape of Card Games Blog
• ReadTheDocs.io
• Automated Playtesting with RECYCLEd CardStock, Connor Bell and Mark Goadrich, Game & Puzzle Design Journal, Vol 2, Issue 1, July 2016
• Quantifying the Space of Hearts Variants, Mark Goadrich and Collin Shaddox, Advances in Computer Games 2021, November 2021

To cite this project, please use the following reference

@article{Bell_Goadrich_2016,
         title={Automated Playtesting with RECYCLEd CardStock},
         author={Bell, Connor and Goadrich, Mark},
         journal={Game & Puzzle Design},
         volume={2}, number={1},
         year={2016}, pages={71–83}}