warchron_app/README.md
2026-01-15 12:43:40 +01:00

937 B

Wargame_campaign_app

A simple local app to manage players and their scores throughout several organised games of a tabletop wargame.

Features

Main logic

Manage a list of players to sign them up to be selectable for war(s) and campaign(s). A year "war" contains several "campaign" events which contain several "battle" games organised in successive rounds. Battle results determine campaign score which determines the war score. Wars are independent.

Design notes

Players are global identities Influence tokens are scoped to a war Campaign order enables historical tie-breakers Effects are generic → future-proof

Installation

Requirements

  • Python >= 3.12
  • pip

Setup

git clone <your-forge-address>/Wargame_campaign_app.git
cd Wargame_campaign_app
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -r requirements.txt

Run

python main.py