How megamek/mekhq works
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: Campaign.java Campaign state · StratConDeploymentService.java StratCon deployment · PartsAcquisitionService.java Parts acquisition · Person.java Personnel
Components 21
Application
- MekHQ app
MekHQ/src/mekhq/MekHQ.java
Campaign Management
- Campaign state
MekHQ/src/mekhq/campaign/Campaign.java - Campaign options
MekHQ/src/mekhq/campaign/campaignOptions/CampaignOptions.java - Personnel
MekHQ/src/mekhq/campaign/personnel/Person.java - Forces
MekHQ/src/mekhq/campaign/force/Formation.java - Units
MekHQ/src/mekhq/campaign/unit/Unit.java - Parts and repair
MekHQ/src/mekhq/campaign/parts/Part.java - Finances
MekHQ/src/mekhq/campaign/finances/Finances.java - Skill definitions
MekHQ/src/mekhq/campaign/personnel/skills/SkillType.java - Engine parts
MekHQ/src/mekhq/campaign/parts/EnginePart.java - Missing engine parts
MekHQ/src/mekhq/campaign/parts/missing/MissingEnginePart.java - Injury location
MekHQ/src/mekhq/campaign/personnel/medical/advancedMedicalAlternate/InjuryLocationService.java
Operations
- Contracts
MekHQ/src/mekhq/campaign/mission/contract/AbstractContract.java - Scenarios
MekHQ/src/mekhq/campaign/mission/scenarios/Scenario.java - StratCon rules
MekHQ/src/mekhq/campaign/digitalGM/stratCon/StratConRulesManager.java - StratCon deployment
MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java - RAT rules bootstrap
MekHQ/src/mekhq/campaign/universe/commandGeneration/ratgen/RulesetEngineBootstrap.java
Campaign Services
- Parts acquisition
MekHQ/src/mekhq/service/PartsAcquisitionService.java - MRMS service
MekHQ/src/mekhq/service/mrms/MRMSService.java - Autosave
MekHQ/src/mekhq/service/AutosaveService.java
Other components
- Player
Connections 26
- Player → MekHQ app: runs
- MekHQ app → Scenarios: starts game
MekHQ/src/mekhq/MekHQ.java - Campaign state → Campaign options: reads options
MekHQ/src/mekhq/campaign/Campaign.java - Campaign state → Personnel: uses personnel
MekHQ/src/mekhq/campaign/personnel/Person.java - Campaign state → Forces: uses forces
MekHQ/src/mekhq/campaign/force/Formation.java - Campaign state → Units: tracks units
MekHQ/src/mekhq/campaign/Campaign.java - Campaign state → Parts and repair: shops for items
MekHQ/src/mekhq/campaign/Campaign.java - Campaign state → Contracts: manages contracts
MekHQ/src/mekhq/campaign/mission/contract/AbstractContract.java - Campaign state → Finances: tracks finances
MekHQ/src/mekhq/campaign/Campaign.java - StratCon deployment → StratCon rules: uses rules
MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java - StratCon deployment → Campaign state: uses campaign
MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java - StratCon deployment → Forces: uses formations
MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java - StratCon deployment → Scenarios: sets up scenarios
MekHQ/src/mekhq/campaign/digitalGM/stratCon/deployment/StratConDeploymentService.java - Parts acquisition → Campaign state: uses campaign
MekHQ/src/mekhq/service/PartsAcquisitionService.java - Parts acquisition → Parts and repair: acquires parts
MekHQ/src/mekhq/service/PartsAcquisitionService.java - Parts acquisition → Personnel: uses personnel
MekHQ/src/mekhq/service/PartsAcquisitionService.java - Parts acquisition → Units: uses units
MekHQ/src/mekhq/service/PartsAcquisitionService.java - MRMS service → Campaign state: uses campaign
MekHQ/src/mekhq/service/mrms/MRMSService.java - MRMS service → Parts and repair: uses parts
MekHQ/src/mekhq/service/mrms/MRMSService.java - MRMS service → Forces: uses formations
MekHQ/src/mekhq/service/mrms/MRMSService.java - Autosave → Campaign state: saves campaign
MekHQ/src/mekhq/service/AutosaveService.java - Engine parts → Missing engine parts: creates missing parts
MekHQ/src/mekhq/campaign/parts/EnginePart.java - Engine parts → Campaign state: uses campaign
MekHQ/src/mekhq/campaign/parts/EnginePart.java - Parts and repair → Campaign options: prices by options
MekHQ/src/mekhq/campaign/parts/Part.java - Injury location → Personnel: uses personnel
MekHQ/src/mekhq/campaign/personnel/medical/advancedMedicalAlternate/InjuryLocationService.java - Personnel → Campaign options: reads options
MekHQ/src/mekhq/campaign/personnel/Person.java