# trentpolack/calvinball architecture

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

- Interactive diagram: https://gitdiagram.com/trentpolack/calvinball
- Repository: https://github.com/trentpolack/calvinball

## Overview

##### Project type and purpose
- This is a monolithic “repo of things” for game-development resources:
– General assets (meshes, terrain)
– Git configuration snippets
– Developer scripts and small tools (Python, PowerShell, AHK, batch, Visual Studio extensions)
– Engine extensions and utilities for Unreal Engine (UE4)
– Unity asset snippets
- It is neither a single service nor a full-stack web app, but an open-source tool & asset collection that supports multiple consumer systems (game engines, editors, pipelines).

##### File structure
Top-level modules each map to a distinct component of the overall ecosystem:
- assets/ – 3D models and terrain outputs used by game engines and tools
- git/ – templates and configs to standardize team version-control workflows
- scripts/ – language-specific tooling subdivided into:
– autohotkey, batch, powershell, python, visualstudio
– individual tools (commit counter, Maya helper, Megascan assembler, VectorField generator, etc.)
- unity/ – shaders and asset snippets for Unity projects
- unrealengine/ – unsupported UE4 content and source patches (shaders, material functions, C++ code)

##### README for additional insights
- Describes each module’s purpose and maintenance status
- Notes WIP Electron app (“joy-create”) in a feature branch (not in main tree) for l-system mesh generation
- Highlights that unrealengine/ holds engine extensibility points (lens flares, pooling, material standards)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Actors
    Developers["Developers"]:::actor
    LocalGitClient["Local Git Client"]:::actor

    %% Central Repository
    GitRepo["Central Git Repository"]:::repo

    %% Assets Subsystem
    subgraph "Assets Subsystem"
        Meshes["Standard Meshes"]:::assets
        Terrain["Terrain Outputs"]:::assets
    end

    %% Git-Config Subsystem
    subgraph "Git-Config Subsystem"
        GitattributesUE["gitattributes.ue5.template"]:::git
        GitattributesUnity["gitattributes.unity.template"]:::git
        GitignoreUE["gitignore.ue5.template"]:::git
        GitignoreUnity["gitignore.unity.template"]:::git
        Gitconfig["gitconfig.template"]:::git
    end

    %% Scripts Subsystem
    subgraph "Scripts Subsystem"
        AHK["Snipping Tool AHK"]:::script
        BatchRename["Rename Branch Batch"]:::script
        BatchPNG["Split RGB Batch"]:::script
        PS["PowerShell Cmdlets"]:::script
        CommitCounter["Commit Counter"]:::script
        MayaHelper["Maya Helper"]:::script
        MegaAssembler["Megascan Assembler"]:::script
        VFGen["VectorField Generator"]:::script
        VFGUI["VectorField GUI"]:::script
        VSext["Visual Studio Extensions"]:::script
    end

    %% Unity Subsystem
    subgraph "Unity Subsystem"
        ShaderGraph["HDRPLit_OrenNayer.shadergraph"]:::engine
    end

    %% Unreal Engine Subsystem
    subgraph "Unreal Engine Subsystem"
        UEContent["UE4 Unsupported Content"]:::engine
        UEShaders["PostProcessAnamorphicFlares.usf"]:::engine
        UERenderer["PostProcessAnamorphicFlares.cpp/.h"]:::engine
        UEDebug["GameDebugStatics .h/.cpp"]:::engine
    end

    %% Engine Editors and Output
    UnityEditor["Unity Editor"]:::external
    UEEditor["UE4 Editor"]:::external
    Processed["Processed Files (OBJ/FBX/etc)"]:::data
    GameProject["Game Project"]:::external

    %% Relationships
    Developers -->|"clones/pulls modules"| GitRepo
    Developers -->|"configures"| LocalGitClient
    GitRepo -->|"provides templates"| LocalGitClient
    GitRepo --> Meshes
    GitRepo --> Terrain
    GitRepo --> GitattributesUE
    GitRepo --> GitattributesUnity
    GitRepo --> GitignoreUE
    GitRepo --> GitignoreUnity
    GitRepo --> Gitconfig
    GitRepo --> AHK
    GitRepo --> BatchRename
    GitRepo --> BatchPNG
    GitRepo --> PS
    GitRepo --> CommitCounter
    GitRepo --> MayaHelper
    GitRepo --> MegaAssembler
    GitRepo --> VFGen
    GitRepo --> VFGUI
    GitRepo --> VSext
    GitRepo --> ShaderGraph
    GitRepo --> UEContent
    GitRepo --> UEShaders
    GitRepo --> UERenderer
    GitRepo --> UEDebug

    %% Data Flow
    subgraph "Tooling Flow"
        AHK & BatchRename & BatchPNG & PS & CommitCounter & MayaHelper & MegaAssembler & VFGen & VFGUI & VSext -->|"consume"| Meshes
        AHK & BatchRename & BatchPNG & PS & CommitCounter & MayaHelper & MegaAssembler & VFGen & VFGUI & VSext -->|"consume"| Terrain
        AHK & BatchRename & BatchPNG & PS & CommitCounter & MayaHelper & MegaAssembler & VFGen & VFGUI & VSext -->|"output"| Processed
    end

    Processed --> UnityEditor
    Processed --> UEEditor

    %% Engine Integration
    UnityEditor -->|"imports shaders/assets"| ShaderGraph
    ShaderGraph --> GameProject
    UEEditor -->|"loads content/code"| UEContent
    UEEditor --> UEShaders
    UEEditor --> UERenderer
    UEEditor --> UEDebug
    UEEditor --> GameProject

    %% Click Events
    click GitRepo "https://github.com/trentpolack/calvinball/tree/develop//"
    click Meshes "https://github.com/trentpolack/calvinball/tree/develop/assets/meshes/standard/"
    click Terrain "https://github.com/trentpolack/calvinball/tree/develop/assets/terrain/"
    click GitattributesUE "https://github.com/trentpolack/calvinball/blob/develop/git/gitattributes.ue5.template"
    click GitattributesUnity "https://github.com/trentpolack/calvinball/blob/develop/git/gitattributes.unity.template"
    click GitignoreUE "https://github.com/trentpolack/calvinball/blob/develop/git/gitignore.ue5.template"
    click GitignoreUnity "https://github.com/trentpolack/calvinball/blob/develop/git/gitignore.unity.template"
    click Gitconfig "https://github.com/trentpolack/calvinball/blob/develop/git/gitconfig.template"
    click AHK "https://github.com/trentpolack/calvinball/blob/develop/scripts/autohotkey/snippingtool.ahk"
    click BatchRename "https://github.com/trentpolack/calvinball/blob/develop/scripts/batch/git_rename_branch.bat"
    click BatchPNG "https://github.com/trentpolack/calvinball/blob/develop/scripts/batch/png16_split_rgb_layers_to_raws8.bat"
    click PS "https://github.com/trentpolack/calvinball/tree/develop/scripts/powershell/scripts/cmdlets/"
    click CommitCounter "https://github.com/trentpolack/calvinball/blob/develop/scripts/python/commit_counter/commit_counter.py"
    click MayaHelper "https://github.com/trentpolack/calvinball/blob/develop/scripts/python/maya/maya_center_selected_objects.py"
    click MegaAssembler "https://github.com/trentpolack/calvinball/blob/develop/scripts/python/megascan-assembler/megascan.py"
    click VFGen "https://github.com/trentpolack/calvinball/blob/develop/scripts/python/vector_field_generator/VFGenerator.py"
    click VFGUI "https://github.com/trentpolack/calvinball/blob/develop/scripts/python/vector_field_generator/VectorFieldTool_GUI.py"
    click VSext "https://github.com/trentpolack/calvinball/tree/develop/scripts/visualstudio/"
    click ShaderGraph "https://github.com/trentpolack/calvinball/blob/develop/unity/shaders/HDRPLit_OrenNayer.shadergraph"
    click UEContent "https://github.com/trentpolack/calvinball/tree/develop/unrealengine/ue4_unsupported/content/4.17/"
    click UEShaders "https://github.com/trentpolack/calvinball/blob/develop/unrealengine/ue4_unsupported/source/Engine/Shaders/PostProcessAnamorphicFlares.usf"
    click UERenderer "https://github.com/trentpolack/calvinball/blob/develop/unrealengine/ue4_unsupported/source/Engine/Source/Runtime/Renderer/Private/PostProcess/PostProcessAnamorphicFlares.cpp"
    click UEDebug "https://github.com/trentpolack/calvinball/blob/develop/unrealengine/ue4_unsupported/source/Source/Private/Core/GameDebugStatics.cpp"

    %% Styles
    classDef actor fill:#c2f0fc,stroke:#036,stroke-width:1px
    classDef repo fill:#f5f5f5,stroke:#333,stroke-width:1px
    classDef assets fill:#cfe2f3,stroke:#2a6592,stroke-width:1px
    classDef git fill:#d9d9d9,stroke:#666,stroke-width:1px
    classDef script fill:#d9ead3,stroke:#6aa84f,stroke-width:1px
    classDef engine fill:#fce5cd,stroke:#b45f06,stroke-width:1px
    classDef data fill:#fff2cc,stroke:#bf9000,stroke-width:1px
    classDef external fill:#eeeeee,stroke:#999999,stroke-width:1px,stroke-dasharray: 5 5
```
