# exekx/fs25_realisticharvesting architecture

> Architecture diagram of the GitHub repository exekx/fs25_realisticharvesting, 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/exekx/fs25_realisticharvesting
- Repository: https://github.com/exekx/fs25_realisticharvesting

## Overview

Realistic Harvesting is an FS25 gameplay mod that makes combine operation respond to crop, machine, and terrain load. The documented player workflow is to harvest with an equipped combine, monitor live telemetry and crop loss, and adjust settings at the calibration terminal; settings persist across savegames. The tree suggests separate physics, UI, settings, networking, and integration modules, but no source excerpts were provided, so internal call ownership and unsampled implementation details cannot be verified. Edges below reflect README-documented behavior only.

Main entry points: [`src/rhm_Combine.lua`](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/rhm_Combine.lua) (Combine Operation), [`src/settings/RHM_SettingsManager.lua`](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_SettingsManager.lua) (Settings Manager), [`src/logic/RHM_LoadCalculator.lua`](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/logic/RHM_LoadCalculator.lua) (Load Calculator), [`src/gui/RHM_CombineCalibrationGUI.lua`](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/gui/RHM_CombineCalibrationGUI.lua) (Calibration Terminal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Combine Runtime"]
  node_combine["Combine Operation<br/>[rhm_Combine.lua]"]
  node_cutter["Cutter Operation<br/>[rhm_Cutter.lua]"]
  node_modentry["Mod Runtime<br/>[main.lua]"]
end

subgraph group_physics["Harvest Physics"]
  node_loadcalc["Load Calculator"]
  node_settingsdb[("Combine Settings Data")]
end

subgraph group_interface["Player Interface"]
  node_calibration["Calibration Terminal"]
  node_hud["Telemetry HUD"]
  node_notifications["Warnings and Alarms"]
  node_settingsui["Settings UI<br/>[RHM_SettingsUI.lua]"]
  node_settingsgui["Settings GUI"]
end

subgraph group_state["Settings and Sync"]
  node_settings["Runtime Settings<br/>[RHM_Settings.lua]"]
  node_configuration[("Save Configuration")]
  node_profiles["Profiles"]
  node_memory[("Crop Speed Memory")]
  node_settingsmanager["Settings Manager"]
  node_sync["Settings Sync"]
  node_syncevent["Settings Sync Event"]
  node_combineevent["Combine Settings Event"]
end

subgraph group_integration["External Integrations"]
  node_api["Mod API<br/>[RHM_Api.lua]"]
  node_compatibility["Mod Compatibility"]
  node_moisture["Moisture Adapter"]
end

node_player(("Player"))
node_fs25["Farming Simulator 25"]

node_player -->|"operates"| node_combine
node_fs25 -->|"hosts"| node_modentry
node_combine -->|"balances load"| node_loadcalc
node_loadcalc -->|"limits speed"| node_combine
node_combine -->|"uses header"| node_cutter
node_combine -->|"shows telemetry"| node_hud
node_combine -->|"signals overload"| node_notifications
node_player -->|"tunes machine"| node_calibration
node_player -->|"toggles display"| node_hud
node_calibration -->|"adjusts parameters"| node_settingsdb
node_settingsmanager -->|"persists settings"| node_configuration
node_settingsmanager -->|"protects profiles"| node_profiles
node_combine -->|"remembers pace"| node_memory
node_combine -.->|"reads moisture"| node_moisture
node_combine -.->|"supports AI tuning"| node_compatibility
node_sync -.->|"syncs settings"| node_syncevent
node_combine -.->|"shares settings"| node_combineevent
node_player -.->|"configures mod"| node_settingsui
node_settingsui -.->|"opens controls"| node_settingsgui
node_settingsmanager -.->|"manages values"| node_settings
node_api -.->|"exposes interface"| node_fs25

click node_combine "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/rhm_Combine.lua"
click node_cutter "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/rhm_Cutter.lua"
click node_modentry "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/main.lua"
click node_loadcalc "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/logic/RHM_LoadCalculator.lua"
click node_settingsdb "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/data/RHM_CombineSettingsDatabase.lua"
click node_calibration "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/gui/RHM_CombineCalibrationGUI.lua"
click node_hud "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/hud/RHM_DraggableHUD.lua"
click node_notifications "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/hud/RHM_NotificationManager.lua"
click node_settingsui "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_SettingsUI.lua"
click node_settingsgui "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_SettingsGUI.lua"
click node_settings "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_Settings.lua"
click node_configuration "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_Configuration.lua"
click node_profiles "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_ProfileManager.lua"
click node_memory "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_CombineMemory.lua"
click node_settingsmanager "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_SettingsManager.lua"
click node_sync "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/network/RHM_SettingsSync.lua"
click node_syncevent "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/network/RHM_SettingsSyncEvent.lua"
click node_combineevent "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/network/RHM_CombineSettingsEvent.lua"
click node_api "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/integration/RHM_Api.lua"
click node_compatibility "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/integration/RHM_ModCompatibility.lua"
click node_moisture "https://github.com/exekx/fs25_realisticharvesting/blob/main/src/integration/RHM_MoistureAdapter.lua"

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_combine,node_cutter,node_modentry toneBlue
class node_loadcalc,node_settingsdb toneAmber
class node_calibration,node_hud,node_notifications,node_settingsui,node_settingsgui toneMint
class node_settings,node_configuration,node_profiles,node_memory,node_settingsmanager,node_sync,node_syncevent,node_combineevent toneRose
class node_api,node_compatibility,node_moisture,node_player,node_fs25 toneIndigo
```

## Components

### Combine Runtime

- [Combine Operation](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/rhm_Combine.lua): `src/rhm_Combine.lua`
- [Cutter Operation](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/rhm_Cutter.lua): `src/rhm_Cutter.lua`
- [Mod Runtime](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/main.lua): `src/main.lua`

### Harvest Physics

- [Load Calculator](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/logic/RHM_LoadCalculator.lua): `src/logic/RHM_LoadCalculator.lua`
- [Combine Settings Data](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/data/RHM_CombineSettingsDatabase.lua): `src/data/RHM_CombineSettingsDatabase.lua`

### Player Interface

- [Calibration Terminal](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/gui/RHM_CombineCalibrationGUI.lua): `src/gui/RHM_CombineCalibrationGUI.lua`
- [Telemetry HUD](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/hud/RHM_DraggableHUD.lua): `src/hud/RHM_DraggableHUD.lua`
- [Warnings and Alarms](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/hud/RHM_NotificationManager.lua): `src/hud/RHM_NotificationManager.lua`
- [Settings UI](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_SettingsUI.lua): `src/settings/RHM_SettingsUI.lua`
- [Settings GUI](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_SettingsGUI.lua): `src/settings/RHM_SettingsGUI.lua`

### Settings and Sync

- [Runtime Settings](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_Settings.lua): `src/settings/RHM_Settings.lua`
- [Save Configuration](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_Configuration.lua): `src/settings/RHM_Configuration.lua`
- [Profiles](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_ProfileManager.lua): `src/settings/RHM_ProfileManager.lua`
- [Crop Speed Memory](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_CombineMemory.lua): `src/settings/RHM_CombineMemory.lua`
- [Settings Manager](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/settings/RHM_SettingsManager.lua): `src/settings/RHM_SettingsManager.lua`
- [Settings Sync](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/network/RHM_SettingsSync.lua): `src/network/RHM_SettingsSync.lua`
- [Settings Sync Event](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/network/RHM_SettingsSyncEvent.lua): `src/network/RHM_SettingsSyncEvent.lua`
- [Combine Settings Event](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/network/RHM_CombineSettingsEvent.lua): `src/network/RHM_CombineSettingsEvent.lua`

### External Integrations

- [Mod API](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/integration/RHM_Api.lua): `src/integration/RHM_Api.lua`
- [Mod Compatibility](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/integration/RHM_ModCompatibility.lua): `src/integration/RHM_ModCompatibility.lua`
- [Moisture Adapter](https://github.com/exekx/fs25_realisticharvesting/blob/main/src/integration/RHM_MoistureAdapter.lua): `src/integration/RHM_MoistureAdapter.lua`

### Other components

- **Player**
- **Farming Simulator 25**

## Connections

- Player → Combine Operation: operates (evidence: `README.md`)
- Farming Simulator 25 → Mod Runtime: hosts (evidence: `README.md`)
- Combine Operation → Load Calculator: balances load (evidence: `README.md`)
- Load Calculator → Combine Operation: limits speed (evidence: `README.md`)
- Combine Operation → Cutter Operation: uses header (evidence: `README.md`)
- Combine Operation → Telemetry HUD: shows telemetry (evidence: `README.md`)
- Combine Operation → Warnings and Alarms: signals overload (evidence: `README.md`)
- Player → Calibration Terminal: tunes machine (evidence: `README.md`)
- Player → Telemetry HUD: toggles display (evidence: `README.md`)
- Calibration Terminal → Combine Settings Data: adjusts parameters (evidence: `README.md`)
- Settings Manager → Save Configuration: persists settings (evidence: `README.md`)
- Settings Manager → Profiles: protects profiles (evidence: `README.md`)
- Combine Operation → Crop Speed Memory: remembers pace (evidence: `README.md`)
- Combine Operation → Moisture Adapter: reads moisture (evidence: `README.md`)
- Combine Operation → Mod Compatibility: supports AI tuning (evidence: `README.md`)
- Settings Sync → Settings Sync Event: syncs settings
- Combine Operation → Combine Settings Event: shares settings
- Player → Settings UI: configures mod
- Settings UI → Settings GUI: opens controls
- Settings Manager → Runtime Settings: manages values
- Mod API → Farming Simulator 25: exposes interface
