# famfamfamfamfamfam/monopoly architecture

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

- Interactive diagram: https://gitdiagram.com/famfamfamfamfamfam/monopoly
- Repository: https://github.com/famfamfamfamfamfam/monopoly

## Overview

##### Project type and purpose
- This is a Unity‐based board game (Monopoly) application. It runs standalone in the Unity engine without a separate backend server.
- It uses Unity Scenes, prefabs, 3D models, scriptable‐object data for configuration, and a layered scripts folder for data, logic, UI, and sound.

##### File structure
- Top‐level Unity folders: Assets, Packages, ProjectSettings.
- Assets/Scenes: two scenes—StartGame (entry) and GamePlay.
- Assets/Resources & Assets/Prefabs: visual and audio assets loaded at runtime.
- Assets/Scripts: subdivided into
- Data: context, initializer, scriptable‐object config structures
- Logic: low‐level data services, high‐level card/build/trigger services, GameObject component scripts, orchestration (GameManager/Driver), and scene utilities
- UI: scene‐specific managers & panels
- Sound: AudioManager & resource setters
- Packages: third‐party libs (MessagePack, etc.)
- ProjectSettings: Unity engine configuration

##### Detail
- Major folder’s role as a component.
- Initialization sequence, runtime orchestration, service calls, and event subscriptions.
- Scriptable‐object config assets as external data sources feeding into the data layer.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Unity Engine" 
        direction TB

        subgraph "Scene: StartGame" 
            direction TB
            CursorMover["CursorMover"]:::ui
            SliderDataWrapper["SliderDataWrapper"]:::ui
            CompositionRoot["CompositionRoot"]:::data
            ConfigInitializer["ConfigInitializer"]:::data
            DataInitializer["DataInitializer"]:::data
        end

        CompositionRoot -->|bootstraps| ConfigInitializer
        ConfigInitializer -->|loads ScriptableObjects| DataInitializer

        subgraph "Scene: GamePlay"
            direction TB

            subgraph "Data Layer"
                direction TB
                subgraph "ScriptableObject Configs" 
                    direction TB
                    BusTicketsConfig["BusTicketsConfig"]:::data
                    ChancesConfig["ChancesConfig"]:::data
                    CommunityChestsConfig["CommunityChestsConfig"]:::data
                    GlobalConfig["GlobalConfig"]:::data
                end
                AllData["AllData"]:::data
            end

            subgraph "Logic Layer"
                direction TB
                subgraph "Low-level Services"
                    direction TB
                    AssetDataService["AssetDataService"]:::logic
                    BoardDataService["BoardDataService"]:::logic
                    PlayerDataService["PlayerDataService"]:::logic
                end
                subgraph "High-level Services"
                    direction TB
                    BuildService["BuildService"]:::logic
                    TriggerSpaceService["TriggerSpaceService"]:::logic
                    CardService["CardService"]:::logic
                end
            end

            subgraph "Orchestration"
                direction TB
                GameManager["GameManager"]:::orchestration
                Driver["Driver"]:::orchestration
                DataManager["DataManager"]:::orchestration
                CursorOptionUpdater["CursorOptionUpdater"]:::orchestration
            end

            subgraph "GameObject Components"
                direction TB
                PlayerController["PlayerController"]:::logic
                DieController["DieController"]:::logic
                CardHandler["CardHandler"]:::logic
                ChanceCardHandler["ChanceCardHandler"]:::logic
                CommunityChestHandler["CommunityChestHandler"]:::logic
                BusTickerHandler["BusTickerHandler"]:::logic
            end

            subgraph "OnScene Utilities"
                direction TB
                Creator["Creator"]:::logic
                InvertedIndexSupporter["InvertedIndexSupporter"]:::logic
                PlayerProvider["PlayerProvider"]:::logic
                PositionArranger["PositionArranger"]:::logic
                RuntimeRefWrapper["RuntimeRefWrapper"]:::logic
            end

            subgraph "UI Layer"
                direction TB
                UIManager["UIManager"]:::ui
                BuildOptionsPanel["BuildOptionsPanel"]:::ui
                CoinsPanel["CoinsPanel"]:::ui
            end

            subgraph "Sound Layer"
                direction TB
                AudioManager["AudioManager"]:::sound
                SoundAdjustor["SoundAdjustor"]:::sound
                AudioResourceSetter["AudioResourceSetter"]:::sound
                Sound["Sound Definitions"]:::sound
            end

            subgraph "Prefabs & Resources"
                direction TB
                Prefabs["Prefabs/Models/Assets"]:::asset
            end

        end

    end

    %% Data flow
    BusTicketsConfig -->|loaded by| DataInitializer
    ChancesConfig -->|loaded by| DataInitializer
    CommunityChestsConfig -->|loaded by| DataInitializer
    GlobalConfig -->|loaded by| DataInitializer
    DataInitializer -->|populates| AllData
    AllData -->|provides data to| AssetDataService & BoardDataService & PlayerDataService
    AssetDataService & BoardDataService & PlayerDataService -->|used by| BuildService & TriggerSpaceService & CardService
    BuildService & TriggerSpaceService & CardService -->|notify| GameManager & Driver & DataManager
    GameManager & Driver & DataManager -->|control| PlayerController & DieController & CardHandler & ChanceCardHandler & CommunityChestHandler & BusTickerHandler
    PlayerController & DieController & CardHandler & ChanceCardHandler & CommunityChestHandler & BusTickerHandler -->|instantiate/update| Prefabs
    GameManager & Driver & DataManager -->|update| UIManager
    UIManager -->|drives| BuildOptionsPanel & CoinsPanel
    GameManager & Driver & DataManager -->|trigger| AudioManager
    AudioManager -->|adjust play| SoundAdjustor & AudioResourceSetter

    %% Scene transitions
    DataInitializer -->|"scene loaded"| GamePlay

    %% Click Events
    click CursorMover "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/UI/StartGameScene/CursorMover.cs"
    click SliderDataWrapper "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/UI/StartGameScene/SliderDataWrapper.cs"
    click CompositionRoot "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Data/Context/CompositionRoot.cs"
    click ConfigInitializer "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Data/ScriptableObjects/Initiation/ConfigInitializer.cs"
    click DataInitializer "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Data/GamePlayData/Initiation/DataInitializer.cs"
    click BusTicketsConfig "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Data/ScriptableObjects/Structure/BusTicketsConfig.cs"
    click ChancesConfig "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Data/ScriptableObjects/Structure/ChancesConfig.cs"
    click CommunityChestsConfig "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Data/ScriptableObjects/Structure/CommunityChestsConfig.cs"
    click GlobalConfig "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Data/ScriptableObjects/Structure/GlobalConfig.cs"
    click AllData "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Data/GamePlayData/Structure/AllData.cs"
    click AssetDataService "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/DataManipulation/LowService/AssetDataService.cs"
    click BoardDataService "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/DataManipulation/LowService/BoardDataService.cs"
    click PlayerDataService "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/DataManipulation/LowService/PlayerDataService.cs"
    click BuildService "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/DataManipulation/Context/BuildService.cs"
    click TriggerSpaceService "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/DataManipulation/Context/TriggerSpaceService.cs"
    click CardService "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/DataManipulation/HighService/CardService.cs"
    click GameManager "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/Orchestration/GameManager.cs"
    click Driver "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/Orchestration/Driver.cs"
    click DataManager "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/Orchestration/DataManager.cs"
    click CursorOptionUpdater "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/Orchestration/CursorOptionUpdater.cs"
    click PlayerController "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/GameObjectComponent/Component/PlayerController.cs"
    click DieController "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/GameObjectComponent/Component/DieController.cs"
    click CardHandler "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/GameObjectComponent/Component/CardHandler.cs"
    click ChanceCardHandler "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/GameObjectComponent/Component/ChanceCardHandler.cs"
    click CommunityChestHandler "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/GameObjectComponent/Component/CommunityChestHandler.cs"
    click BusTickerHandler "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Logic/GameObjectComponent/Component/BusTickerHandler.cs"
    click UIManager "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/UI/GamePlayScene/UIManager.cs"
    click BuildOptionsPanel "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/UI/GamePlayScene/BuildOptionsPanel.cs"
    click AudioManager "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Sound/AudioManager.cs"
    click SoundAdjustor "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Sound/SoundAdjustor.cs"
    click AudioResourceSetter "https://github.com/famfamfamfamfamfam/monopoly/blob/New/Assets/Scripts/Sound/AudioResourceSetter.cs"

    %% Styles
    classDef data fill:#ADD8E6,stroke:#1E90FF,color:#000
    classDef logic fill:#98FB98,stroke:#2E8B57,color:#000
    classDef ui fill:#FFFF99,stroke:#CCCC00,color:#000
    classDef sound fill:#FFDAB9,stroke:#FF8C00,color:#000
    classDef orchestration fill:#E6E6FA,stroke:#9370DB,color:#000
    classDef asset fill:#D3D3D3,stroke:#696969,color:#000
```
