RECYCLEd CardStock V2.0

Project Goals

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 in the process of abstracting and refactoring CardStock to allow for new game functionality and setting up a modular system for a tournament of AI players. Please check back for further progress on these issues.

Games

There are currently 51 games coded in RECYCLE

• Adding
  • Caterpillar (2p)
  • Ninety Eight (4p)
• Catch and Collect
  • Enchère (3p)
  • GOPS (2p)
  • Go Fish (2p) limited deck
  • Turn the Tide (3p)
• Draw and Discard
  • Golf Six (2-4p)
  • Lost Cities (2p)
  • Spite and Malice (2p)
• Exchange
  • Cuckoo (6p)
  • Schwimmen (5p)
• Fishing
  • Scopa (2p)
  • Stealing Bundles (2-4p)
• Poker
  • Kuhn Poker (2p)
  • Leduc Poker (2p)
• Press Your Luck
  • BlackJack (2p)
  • Pairs (2-5p)
    • Continuous Pairs (4p)
    • Calamity Continuous Pairs (4p)
• Shedding
  • Comet (2p)
  • Crazy Eights (4p)
    • Sane Eights (4p)
  • Simon's Cat (4p)
• Trick Taking
  • 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)
  • All Fours
    • California Jack (2p)
    • Pitch (4p)
    • Shasta Sam (4p)
  • Others
    • Agram (2-5p)
    • Duck Soup (2p)
    • Euchre (4p)
    • German Whist (2p)
    • Sheepshead (5p)
      • Cheesheads (5p)
    • Skittgube (3p)
    • Spades (4p)
    • Sueca (4p)
    • The Bottle Imp (3-4p)
    • Whist (4p)
• Unique
  • Coloretto (4p)
  • Coup (4p)
  • LAMA (2-6p)
  • No Thanks (3-5p)

Requirements

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

Setup

1. Open CardStock folder in the project using Visual Studio Code.
2. Install .NET Install Tool Extension
3. Get .Net Core 9.0
4. Install C# Dev Kit Extension
5. Open the CardStock subdirectory
6. Write up your game in RECYCLE in the games subdirectory.
7. Alter the Program.cs class to specify the name of your game.
8. Run the program in either Release or Debug mode.
9. For Release mode, in the terminal type "dotnet run --configuration Release"
10. Choose "Release Mode" to only see the results, or "Debug Mode" to see all game actions (better logs in the future).

References

• 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