# fabricmc/fabric-loader architecture

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

- Interactive diagram: https://gitdiagram.com/fabricmc/fabric-loader
- Repository: https://github.com/fabricmc/fabric-loader

## Overview

##### Main Components

a) Core Loader Components:
- Mod Loading System
- Launch System
- Discovery System
- Metadata Management
- Entrypoint System

b) Integration Components:
- Minecraft Game Interface
- JUnit Testing Framework
- Mixin System Integration

##### Key Architectural Elements

Top Layer:
- API Interface (`net.fabricmc.loader.api`)
- Public Interfaces for Mod Developers

Middle Layer:
- Implementation Components
- Mod Discovery
- Metadata Processing
- Version Management
- Dependency Resolution

Bottom Layer:
- Launch System
- Knot Launcher
- Class Loading
- Game Provider

##### Component Relationships

**Mod Loading Pipeline:**
**Discovery -> Metadata Parsing -> Resolution -> Loading -> Initialization**

**Launch System Flow:**
**Game Provider -> Launcher -> Class Loading -> Mixin Bootstrap -> Game Start**

##### Detailed Component Breakdown

**┌─ API Layer ─────────────────┐**
- FabricLoader             │
- ModContainer             │
- EntrypointContainer      │
- ┘

**┌─ Implementation Layer ──────┐**
- ModDiscoverer            │
- ModResolver              │
- MetadataParser          │
- TransformerSystem       │
- ┘

**┌─ Launch Layer ─────────────┐**
- KnotClassLoader         │
- GameProvider            │
- MixinBootstrap         │
- ┘

##### Important Flows to Highlight

Key processes:
- Mod Discovery Process
- Class Loading Chain
- Transformation Pipeline
- Entrypoint Initialization

##### Integration Points

External system connections:
- Minecraft Game Integration
- Mixin System Interface
- JUnit Testing Framework

##### Technical Details

Important technical aspects:
- Java Version Support (Java 8+)
- Minecraft Version Compatibility
- Class Loading Hierarchy
- Transformation Pipeline Stages

This system design should help developers understand both the high-level architecture and the detailed interactions between components, while highlighting the modular nature of the Fabric Loader system.

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph API["API Layer"]
        FabricAPI["FabricLoader API"]:::api
        EntrypointAPI["Entrypoint API"]:::api
        ModContainerAPI["ModContainer API"]:::api
    end

    subgraph Implementation["Implementation Layer"]
        FabricImpl["FabricLoader Implementation"]:::impl
        Discovery["Mod Discovery"]:::impl
        Metadata["Metadata Management"]:::impl
        Resolution["Dependency Resolution"]:::impl
        VersionMgmt["Version Management"]:::impl
        Transform["Transformation System"]:::impl
    end

    subgraph Launch["Launch System"]
        KnotLauncher["Knot Launcher"]:::launch
        ClassLoader["Class Loading"]:::launch
        MixinBoot["Mixin Bootstrap"]:::launch
        GameProv["Game Provider"]:::launch
        ServerLaunch["Server Launch"]:::launch
    end

    subgraph Integration["Integration Layer"]
        MinecraftInt["Minecraft Integration"]:::integration
        MixinSystem["Mixin System"]:::integration
        JUnitTest["JUnit Testing"]:::integration
        LogSystem["Logging System"]:::integration
    end

    %% Connections
    FabricAPI --> FabricImpl
    EntrypointAPI --> FabricImpl
    ModContainerAPI --> FabricImpl

    FabricImpl --> Discovery
    Discovery --> Metadata
    Metadata --> Resolution
    Resolution --> Transform

    FabricImpl --> KnotLauncher
    KnotLauncher --> ClassLoader
    ClassLoader --> MixinBoot
    MixinBoot --> GameProv
    GameProv --> MinecraftInt
    KnotLauncher --> ServerLaunch

    Transform --> MixinSystem
    FabricImpl --> LogSystem
    FabricImpl --> JUnitTest

    %% Styles
    classDef api fill:#2196F3,stroke:#1565C0,color:white
    classDef impl fill:#4CAF50,stroke:#2E7D32,color:white
    classDef launch fill:#FFC107,stroke:#FFA000,color:black
    classDef integration fill:#9C27B0,stroke:#7B1FA2,color:white

    %% Click Events
    click FabricAPI "https://github.com/fabricmc/fabric-loader/tree/master/src/main/java/net/fabricmc/loader/api/"
    click EntrypointAPI "https://github.com/fabricmc/fabric-loader/tree/master/src/main/java/net/fabricmc/loader/api/entrypoint/"
    click FabricImpl "https://github.com/fabricmc/fabric-loader/blob/master/src/main/java/net/fabricmc/loader/impl/FabricLoaderImpl.java"
    click Discovery "https://github.com/fabricmc/fabric-loader/tree/master/src/main/java/net/fabricmc/loader/impl/discovery/"
    click Metadata "https://github.com/fabricmc/fabric-loader/tree/master/src/main/java/net/fabricmc/loader/impl/metadata/"
    click KnotLauncher "https://github.com/fabricmc/fabric-loader/tree/master/src/main/java/net/fabricmc/loader/impl/launch/knot/"
    click ServerLaunch "https://github.com/fabricmc/fabric-loader/tree/master/src/main/java/net/fabricmc/loader/impl/launch/server/"
    click MixinBoot "https://github.com/fabricmc/fabric-loader/blob/master/src/main/java/net/fabricmc/loader/impl/launch/FabricMixinBootstrap.java"
    click GameProv "https://github.com/fabricmc/fabric-loader/tree/master/minecraft/src/main/java/net/fabricmc/loader/impl/game/minecraft/"
    click Transform "https://github.com/fabricmc/fabric-loader/tree/master/src/main/java/net/fabricmc/loader/impl/transformer/"
    click VersionMgmt "https://github.com/fabricmc/fabric-loader/tree/master/src/main/java/net/fabricmc/loader/impl/util/version/"
    click LogSystem "https://github.com/fabricmc/fabric-loader/tree/master/src/main/java/net/fabricmc/loader/impl/util/log/"
    click JUnitTest "https://github.com/fabricmc/fabric-loader/tree/master/junit/src/main/java/net/fabricmc/loader/impl/junit/"
    click MixinSystem "https://github.com/fabricmc/fabric-loader/blob/master/src/main/java/net/fabricmc/loader/impl/launch/knot/MixinServiceKnot.java"
```
