# ashyboxy/advl architecture

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

- Interactive diagram: https://gitdiagram.com/ashyboxy/advl
- Repository: https://github.com/ashyboxy/advl

## Overview

##### Main Components

a) Core ClassLoader System
- Various custom ClassLoaders:
- AccessibleClassLoader
- FunClassLoader
- IsolatedClassLoader
- LaxClassLoader
- ResourceClassLoader
- TransformingClassLoader

b) ASM Transformation Layer
- This as a supporting layer
- Adapters:
- ClassNodeAdapter
- ImplementerAdapter
- MethodCopierAdapter
- MethodRemoverAdapter
- StringMethodReplacerAdapter
- MultiAdapter

c) Mixin Integration System
- As a parallel system
- Include:
- AdvlMixinService
- AdvlMixinBootstrapService
- AdvlGlobalPropertyService

d) Transformer Framework
- As a processing layer
- Include:
- ClassTransformer
- TransformerProvider
- StringReplacerTransformerProvider
- TransformTransformerProvider

##### Relationship Flows

- ClassLoaders → ASM Transformation Layer (for bytecode manipulation)
- ClassLoaders → Mixin Integration System (for mixin processing)
- Transformer Framework → ASM Transformation Layer (for applying transformations)
- Bootstrap → ClassLoaders (initialization flow)

##### Architectural Patterns to Highlight

- Provider Pattern (used in transformer system)
- Adapter Pattern (in ASM transformation layer)
- Service Loader Pattern (shown in META-INF/services)

##### Implementation Details

- Java ASM usage for bytecode manipulation
- Mixin framework integration
- Custom class loading mechanisms
- Resource handling capabilities

##### Notes Section

Notes about:
- Class isolation mechanisms
- Transformation pipeline
- Mixin processing order
- Resource loading strategy

Remember to use standardized UML notation where appropriate, but feel free to deviate when needed to better represent the unique aspects of this class loading and transformation system.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Styles
    classDef core fill:#b3d9ff,stroke:#333
    classDef asm fill:#90EE90,stroke:#333
    classDef mixin fill:#FFB366,stroke:#333
    classDef transformer fill:#DDA0DD,stroke:#333
    classDef test fill:#D3D3D3,stroke:#333
    classDef minecraft fill:#98FB98,stroke:#333

    %% Core ClassLoader System
    subgraph CoreSystem["Core ClassLoader System"]
        ACL["AccessibleClassLoader"]
        FCL["FunClassLoader"]
        ICL["IsolatedClassLoader"]
        LCL["LaxClassLoader"]
        RCL["ResourceClassLoader"]
        TCL["TransformingClassLoader"]
    end

    %% ASM Transformation Layer
    subgraph ASMLayer["ASM Transformation Layer"]
        CNA["ClassNodeAdapter"]
        IMA["ImplementerAdapter"]
        MCA["MethodCopierAdapter"]
        MRA["MethodRemoverAdapter"]
        SMRA["StringMethodReplacerAdapter"]
        MA["MultiAdapter"]
    end

    %% Mixin Integration System
    subgraph MixinSystem["Mixin Integration System"]
        AMS["AdvlMixinService"]
        AMBS["AdvlMixinBootstrapService"]
        AGPS["AdvlGlobalPropertyService"]
    end

    %% Transformer Framework
    subgraph TransformerSystem["Transformer Framework"]
        CT["ClassTransformer"]
        TP["TransformerProvider"]
        SRTP["StringReplacerTransformerProvider"]
        TTP["TransformTransformerProvider"]
    end

    %% Test Infrastructure
    subgraph TestSystem["Test Infrastructure"]
        PTJ["Primary Test Jar"]
        STJ["Secondary Test Jar"]
        TMX["Test Mixins"]
    end

    %% Minecraft Integration
    subgraph MCSystem["Minecraft Integration"]
        BS["Bootstrap"]
        MCT["MC Transformers"]
        MCM["MC Mixins"]
    end

    %% Relationships
    CoreSystem --> ASMLayer
    CoreSystem --> MixinSystem
    TransformerSystem --> ASMLayer
    BS --> CoreSystem
    MixinSystem --> TransformerSystem
    TestSystem --> CoreSystem
    MCSystem --> CoreSystem

    %% Click Events
    click ACL "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/AccessibleClassLoader.java"
    click FCL "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/FunClassLoader.java"
    click ICL "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/IsolatedClassLoader.java"
    click LCL "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/LaxClassLoader.java"
    click RCL "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/ResourceClassLoader.java"
    click TCL "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/TransformingClassLoader.java"
    
    click CNA "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/adapters/ClassNodeAdapter.java"
    click IMA "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/adapters/ImplementerAdapter.java"
    click MCA "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/adapters/MethodCopierAdapter.java"
    click MRA "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/adapters/MethodRemoverAdapter.java"
    click SMRA "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/adapters/StringMethodReplacerAdapter.java"
    click MA "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/adapters/MultiAdapter.java"
    
    click AMS "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/mixin/AdvlMixinService.java"
    click AMBS "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/mixin/AdvlMixinBootstrapService.java"
    click AGPS "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/mixin/AdvlGlobalPropertyService.java"
    
    click CT "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/transformers/ClassTransformer.java"
    click TP "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/transformers/TransformerProvider.java"
    click SRTP "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/transformers/StringReplacerTransformerProvider.java"
    click TTP "https://github.com/AshyBoxy/advl/blob/master/src/main/java/xyz/ashyboxy/advl/loader/transformers/TransformTransformerProvider.java"
    
    click PTJ "https://github.com/AshyBoxy/advl/tree/master/testjars/primary/"
    click STJ "https://github.com/AshyBoxy/advl/tree/master/testjars/secondary/"
    click TMX "https://github.com/AshyBoxy/advl/tree/master/testjars/primary/java/xyz/ashyboxy/advl/ext/primary/mixin/"
    
    click BS "https://github.com/AshyBoxy/advl/blob/master/mc/src/main/java/xyz/ashyboxy/advl/loader/mc/Bootstrap.java"
    click MCT "https://github.com/AshyBoxy/advl/tree/master/mc/src/main/java/xyz/ashyboxy/advl/loader/mc/transformers/"
    click MCM "https://github.com/AshyBoxy/advl/tree/master/mc/src/main/java/xyz/ashyboxy/advl/mc/mixin/"

    %% Style Applications
    class ACL,FCL,ICL,LCL,RCL,TCL core
    class CNA,IMA,MCA,MRA,SMRA,MA asm
    class AMS,AMBS,AGPS mixin
    class CT,TP,SRTP,TTP transformer
    class PTJ,STJ,TMX test
    class BS,MCT,MCM minecraft
```
