# vrc-staples/avatarsettingsmanager-lite architecture

> Architecture diagram of the GitHub repository vrc-staples/avatarsettingsmanager-lite, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vrc-staples/avatarsettingsmanager-lite
- Repository: https://github.com/vrc-staples/avatarsettingsmanager-lite

## Overview

ASM-Lite is a Unity editor tool and avatar prefab for configuring and building in-game expression-parameter presets. The principal workflow is editor configuration, parameter discovery and generated FX/parameter/menu assets, then VRCFury FullController delivery for avatar builds. Editor lifecycle operations also support rebuild, detach, vendorize, return-to-package-managed, and removal. The README documents these capabilities; excerpts and the source index support the core build and wiring links, while some lifecycle internals are only partially sampled.

Main entry points: [`Packages/com.staples.asm-lite/Editor/ASMLiteLifecycleTransactionService.cs`](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteLifecycleTransactionService.cs) (Lifecycle transactions), [`Packages/com.staples.asm-lite/Editor/ASMLiteBuilder.cs`](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteBuilder.cs) (Parameter and asset builder), [`Packages/com.staples.asm-lite/Editor/ASMLiteFullControllerWiring.cs`](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteFullControllerWiring.cs) (FullController wiring), [`Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs`](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs) (Settings window)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_configuration["Editor configuration"]
  node_window["Settings window<br/>[ASMLiteWindow.cs]"]
  node_component["Prefab settings"]
  node_parameter_options["Backup exclusions"]
end

subgraph group_build["Build and menu generation"]
  node_build_entry["Build callback"]
  node_builder["Parameter and asset builder<br/>[ASMLiteBuilder.cs]"]
  node_generated_assets["Generated payload"]
  node_diagnostics["Build diagnostics"]
end

subgraph group_delivery["Avatar delivery"]
  node_full_controller["FullController wiring"]
  node_install_path["Menu install path"]
end

subgraph group_lifecycle["Asset lifecycle"]
  node_lifecycle_ui["Management actions<br/>[ASMLiteWindow.cs]"]
  node_transactions["Lifecycle transactions"]
  node_ownership["Ownership policy"]
  node_mirror["Vendorized asset mirror"]
  node_installation_state["Installation state"]
  node_migration["Migration continuity"]
end

node_editor_user(("Avatar creator"))
node_avatar(("VRChat avatar"))
node_actions["In-game preset actions"]

node_editor_user -->|"configures"| node_window
node_window -->|"saves settings"| node_component
node_window -->|"resolves exclusions"| node_parameter_options
node_component -->|"invokes build"| node_build_entry
node_build_entry -->|"calls build"| node_builder
node_builder -->|"generates payload"| node_generated_assets
node_builder -->|"reports failures"| node_diagnostics
node_builder -->|"refreshes wiring"| node_full_controller
node_full_controller -->|"references payload"| node_generated_assets
node_component -->|"sets prefix"| node_install_path
node_full_controller -->|"wires assets"| node_avatar
node_avatar -->|"exposes menu"| node_actions
node_editor_user -->|"manages prefab"| node_lifecycle_ui
node_lifecycle_ui -->|"runs operations"| node_transactions
node_transactions -->|"stages vendor copy"| node_mirror
node_transactions -->|"checks state"| node_installation_state
node_transactions -->|"preserves continuity"| node_migration
node_mirror -->|"follows policy"| node_ownership
node_transactions -->|"retargets references"| node_full_controller

click node_window "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs"
click node_component "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/ASMLiteComponent.cs"
click node_parameter_options "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteParameterBackupPresetResolver.cs"
click node_build_entry "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/ASMLiteComponent.cs"
click node_builder "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteBuilder.cs"
click node_generated_assets "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteAssetPaths.cs"
click node_diagnostics "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteBuildDiagnosticResult.cs"
click node_full_controller "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteFullControllerWiring.cs"
click node_install_path "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteFullControllerInstallPathHelper.cs"
click node_lifecycle_ui "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs"
click node_transactions "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteLifecycleTransactionService.cs"
click node_ownership "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteGeneratedOwnershipPolicy.cs"
click node_mirror "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteGeneratedAssetMirrorService.cs"
click node_installation_state "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteInstallationState.cs"
click node_migration "https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteMigrationContinuityService.cs"

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_window,node_component,node_parameter_options toneBlue
class node_build_entry,node_builder,node_generated_assets,node_diagnostics toneAmber
class node_full_controller,node_install_path toneMint
class node_lifecycle_ui,node_transactions,node_ownership,node_mirror,node_installation_state,node_migration toneRose
class node_editor_user,node_avatar,node_actions toneIndigo
```

## Components

### Editor configuration

- [Settings window](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs`
- [Prefab settings](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/ASMLiteComponent.cs): `Packages/com.staples.asm-lite/ASMLiteComponent.cs`
- [Backup exclusions](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteParameterBackupPresetResolver.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteParameterBackupPresetResolver.cs`

### Build and menu generation

- [Build callback](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/ASMLiteComponent.cs): `Packages/com.staples.asm-lite/ASMLiteComponent.cs`
- [Parameter and asset builder](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteBuilder.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteBuilder.cs`
- [Generated payload](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteAssetPaths.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteAssetPaths.cs`
- [Build diagnostics](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteBuildDiagnosticResult.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteBuildDiagnosticResult.cs`

### Avatar delivery

- [FullController wiring](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteFullControllerWiring.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteFullControllerWiring.cs`
- [Menu install path](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteFullControllerInstallPathHelper.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteFullControllerInstallPathHelper.cs`

### Asset lifecycle

- [Management actions](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs`
- [Lifecycle transactions](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteLifecycleTransactionService.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteLifecycleTransactionService.cs`
- [Ownership policy](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteGeneratedOwnershipPolicy.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteGeneratedOwnershipPolicy.cs`
- [Vendorized asset mirror](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteGeneratedAssetMirrorService.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteGeneratedAssetMirrorService.cs`
- [Installation state](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteInstallationState.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteInstallationState.cs`
- [Migration continuity](https://github.com/vrc-staples/avatarsettingsmanager-lite/blob/main/Packages/com.staples.asm-lite/Editor/ASMLiteMigrationContinuityService.cs): `Packages/com.staples.asm-lite/Editor/ASMLiteMigrationContinuityService.cs`

### Other components

- **Avatar creator**
- **VRChat avatar**
- **In-game preset actions**

## Connections

- Avatar creator → Settings window: configures (evidence: `README.md`)
- Settings window → Prefab settings: saves settings (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs`)
- Settings window → Backup exclusions: resolves exclusions (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs`)
- Prefab settings → Build callback: invokes build (evidence: `Packages/com.staples.asm-lite/ASMLiteComponent.cs`)
- Build callback → Parameter and asset builder: calls build (evidence: `Packages/com.staples.asm-lite/ASMLiteComponent.cs`)
- Parameter and asset builder → Generated payload: generates payload (evidence: `README.md`)
- Parameter and asset builder → Build diagnostics: reports failures (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteBuilder.cs`)
- Parameter and asset builder → FullController wiring: refreshes wiring (evidence: `README.md`)
- FullController wiring → Generated payload: references payload (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteFullControllerWiring.cs`)
- Prefab settings → Menu install path: sets prefix (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteFullControllerInstallPathHelper.cs`)
- FullController wiring → VRChat avatar: wires assets (evidence: `README.md`)
- VRChat avatar → In-game preset actions: exposes menu (evidence: `README.md`)
- Avatar creator → Management actions: manages prefab (evidence: `README.md`)
- Management actions → Lifecycle transactions: runs operations (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteWindow.cs`)
- Lifecycle transactions → Vendorized asset mirror: stages vendor copy (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteLifecycleTransactionService.cs`)
- Lifecycle transactions → Installation state: checks state (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteLifecycleTransactionService.cs`)
- Lifecycle transactions → Migration continuity: preserves continuity (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteLifecycleTransactionService.cs`)
- Vendorized asset mirror → Ownership policy: follows policy (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteGeneratedAssetMirrorService.cs`)
- Lifecycle transactions → FullController wiring: retargets references (evidence: `Packages/com.staples.asm-lite/Editor/ASMLiteLifecycleTransactionService.cs`)
