# ligameacademy/godot4_turn_based_combat_system architecture

> Architecture diagram of the GitHub repository ligameacademy/godot4_turn_based_combat_system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ligameacademy/godot4_turn_based_combat_system
- Repository: https://github.com/ligameacademy/godot4_turn_based_combat_system

## Overview

##### Project type and purpose
- This is a Godot 4 turn-based combat system teaching/demo project. It’s a single executable game framework that demonstrates how to build a modular, extensible battle system in Godot, covering character stats, skills, status effects, AI, battle flow, and UI.

##### File structure
- Top-level scene entry point: `main.tscn` + `main.gd`.
- `scenes/`: subdivided into `battle`, `characters`, and `ui` subfolders, each holding `.tscn` scenes plus drive-logic `.gd` scripts.
- `scripts/`:
- `autoload/skill_system`: a global singleton skill dispatcher and a set of effect processors.
- `core`: domain-level game logic (battle managers, AI, character components, turn order, combat rules).
- `managers/audio_manager.gd`: a global sound system.
- `resources`: data-wrapper scripts for battle/character/skill/attribute/status/skill_effect resources.
- Build/config files: `project.godot`, `.editorconfig`, `.gitignore`, etc.

##### README for additional insights
- Confirms the componentized design approach: property management, skill processing, battle flow, AI, UI decoupled via signals.
- Mentions future direction: further splitting components, event-bus decoupling, AI behavior trees.

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Presentation Layer"
        MS["Main Scene"]:::presentation
        BS["Battle Scene"]:::presentation
        CS["Character Scene"]:::presentation
        AM["Action Menu"]:::presentation
        BLP["Battle Log Panel"]:::presentation
        CIC["Character Info Container"]:::presentation
        SSM["Skill Select Menu"]:::presentation
        TOI["Turn Order Indicator"]:::presentation
    end

    subgraph "Domain Layer"
        BM["BattleManager"]:::domain
        BSM["BattleStateManager"]:::domain
        TOM["TurnOrderManager"]:::domain
        CRM["CombatRuleManager"]:::domain
        BCRM["BattleCharacterRegistryManager"]:::domain
        CCC["CharacterCombatComponent"]:::domain
        CSC["CharacterSkillComponent"]:::domain
        CAIC["CharacterAIComponent"]:::domain
        CAN["CharacterAnimations"]:::domain
        AIB["AI Behavior Module"]:::domain
        ET["Element Types"]:::domain
    end

    subgraph "Service Layer"
        SS["SkillSystem"]:::service
        DEP["DamageEffectProcessor"]:::service
        HEP["HealingEffectProcessor"]:::service
        ASP["ApplyStatusProcessor"]:::service
        DSP["DispelStatusProcessor"]:::service
        MDP["ModifyDamageEffectProcessor"]:::service
        GEP["Generic EffectProcessor"]:::service
        AMgr["AudioManager"]:::service
    end

    subgraph "Data Layer"
        BD["BattleData"]:::data
        CD["CharacterData"]:::data
        SD["SkillData"]:::data
        SAS["SkillAttributeSet"]:::data
        SED["SkillEffectData"]:::data
        SSD["SkillStatusData"]:::data
        SAM["SkillAttribute Modifier"]:::data
    end

    subgraph "Assets"
        AN["Animations"]:::assets
        SP["Sprites"]:::assets
        TX["Textures/Materials/Icons"]:::assets
        SFX["SFX"]:::assets
    end

    MS -->|"start_battle()"| BS
    BS -->|"init()"| BM
    AM -->|"use_skill()"| BM
    BM -->|"get_state()"| BSM
    BM -->|"get_turn_order()"| TOM
    BM -->|"enforce_rules()"| CRM
    BM -->|"register_characters()"| BCRM
    BM -->|"invoke_skill()"| SS
    SS -->|"process_damage()"| DEP
    SS -->|"process_healing()"| HEP
    SS -->|"process_apply_status()"| ASP
    SS -->|"process_dispel_status()"| DSP
    SS -->|"process_modify_damage()"| MDP
    SS -->|"delegate()"| GEP
    DEP -->|"apply_damage"| CCC
    HEP -->|"apply_heal"| CCC
    ASP -->|"apply_status"| CCC
    DSP -->|"dispel_status"| CCC
    MDP -->|"modify_damage"| CCC
    TOM -->|"turn_start_signal"| CAIC
    CAIC -->|"command()"| BM
    BM -->|"update_ui()"| AM
    BM -->|"update_ui()"| BLP
    BM -->|"update_ui()"| CIC
    BM -->|"update_ui()"| SSM
    BM -->|"update_ui()"| TOI
    AMgr -->|"play_sound()"| SFX

    BD --> BM
    CD --> CCC
    SD --> SS
    SAS --> SS
    SED --> SS
    SSD --> ASP
    SAM --> SAS

    AN --> SD
    SP --> SD
    TX --> SD
    SFX --> AMgr

    click MS "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/main.tscn"
    click MS "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/main.gd"
    click BS "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/battle/battle_scene.tscn"
    click BS "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/battle/battle_scene.gd"
    click CS "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/characters/character.tscn"
    click CS "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/characters/character.gd"
    click AM "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/ui/action_menu.tscn"
    click AM "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/ui/action_menu.gd"
    click BLP "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/ui/battle_log_panel.tscn"
    click BLP "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/ui/battle_log_panel.gd"
    click CIC "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/ui/character_info_container.tscn"
    click CIC "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/ui/character_info_container.gd"
    click SSM "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/ui/skill_select_menu.tscn"
    click SSM "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/ui/skill_select_menu.gd"
    click TOI "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/ui/turn_order_indicator.tscn"
    click TOI "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scenes/ui/turn_order_indicator.gd"
    click BM "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/battle_manager.gd"
    click BSM "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/battle/battle_state_manager.gd"
    click TOM "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/battle/turn_order_manager.gd"
    click CRM "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/battle/combat_rule_manager.gd"
    click BCRM "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/battle/battle_character_registry_manager.gd"
    click CCC "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/character/character_combat_component.gd"
    click CSC "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/character/character_skill_component.gd"
    click CAIC "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/character/character_ai_component.gd"
    click CAN "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/character/character_animations.gd"
    click AIB "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/ai/ai_behavior.gd"
    click ET "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/core/element_types.gd"
    click SS "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/autoload/skill_system/skill_system.gd"
    click DEP "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/autoload/skill_system/effect_processors/damage_effect_processor.gd"
    click HEP "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/autoload/skill_system/effect_processors/healing_effect_processor.gd"
    click ASP "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/autoload/skill_system/effect_processors/apply_status_processor.gd"
    click DSP "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/autoload/skill_system/effect_processors/dispel_status_processor.gd"
    click MDP "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/autoload/skill_system/effect_processors/modify_damage_effect_processor.gd"
    click GEP "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/autoload/skill_system/effect_processors/effect_processor.gd"
    click AMgr "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/managers/audio_manager.gd"
    click BD "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/resources/battle_data.gd"
    click CD "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/resources/character_data.gd"
    click SD "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/resources/skill_data.gd"
    click SAS "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/resources/skill_attribute_set.gd"
    click SED "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/resources/skill_effect_data.gd"
    click SSD "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/resources/skill_status_data.gd"
    click SAM "https://github.com/ligameacademy/godot4_turn_based_combat_system/blob/main/scripts/resources/skill_attribute_modifier.gd"
    classDef presentation fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef domain fill:#90EE90,stroke:#333,stroke-width:1px
    classDef service fill:#DDA0DD,stroke:#333,stroke-width:1px
    classDef data fill:#FFA500,stroke:#333,stroke-width:1px
    classDef assets fill:#D3D3D3,stroke:#333,stroke-width:1px
```
