39 lines
937 B
Markdown
39 lines
937 B
Markdown
# 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
|
|
|
|
```bash
|
|
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`
|