# apricot-ale/kp-liberation-apr architecture

> Architecture diagram of the GitHub repository apricot-ale/kp-liberation-apr, 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/apricot-ale/kp-liberation-apr
- Repository: https://github.com/apricot-ale/kp-liberation-apr

## Overview

KP Liberation APR is an Arma 3 co-op mission framework fork, intended as a base for mission customization. Players interact with gameplay through mission dialogs and overlays; the framework registers gameplay functions and client/server function sets. The tree shows many named UI capabilities, but not their handlers or runtime call paths, so those links are omitted rather than inferred. The sampled files do not expose implementation details for the registered functions.

Main entry points: [`Missionframework/CfgFunctions.hpp`](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/CfgFunctions.hpp) (Function registry), [`Missionframework/functions`](https://github.com/apricot-ale/kp-liberation-apr/tree/v0.96.8-APR-STABLE/Missionframework/functions) (Gameplay functions), [`Missionframework/scripts/client/CfgFunctions.hpp`](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/scripts/client/CfgFunctions.hpp) (Client functions), [`Missionframework/scripts/server/CfgFunctions.hpp`](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/scripts/server/CfgFunctions.hpp) (Server functions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Mission functions"]
  node_gameplay_functions["Gameplay functions"]
  node_client_functions["Client functions<br/>[CfgFunctions.hpp]"]
  node_server_functions["Server functions<br/>[CfgFunctions.hpp]"]
  node_ui_functions["UI functions"]
end

subgraph group_player_ui["Player interface"]
  node_mission_ui["Mission dialogs"]
  node_build_deploy["Build and deploy"]
  node_logistics["Logistics"]
  node_production["Production"]
  node_arsenal["Arsenal"]
  node_recycling["Recycle and repackage"]
  node_deployment_options["HALO and permissions"]
end

subgraph group_special_ui["Additional interfaces"]
  node_squads["Squad management"]
  node_player_management["Player management<br/>[KPGUI_classes.hpp]"]
  node_vehicle_management["Vehicle management"]
  node_plm["PLM dialog<br/>[KPPLM_dialog.hpp]"]
end

subgraph group_framework_config["Framework configuration"]
  node_function_registry["Function registry<br/>[CfgFunctions.hpp]"]
  node_mission_status["Status and notifications"]
  node_mission_parameters["Mission parameters<br/>[mission_params.hpp]"]
end

node_player(("Player"))
node_game_engine{{"Arma 3 engine"}}

node_function_registry -->|"registers"| node_gameplay_functions
node_function_registry -->|"includes"| node_client_functions
node_function_registry -->|"includes"| node_server_functions
node_function_registry -->|"registers"| node_ui_functions
node_player -.->|"uses"| node_mission_ui
node_player -.->|"uses"| node_build_deploy
node_player -.->|"uses"| node_logistics
node_player -.->|"uses"| node_production
node_player -.->|"uses"| node_arsenal
node_player -.->|"uses"| node_recycling
node_player -.->|"uses"| node_deployment_options
node_player -.->|"uses"| node_squads
node_player -.->|"uses"| node_player_management
node_player -.->|"uses"| node_vehicle_management
node_player -.->|"uses"| node_plm
node_game_engine -.->|"runs"| node_gameplay_functions

click node_gameplay_functions "https://github.com/apricot-ale/kp-liberation-apr/tree/v0.96.8-APR-STABLE/Missionframework/functions"
click node_client_functions "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/scripts/client/CfgFunctions.hpp"
click node_server_functions "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/scripts/server/CfgFunctions.hpp"
click node_ui_functions "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/functions/ui/script_components.hpp"
click node_mission_ui "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_interface.hpp"
click node_build_deploy "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_build.hpp"
click node_logistics "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_logistic.hpp"
click node_production "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_production.hpp"
click node_arsenal "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_arsenal.hpp"
click node_recycling "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_recycle.hpp"
click node_deployment_options "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_halo.hpp"
click node_squads "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/GREUH/UI/GREUH_interface.hpp"
click node_player_management "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/KP/KPGUI/KPGUI_classes.hpp"
click node_vehicle_management "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/VAM_GUI/VAM_GUI_classes.hpp"
click node_plm "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/KP/KPPLM/ui/KPPLM_dialog.hpp"
click node_function_registry "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/CfgFunctions.hpp"
click node_mission_status "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_titles.hpp"
click node_mission_parameters "https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/mission_params.hpp"

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_gameplay_functions,node_client_functions,node_server_functions,node_ui_functions toneBlue
class node_mission_ui,node_build_deploy,node_logistics,node_production,node_arsenal,node_recycling,node_deployment_options toneAmber
class node_squads,node_player_management,node_vehicle_management,node_plm toneMint
class node_function_registry,node_mission_status,node_mission_parameters toneRose
class node_player,node_game_engine toneIndigo
```

## Components

### Mission functions

- [Gameplay functions](https://github.com/apricot-ale/kp-liberation-apr/tree/v0.96.8-APR-STABLE/Missionframework/functions): `Missionframework/functions`
- [Client functions](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/scripts/client/CfgFunctions.hpp): `Missionframework/scripts/client/CfgFunctions.hpp`
- [Server functions](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/scripts/server/CfgFunctions.hpp): `Missionframework/scripts/server/CfgFunctions.hpp`
- [UI functions](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/functions/ui/script_components.hpp): `Missionframework/functions/ui/script_components.hpp`

### Player interface

- [Mission dialogs](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_interface.hpp): `Missionframework/ui/liberation_interface.hpp`
- [Build and deploy](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_build.hpp): `Missionframework/ui/liberation_build.hpp`
- [Logistics](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_logistic.hpp): `Missionframework/ui/liberation_logistic.hpp`
- [Production](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_production.hpp): `Missionframework/ui/liberation_production.hpp`
- [Arsenal](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_arsenal.hpp): `Missionframework/ui/liberation_arsenal.hpp`
- [Recycle and repackage](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_recycle.hpp): `Missionframework/ui/liberation_recycle.hpp`
- [HALO and permissions](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_halo.hpp): `Missionframework/ui/liberation_halo.hpp`

### Additional interfaces

- [Squad management](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/GREUH/UI/GREUH_interface.hpp): `Missionframework/GREUH/UI/GREUH_interface.hpp`
- [Player management](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/KP/KPGUI/KPGUI_classes.hpp): `Missionframework/KP/KPGUI/KPGUI_classes.hpp`
- [Vehicle management](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/VAM_GUI/VAM_GUI_classes.hpp): `Missionframework/VAM_GUI/VAM_GUI_classes.hpp`
- [PLM dialog](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/KP/KPPLM/ui/KPPLM_dialog.hpp): `Missionframework/KP/KPPLM/ui/KPPLM_dialog.hpp`

### Framework configuration

- [Function registry](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/CfgFunctions.hpp): `Missionframework/CfgFunctions.hpp`
- [Status and notifications](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/liberation_titles.hpp): `Missionframework/ui/liberation_titles.hpp`
- [Mission parameters](https://github.com/apricot-ale/kp-liberation-apr/blob/v0.96.8-APR-STABLE/Missionframework/ui/mission_params.hpp): `Missionframework/ui/mission_params.hpp`

### Other components

- **Player**
- **Arma 3 engine**

## Connections

- Function registry → Gameplay functions: registers (evidence: `Missionframework/CfgFunctions.hpp`)
- Function registry → Client functions: includes (evidence: `Missionframework/CfgFunctions.hpp`)
- Function registry → Server functions: includes (evidence: `Missionframework/CfgFunctions.hpp`)
- Function registry → UI functions: registers (evidence: `Missionframework/CfgFunctions.hpp`)
- Player → Mission dialogs: uses
- Player → Build and deploy: uses
- Player → Logistics: uses
- Player → Production: uses
- Player → Arsenal: uses
- Player → Recycle and repackage: uses
- Player → HALO and permissions: uses
- Player → Squad management: uses
- Player → Player management: uses
- Player → Vehicle management: uses
- Player → PLM dialog: uses
- Arma 3 engine → Gameplay functions: runs
