# isilab-utalca/levelbuildingsidekick architecture

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

- Interactive diagram: https://gitdiagram.com/isilab-utalca/levelbuildingsidekick
- Repository: https://github.com/isilab-utalca/levelbuildingsidekick

## Overview

The README presents Level Building Sidekick as a Unity level-authoring extension: designers compose levels from assets, configure elements and assistants, organize layers and quests, then convert levels into Unity structures. However, the supplied tree contains no corresponding LBS editor or generation modules—only command-buffer wrappers and a bundled Asset Store Tools package. The graph therefore preserves the documented LBS workflow separately from the evidenced Asset Store Tools capabilities. Source excerpts and the index support only selected internal links; unsampled integrations are not inferred.

Main entry points: [`LevelBuildingSidekick/IBaseCommandBuffer.cs`](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/IBaseCommandBuffer.cs) (Base command buffer), [`LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/AssetStoreTools.cs`](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/AssetStoreTools.cs) (Asset Store menu), [`LevelBuildingSidekick`](https://github.com/isilab-utalca/levelbuildingsidekick/tree/main/LevelBuildingSidekick) (Level authoring), [`LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/UI/PreviewGeneratorWindow.cs`](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/UI/PreviewGeneratorWindow.cs) (Preview generator UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_lbs["Level Building Sidekick"]
  node_level["Level authoring"]
  node_layers["Layers and quests"]
  node_unity["Unity structures"]
end

subgraph group_render["Command Buffers"]
  node_base["Base command buffer"]
  node_compute["Compute commands"]
  node_raster["Raster commands"]
  node_unsafe["Unsafe commands"]
end

subgraph group_ui["Asset Store Tools UI"]
  node_tools["Asset Store menu<br/>[AssetStoreTools.cs]"]
  node_uploader["Package uploader<br/>[UploaderWindow.cs]"]
  node_validator["Package validator"]
  node_previewui["Preview generator UI"]
end

subgraph group_content["Preview Generation"]
  node_exporter["Package export"]
  node_injector["Preview injection<br/>[PreviewInjector.cs]"]
  node_generators["Preview generators<br/>[Generators]"]
  node_previewdata[("Preview database<br/>[PreviewDatabase.cs]")]
end

subgraph group_services["Asset Store Services"]
  node_auth["Authentication"]
  node_client["HTTP client"]
  node_serviceprovider["Service registry<br/>[ServiceProvider.cs]"]
end

node_designer(("Level designer"))
node_assetstore(("Asset Store"))

node_designer -.->|"authors"| node_level
node_level -.->|"organizes"| node_layers
node_level -.->|"converts"| node_unity
node_base -->|"extends"| node_compute
node_base -->|"extends"| node_raster
node_base -->|"extends"| node_unsafe
node_tools -->|"opens"| node_uploader
node_tools -->|"opens"| node_validator
node_tools -->|"opens"| node_previewui
node_uploader -->|"uses"| node_auth
node_auth -.->|"sends requests"| node_client
node_client -.->|"HTTP requests"| node_assetstore
node_previewui -.->|"generates"| node_generators
node_previewui -->|"loads settings"| node_previewdata
node_exporter -.->|"injects previews"| node_injector
node_injector -->|"reads metadata"| node_previewdata
node_serviceprovider -.->|"registers services"| node_uploader

click node_level "https://github.com/isilab-utalca/levelbuildingsidekick/tree/main/LevelBuildingSidekick"
click node_layers "https://github.com/isilab-utalca/levelbuildingsidekick/tree/main/LevelBuildingSidekick"
click node_unity "https://github.com/isilab-utalca/levelbuildingsidekick/tree/main/LevelBuildingSidekick"
click node_base "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/IBaseCommandBuffer.cs"
click node_compute "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/ComputeCommandBuffer.cs"
click node_raster "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/RasterCommandBuffer.cs"
click node_unsafe "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/UnsafeCommandBuffer.cs"
click node_tools "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/AssetStoreTools.cs"
click node_uploader "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Uploader/UploaderWindow.cs"
click node_validator "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Validator/Scripts/CurrentProjectValidator.cs"
click node_previewui "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/UI/PreviewGeneratorWindow.cs"
click node_exporter "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Exporter/DefaultPackageExporter.cs"
click node_injector "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Exporter/PreviewInjector.cs"
click node_generators "https://github.com/isilab-utalca/levelbuildingsidekick/tree/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/Generators"
click node_previewdata "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/Data/PreviewDatabase.cs"
click node_auth "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Api/Abstractions/AuthenticationBase.cs"
click node_client "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Api/AssetStoreClient.cs"
click node_serviceprovider "https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Utility/ServiceProvider.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_level,node_layers,node_unity toneBlue
class node_base,node_compute,node_raster,node_unsafe toneAmber
class node_tools,node_uploader,node_validator,node_previewui toneMint
class node_exporter,node_injector,node_generators,node_previewdata toneRose
class node_auth,node_client,node_serviceprovider,node_designer,node_assetstore toneIndigo
```

## Components

### Level Building Sidekick

- [Level authoring](https://github.com/isilab-utalca/levelbuildingsidekick/tree/main/LevelBuildingSidekick): `LevelBuildingSidekick`
- [Layers and quests](https://github.com/isilab-utalca/levelbuildingsidekick/tree/main/LevelBuildingSidekick): `LevelBuildingSidekick`
- [Unity structures](https://github.com/isilab-utalca/levelbuildingsidekick/tree/main/LevelBuildingSidekick): `LevelBuildingSidekick`

### Command Buffers

- [Base command buffer](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/IBaseCommandBuffer.cs): `LevelBuildingSidekick/IBaseCommandBuffer.cs`
- [Compute commands](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/ComputeCommandBuffer.cs): `LevelBuildingSidekick/ComputeCommandBuffer.cs`
- [Raster commands](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/RasterCommandBuffer.cs): `LevelBuildingSidekick/RasterCommandBuffer.cs`
- [Unsafe commands](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/UnsafeCommandBuffer.cs): `LevelBuildingSidekick/UnsafeCommandBuffer.cs`

### Asset Store Tools UI

- [Asset Store menu](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/AssetStoreTools.cs): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/AssetStoreTools.cs`
- [Package uploader](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Uploader/UploaderWindow.cs): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Uploader/UploaderWindow.cs`
- [Package validator](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Validator/Scripts/CurrentProjectValidator.cs): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Validator/Scripts/CurrentProjectValidator.cs`
- [Preview generator UI](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/UI/PreviewGeneratorWindow.cs): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/UI/PreviewGeneratorWindow.cs`

### Preview Generation

- [Package export](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Exporter/DefaultPackageExporter.cs): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Exporter/DefaultPackageExporter.cs`
- [Preview injection](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Exporter/PreviewInjector.cs): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Exporter/PreviewInjector.cs`
- [Preview generators](https://github.com/isilab-utalca/levelbuildingsidekick/tree/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/Generators): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/Generators`
- [Preview database](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/Data/PreviewDatabase.cs): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Previews/Scripts/Data/PreviewDatabase.cs`

### Asset Store Services

- [Authentication](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Api/Abstractions/AuthenticationBase.cs): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Api/Abstractions/AuthenticationBase.cs`
- [HTTP client](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Api/AssetStoreClient.cs): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Api/AssetStoreClient.cs`
- [Service registry](https://github.com/isilab-utalca/levelbuildingsidekick/blob/main/LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Utility/ServiceProvider.cs): `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Utility/ServiceProvider.cs`

### Other components

- **Level designer**
- **Asset Store**

## Connections

- Level designer → Level authoring: authors
- Level authoring → Layers and quests: organizes
- Level authoring → Unity structures: converts
- Base command buffer → Compute commands: extends
- Base command buffer → Raster commands: extends
- Base command buffer → Unsafe commands: extends
- Asset Store menu → Package uploader: opens (evidence: `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/AssetStoreTools.cs`)
- Asset Store menu → Package validator: opens (evidence: `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/AssetStoreTools.cs`)
- Asset Store menu → Preview generator UI: opens (evidence: `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/AssetStoreTools.cs`)
- Package uploader → Authentication: uses (evidence: `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Uploader/UploaderWindow.cs`)
- Authentication → HTTP client: sends requests
- HTTP client → Asset Store: HTTP requests
- Preview generator UI → Preview generators: generates
- Preview generator UI → Preview database: loads settings
- Package export → Preview injection: injects previews (evidence: `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Exporter/DefaultPackageExporter.cs`)
- Preview injection → Preview database: reads metadata (evidence: `LevelBuildingSidekick/Packages/com.unity.asset-store-tools/Editor/Exporter/PreviewInjector.cs`)
- Service registry → Package uploader: registers services
