PyScoundrel

A Python implementation of Scoundrel, a single-player roguelike card game by Zach Gage and Kurt Bieg.

Installation

pip install pyscoundrel

Play

python -m pyscoundrel

# With a fixed seed (reproducible game)
python -m pyscoundrel --seed 42

# Custom dungeon
python -m pyscoundrel --dungeon my_dungeon.yaml

Features

• Complete Scoundrel rules — monsters, weapons, potions, room avoidance
• Clean terminal UI powered by Rich
• YAML-based dungeon system for custom card pools
• Agent API for automated players and strategy experiments
• JSON event logging for game analysis
• Random seed support for reproducible playthroughs

Programmatic usage

from pyscoundrel import GameEngine, Dungeon

engine = GameEngine(seed=42)
engine.start_game()

while not engine.is_game_over:
    engine.draw_room()
    result = engine.face_card(0)
    # inspect result.metadata to handle monsters, weapons, potions

print(f"Victory: {engine.state.victory} | Score: {engine.state.score}")

Documentation

Full documentation at pyscoundrel.readthedocs.io:

• Quick Start
• Dungeon Configuration
• Logging
• API Reference

License

MIT. The original Scoundrel game is © 2011 Zach Gage and Kurt Bieg.