Solo RPG

PF Endless Treasure Software

Written by

tgenedavis

in

I built a tiny open‑source app that lets you “shuffle” Paizo’s Deck of Endless Treasure on your computer and spit out polished, ready‑to‑use loot—perfect for solo journaling, hex‑crawls, or fast prep.

Software version of the Deck of Endless Treasure

PF Endless Treasure is a lightweight Python app that simulates draws from Paizo’s Pathfinder Deck of Endless Treasure using JPGs you purchase from Paizo. You point the app at a folder of your deck images, and it shuffles and reveals a 5‑card layout (four backs + one front) the same way you’d do with the hardcopy of the deck. Everything runs locally; nothing leaves your machine. It’s free and MIT‑licensed.

You can get it over at GitHub. A little bit of Python app experience is helpful.

If you haven’t seen the deck: you combine four cards to generate a unique magic item (type, level, look, quirks, and hooks) with over 100 million possible combinations. The items are generic enough that you can adapt them to RPGs other than Pathfinder, too.

For solo players

  • Speed: One key press gives you a new treasure result, ideal for keeping momentum in a solo session.

  • Focus: A clean, felt‑table visual lets you see the draw without juggling physical cards or watching them slide off each other over and over.

  • Offline & distraction‑free: Runs locally; great on travel laptops or session‑only devices.

  • Reproducible: Browse card fronts/backs by section or jump straight to an Item # to revisit a prior find.

Features at a glance

  • Two tabs:
    Random: auto‑composed treasure layout with soft shadows on a felt background.
    Browser: flip individual cards, navigate by section, or scroll continuously. Browse the cards including instructions, tables and items.

  • Fast controls:
    Space / N / Enter for a fresh draw; Left/Right to browse; Flip to toggle front/back; Ctrl+L to focus the Item # jump.

  • Smart indexing:
    Random draws use the item cards; the browser covers the whole deck (instructions, tables, miscellany, and items). Mapping notes and wrap‑around navigation make it painless to find what you need.

  • No bundled IP:
    The repo includes no Paizo text or art. You supply your own legally obtained images. The project follows Paizo’s Community Use Policy (CUP) and is non‑commercial.

One‑minute setup

  1. Install Python 3.10+

  2. Clone the repo

  3. Put your deck JPGs in a folder (for example, ./cards/)

  4. Install deps:

pip install -r requirements.txt

  1. Run it:

# Linux/macOS
./run.sh --cards ./cards# Windows (Command Prompt)
run.bat –cards .\cards

Prefer the direct route? python endless_treasure.py --cards ./cards (the app will offer a folder picker if needed).

Optional: Build a one‑file desktop executable with PyInstaller if you want to run it without Python installed.

A quick solo‑play recipe

  1. When your character searches a room or completes a milestone, hit New Treasure.

  2. Jot an item name and properties straight from the draw.

  3. If you want to tune flavor or rarity, pop to Browser, jump by Item #, and flip between fronts/backs until you like the result.

Respecting Paizo’s policies

This is an unofficial fan tool. It doesn’t redistribute Paizo assets, charge for access, or imply endorsement. To use it, you must provide your own legally obtained images for the deck. For details on allowed use, see Paizo’s Community Use Policy.

More posts