cwc-cartes 1.0.0

Create helper cards for Cold War Commander from list of units and pictures

cwc-cartes

Generate printable unit cards for the Cold War Commander tabletop game.

Given a folder of unit photos and a units.json file, the tool composites card images and saves them as PNGs.

Example output

Installation

pip install cwc-cartes

Or from source:

pip install -e .

Requires Python 3.9+.

Usage

Generate cards

python -m cwc_cartes.main <folder>

The folder must contain a units.json file and the background images it references. Cards are written to <folder>/generated/.

Options:

Flag	Description
-rotate	Rotate each card 90°
-no-bleeding-margins	Omit the 36 px bleeding margin added around cards by default

Convert a raw army list to JSON

python -m cwc_cartes.converter <raw_file> <country_code> <army_name> <output.json>

The raw file must be a plain-text list where every 9 consecutive lines describe one unit: name, arm, move, combat (attacks/range), hits, save, (blank), (blank), notes.

units.json format

[
  {
    "country": "FR",
    "army": "French Army, Cold War/1st Gulf War/Modern (46+)",
    "name": "AMX AuF1",
    "arm": "artillery",
    "move": "30",
    "attacks": "4",
    "range": "-",
    "hits": "5",
    "save": "6",
    "notes": "Heavy Artillery: 5/100(H) attacks using direct fire while on-table",
    "flavour": "",
    "images": ["FR/7274.jpg"]
  }
]

• country — uppercase ISO country code; must match a file in cwc_cartes/images/country_flags/
• arm — unit type; must match a file in cwc_cartes/images/unit_icons/ (without .png)
• images — paths relative to the folder, or http(s):// URLs
• "invisible": true — skip card generation for this unit

License

MIT