# aniketrajnish/unity-collider-optimizer architecture

> Architecture diagram of the GitHub repository aniketrajnish/unity-collider-optimizer, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aniketrajnish/unity-collider-optimizer
- Repository: https://github.com/aniketrajnish/unity-collider-optimizer

## Overview

##### Project type and purpose
- This is a Unity Editor package/plugin (“Unity Collider Optimizer”) that adds context-menu and Tools-window commands to simplify 2D and 3D colliders. It lives entirely in the Unity Editor, uses Editor scripts (C#), ScriptableObject presets, and bundles native gltfpack binaries for mesh simplification.

##### File structure
- Top‐level:
- Assets/ColliderOptimizer – all plugin code and demo scenes
– Editor/1-core – core domain logic for Mesh & Polygon operations
– Editor/2-utils – helper libraries (RDP, ObjExporter, Math helpers)
– Editor/3-ui – UI layer (context menus, EditorWindow)
– Editor/4-gltfpack – native binaries + runner and bootstrapper code
– Assets/ColliderOptimizer/Assets – sample materials, sprites, meshes
– Assets/ColliderOptimizer/Scenes – example Unity scenes
- Packages – Unity package manifest, lockfile (declares dependency on GLTF importer)
- ProjectSettings/ColliderOptimizerSettings.asset – stores default params

##### Extract architecture insights from README
- Two main flows:
a. MeshCollider optimization (calls gltfpack external process + re-import)
b. PolygonCollider2D optimization (in-process RDP line simplification)
- Presets are either ScriptableObjects under “Assets → Create → ColliderOptimizer” or stored in ProjectSettings.
- Depends on a GLTF importer plugin (glTFast or UnityGLTF) for re-importing simplified meshes.

##### Detail
- Both Mesh and Polygon flows side by side
- Where presets live and how settings propagate
- Don’t forget the GLTF importer plugin dependency and its role in mesh re-import
- Sample Scenes as an “Examples” artifact, not part of the core runtime

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Unity Editor Host"
        direction TB

        subgraph "UI Layer"
            direction TB
            MeshUI1("Mesh Collider Context Menu"):::ui
            MeshUI2("Polygon Collider Context Menu"):::ui
            OptWin("Tools Window"):::ui
        end

        subgraph "Core Services"
            direction TB
            IOps["IColliderMenuOps"]:::core
            MeshCore["MeshColliderMenuOps"]:::core
            PolyCore["PolygonColliderMenuOps"]:::core
            Settings["OptSettings / OptProjectState"]:::core
            MeshPreset["MeshOptPreset / MeshOptParams"]:::core
            PolyPreset["PolyOptPreset / PolyOptParams"]:::core
        end

        subgraph "Utility Modules"
            direction TB
            MeshHelpers["MeshOptHelpers"]:::utils
            PolyHelpers["PolyOptHelpers"]:::utils
            RDPmod["RDP"]:::utils
            OBJexp["ObjExporter"]:::utils
            EditorHelpers["OptEditorHelpers"]:::utils
        end

        subgraph "Integration Layer"
            direction TB
            Bootstrap["GltfBootstrapper"]:::integration
            Runner["GltfpackRunner"]:::integration
            Gateway["MeshSimplifyGateway"]:::integration
            Binaries["gltfpack Binaries"]:::integration
        end

    end

    subgraph "Data Storage"
        direction TB
        PresetsSO("ScriptableObject Presets"):::data
        SettingsAsset("ColliderOptimizerSettings.asset"):::data
    end

    subgraph "Examples"
        direction TB
        Samples("Sample Materials, Sprites & Meshes"):::data
        Scenes("Demo Scenes"):::data
    end

    subgraph "External Dependencies"
        direction TB
        GLTFimp("glTF Importer Package"):::external
        ExtProc("gltfpack External Process"):::external
    end

    %% User interaction
    User["User (EditorApplication)"]:::external
    User -->|right-click / Tools| MeshUI1
    User -->|right-click / Tools| MeshUI2
    User -->|open window| OptWin

    %% UI to Core
    MeshUI1 -->|"OptimizeCollider()"| MeshCore
    MeshUI2 -->|"OptimizeCollider()"| PolyCore
    OptWin -->|"OptimizeCollider() w/ Preset"| MeshCore
    OptWin -->|"OptimizeCollider() w/ Preset"| PolyCore

    %% Core to Interfaces
    MeshCore -->|implements| IOps
    PolyCore -->|implements| IOps

    %% Core to Data Storage
    MeshCore -->|"load/save Settings"| Settings
    PolyCore -->|"load/save Settings"| Settings
    MeshCore -->|"use Preset"| MeshPreset
    PolyCore -->|"use Preset"| PolyPreset

    %% Mesh Flow
    MeshCore -->|"prepare mesh"| MeshHelpers
    MeshHelpers -->|"export OBJ"| OBJexp
    OBJexp -->|"pass to Runner"| Runner
    Runner -->|"RunGltfpack()"| ExtProc
    ExtProc -->|"simplified .glb"| Runner
    Runner -->|"import via GLTF importer"| GLTFimp
    GLTFimp -->|"new mesh asset"| Gateway
    Gateway -->|"apply to collider"| MeshCore

    %% Polygon Flow
    PolyCore -->|"get path data"| RDPmod
    RDPmod -->|"SimplifyPaths()"| PolyHelpers
    PolyHelpers -->|"rebuild collider"| PolyCore

    %% Integration dependencies
    Bootstrap --> Runner
    Gateway --> Runner
    Runner --> Binaries

    %% Core to Storage
    MeshCore --> PresetsSO
    PolyCore --> PresetsSO
    Settings --> SettingsAsset

    %% Examples not in flow
    Samples
    Scenes

    %% Click Events
    click MeshUI1 "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/3-ui/MeshColliderOptContextMenu.cs"
    click MeshUI2 "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/3-ui/PolygonColliderOptContextMenu.cs"
    click OptWin "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/3-ui/OptWindow.cs"
    click MeshCore "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/1-core/1-mesh/MeshColliderMenuOps.cs"
    click PolyCore "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/1-core/2-poly/PolygonColliderMenuOps.cs"
    click IOps "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/1-core/IColliderMenuOps.cs"
    click Settings "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/1-core/OptSettings.cs"
    click Settings "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/1-core/OptProjectState.cs"
    click MeshPreset "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/1-core/1-mesh/MeshOptPreset.cs"
    click PolyPreset "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/1-core/2-poly/PolyOptPreset.cs"
    click OBJexp "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/2-utils/ObjExporter.cs"
    click MeshHelpers "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/2-utils/MeshOptHelpers.cs"
    click PolyHelpers "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/2-utils/PolyOptHelpers.cs"
    click RDPmod "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/2-utils/RDP.cs"
    click Bootstrap "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/4-gltfpack/GltfBootstrapper.cs"
    click Runner "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/4-gltfpack/GltfpackRunner.cs"
    click Gateway "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Assets/ColliderOptimizer/Editor/4-gltfpack/MeshSimplifyGateway.cs"
    click Binaries "https://github.com/aniketrajnish/unity-collider-optimizer/tree/main/Assets/ColliderOptimizer/Editor/4-gltfpack/1-bin"
    click Samples "https://github.com/aniketrajnish/unity-collider-optimizer/tree/main/Assets/ColliderOptimizer/Assets"
    click Scenes "https://github.com/aniketrajnish/unity-collider-optimizer/tree/main/Assets/ColliderOptimizer/Scenes"
    click SettingsAsset "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/ProjectSettings/ColliderOptimizerSettings.asset"
    click GLTFimp "https://github.com/aniketrajnish/unity-collider-optimizer/blob/main/Packages/manifest.json"

    %% Styles
    classDef ui fill:#ADD8E6,stroke:#000
    classDef core fill:#90EE90,stroke:#000
    classDef utils fill:#98FB98,stroke:#000
    classDef integration fill:#FFA500,stroke:#000
    classDef data fill:#FFFFE0,stroke:#000
    classDef external fill:#D3D3D3,stroke:#000
```
