# megamek/mekhq architecture

> Architecture diagram of the GitHub repository megamek/mekhq, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/megamek/mekhq
- Repository: https://github.com/megamek/mekhq

## Overview

MekHQ is a Java companion application for running MegaMek campaigns. The main user journey is campaign management: organize personnel, forces, units, and equipment; manage contracts and finances; then generate and play scenarios, including the StratCon campaign mode. Campaign options configure these systems, and autosaving preserves campaign state. The tree and excerpts establish several domain areas, but do not expose the full GUI-to-campaign call chain; unverified links are therefore omitted rather than inferred.

Main entry points: [`MekHQ/src/mekhq/campaign/Campaign.java`](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/Campaign.java) (Campaign state), [`MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java`](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java) (StratCon deployment), [`MekHQ/src/mekhq/service/PartsAcquisitionService.java`](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/service/PartsAcquisitionService.java) (Parts acquisition), [`MekHQ/src/mekhq/campaign/personnel/Person.java`](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/personnel/Person.java) (Personnel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_app["MekHQ app<br/>[MekHQ.java]"]
end

subgraph group_campaign["Campaign Management"]
  node_campaign[("Campaign state<br/>[Campaign.java]")]
  node_options["Campaign options"]
  node_personnel["Personnel<br/>[Person.java]"]
  node_forces["Forces<br/>[Formation.java]"]
  node_units["Units<br/>[Unit.java]"]
  node_parts["Parts and repair<br/>[Part.java]"]
  node_finance["Finances<br/>[Finances.java]"]
  node_skilltypes["Skill definitions<br/>[SkillType.java]"]
  node_engineparts["Engine parts<br/>[EnginePart.java]"]
  node_missingengine["Missing engine parts"]
  node_injury["Injury location"]
end

subgraph group_operations["Operations"]
  node_contracts["Contracts"]
  node_scenarios["Scenarios<br/>[Scenario.java]"]
  node_stratcon["StratCon rules"]
  node_deployment["StratCon deployment"]
  node_ratgen["RAT rules bootstrap"]
end

subgraph group_services["Campaign Services"]
  node_acquisition["Parts acquisition"]
  node_mrms["MRMS service<br/>[MRMSService.java]"]
  node_autosave["Autosave"]
end

node_player(("Player"))

node_player -->|"runs"| node_app
node_app -->|"starts game"| node_scenarios
node_campaign -->|"reads options"| node_options
node_campaign -.->|"uses personnel"| node_personnel
node_campaign -.->|"uses forces"| node_forces
node_campaign -.->|"tracks units"| node_units
node_campaign -->|"shops for items"| node_parts
node_campaign -.->|"manages contracts"| node_contracts
node_campaign -.->|"tracks finances"| node_finance
node_deployment -->|"uses rules"| node_stratcon
node_deployment -->|"uses campaign"| node_campaign
node_deployment -->|"uses formations"| node_forces
node_deployment -->|"sets up scenarios"| node_scenarios
node_acquisition -->|"uses campaign"| node_campaign
node_acquisition -->|"acquires parts"| node_parts
node_acquisition -->|"uses personnel"| node_personnel
node_acquisition -->|"uses units"| node_units
node_mrms -->|"uses campaign"| node_campaign
node_mrms -->|"uses parts"| node_parts
node_mrms -->|"uses formations"| node_forces
node_autosave -->|"saves campaign"| node_campaign
node_engineparts -->|"creates missing parts"| node_missingengine
node_engineparts -->|"uses campaign"| node_campaign
node_parts -->|"prices by options"| node_options
node_injury -->|"uses personnel"| node_personnel
node_personnel -->|"reads options"| node_options

click node_app "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/MekHQ.java"
click node_campaign "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/Campaign.java"
click node_options "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/campaignOptions/CampaignOptions.java"
click node_personnel "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/personnel/Person.java"
click node_forces "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/force/Formation.java"
click node_units "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/unit/Unit.java"
click node_parts "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/parts/Part.java"
click node_finance "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/finances/Finances.java"
click node_contracts "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/mission/contract/AbstractContract.java"
click node_scenarios "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/mission/scenarios/Scenario.java"
click node_stratcon "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/digitalGM/stratCon/StratConRulesManager.java"
click node_deployment "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java"
click node_acquisition "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/service/PartsAcquisitionService.java"
click node_mrms "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/service/mrms/MRMSService.java"
click node_autosave "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/service/AutosaveService.java"
click node_skilltypes "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/personnel/skills/SkillType.java"
click node_engineparts "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/parts/EnginePart.java"
click node_missingengine "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/parts/missing/MissingEnginePart.java"
click node_injury "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/personnel/medical/advancedMedicalAlternate/InjuryLocationService.java"
click node_ratgen "https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/universe/commandGeneration/ratgen/RulesetEngineBootstrap.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app toneBlue
class node_campaign,node_options,node_personnel,node_forces,node_units,node_parts,node_finance,node_skilltypes,node_engineparts,node_missingengine,node_injury toneAmber
class node_contracts,node_scenarios,node_stratcon,node_deployment,node_ratgen toneMint
class node_acquisition,node_mrms,node_autosave toneRose
class node_player toneIndigo
```

## Components

### Application

- [MekHQ app](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/MekHQ.java): `MekHQ/src/mekhq/MekHQ.java`

### Campaign Management

- [Campaign state](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/Campaign.java): `MekHQ/src/mekhq/campaign/Campaign.java`
- [Campaign options](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/campaignOptions/CampaignOptions.java): `MekHQ/src/mekhq/campaign/campaignOptions/CampaignOptions.java`
- [Personnel](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/personnel/Person.java): `MekHQ/src/mekhq/campaign/personnel/Person.java`
- [Forces](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/force/Formation.java): `MekHQ/src/mekhq/campaign/force/Formation.java`
- [Units](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/unit/Unit.java): `MekHQ/src/mekhq/campaign/unit/Unit.java`
- [Parts and repair](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/parts/Part.java): `MekHQ/src/mekhq/campaign/parts/Part.java`
- [Finances](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/finances/Finances.java): `MekHQ/src/mekhq/campaign/finances/Finances.java`
- [Skill definitions](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/personnel/skills/SkillType.java): `MekHQ/src/mekhq/campaign/personnel/skills/SkillType.java`
- [Engine parts](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/parts/EnginePart.java): `MekHQ/src/mekhq/campaign/parts/EnginePart.java`
- [Missing engine parts](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/parts/missing/MissingEnginePart.java): `MekHQ/src/mekhq/campaign/parts/missing/MissingEnginePart.java`
- [Injury location](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/personnel/medical/advancedMedicalAlternate/InjuryLocationService.java): `MekHQ/src/mekhq/campaign/personnel/medical/advancedMedicalAlternate/InjuryLocationService.java`

### Operations

- [Contracts](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/mission/contract/AbstractContract.java): `MekHQ/src/mekhq/campaign/mission/contract/AbstractContract.java`
- [Scenarios](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/mission/scenarios/Scenario.java): `MekHQ/src/mekhq/campaign/mission/scenarios/Scenario.java`
- [StratCon rules](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/digitalGM/stratCon/StratConRulesManager.java): `MekHQ/src/mekhq/campaign/digitalGM/stratCon/StratConRulesManager.java`
- [StratCon deployment](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java): `MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java`
- [RAT rules bootstrap](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/campaign/universe/commandGeneration/ratgen/RulesetEngineBootstrap.java): `MekHQ/src/mekhq/campaign/universe/commandGeneration/ratgen/RulesetEngineBootstrap.java`

### Campaign Services

- [Parts acquisition](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/service/PartsAcquisitionService.java): `MekHQ/src/mekhq/service/PartsAcquisitionService.java`
- [MRMS service](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/service/mrms/MRMSService.java): `MekHQ/src/mekhq/service/mrms/MRMSService.java`
- [Autosave](https://github.com/megamek/mekhq/blob/main/MekHQ/src/mekhq/service/AutosaveService.java): `MekHQ/src/mekhq/service/AutosaveService.java`

### Other components

- **Player**

## Connections

- Player → MekHQ app: runs
- MekHQ app → Scenarios: starts game (evidence: `MekHQ/src/mekhq/MekHQ.java`)
- Campaign state → Campaign options: reads options (evidence: `MekHQ/src/mekhq/campaign/Campaign.java`)
- Campaign state → Personnel: uses personnel (evidence: `MekHQ/src/mekhq/campaign/personnel/Person.java`)
- Campaign state → Forces: uses forces (evidence: `MekHQ/src/mekhq/campaign/force/Formation.java`)
- Campaign state → Units: tracks units (evidence: `MekHQ/src/mekhq/campaign/Campaign.java`)
- Campaign state → Parts and repair: shops for items (evidence: `MekHQ/src/mekhq/campaign/Campaign.java`)
- Campaign state → Contracts: manages contracts (evidence: `MekHQ/src/mekhq/campaign/mission/contract/AbstractContract.java`)
- Campaign state → Finances: tracks finances (evidence: `MekHQ/src/mekhq/campaign/Campaign.java`)
- StratCon deployment → StratCon rules: uses rules (evidence: `MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java`)
- StratCon deployment → Campaign state: uses campaign (evidence: `MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java`)
- StratCon deployment → Forces: uses formations (evidence: `MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java`)
- StratCon deployment → Scenarios: sets up scenarios (evidence: `MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java`)
- Parts acquisition → Campaign state: uses campaign (evidence: `MekHQ/src/mekhq/service/PartsAcquisitionService.java`)
- Parts acquisition → Parts and repair: acquires parts (evidence: `MekHQ/src/mekhq/service/PartsAcquisitionService.java`)
- Parts acquisition → Personnel: uses personnel (evidence: `MekHQ/src/mekhq/service/PartsAcquisitionService.java`)
- Parts acquisition → Units: uses units (evidence: `MekHQ/src/mekhq/service/PartsAcquisitionService.java`)
- MRMS service → Campaign state: uses campaign (evidence: `MekHQ/src/mekhq/service/mrms/MRMSService.java`)
- MRMS service → Parts and repair: uses parts (evidence: `MekHQ/src/mekhq/service/mrms/MRMSService.java`)
- MRMS service → Forces: uses formations (evidence: `MekHQ/src/mekhq/service/mrms/MRMSService.java`)
- Autosave → Campaign state: saves campaign (evidence: `MekHQ/src/mekhq/service/AutosaveService.java`)
- Engine parts → Missing engine parts: creates missing parts (evidence: `MekHQ/src/mekhq/campaign/parts/EnginePart.java`)
- Engine parts → Campaign state: uses campaign (evidence: `MekHQ/src/mekhq/campaign/parts/EnginePart.java`)
- Parts and repair → Campaign options: prices by options (evidence: `MekHQ/src/mekhq/campaign/parts/Part.java`)
- Injury location → Personnel: uses personnel (evidence: `MekHQ/src/mekhq/campaign/personnel/medical/advancedMedicalAlternate/InjuryLocationService.java`)
- Personnel → Campaign options: reads options (evidence: `MekHQ/src/mekhq/campaign/personnel/Person.java`)
