# a-team-pjnceadc/minecraft-multi-loader architecture

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

- Interactive diagram: https://gitdiagram.com/a-team-pjnceadc/minecraft-multi-loader
- Repository: https://github.com/a-team-pjnceadc/minecraft-multi-loader

## Overview

MultiLoader is a Minecraft mod loader with an installer, game-artifact resolution, loader-format adapters, and a runtime for discovering mods, dispatching entrypoints, and transforming game classes. The principal runtime path is launch → bootstrap/discovery → mod and mixin setup → game class loading and transformation. README statements and SOURCE INDEX references support several subsystem links; unsampled implementation details are represented without asserted call edges.

Main entry points: [`loader-agent/src/main/java/dev/multiloader/agent/LoaderBootstrap.java`](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-agent/src/main/java/dev/multiloader/agent/LoaderBootstrap.java) (Loader bootstrap), [`loader-api/src/main/java/dev/multiloader/api/locating/IModFile.java`](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-api/src/main/java/dev/multiloader/api/locating/IModFile.java) (Mod file model), [`loader-mixin/src/main/java/dev/multiloader/mixin/MixinService.java`](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-mixin/src/main/java/dev/multiloader/mixin/MixinService.java) (Mixin runtime), [`loader-classloader/src/main/java/dev/multiloader/classloader/TransformingClassLoader.java`](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-classloader/src/main/java/dev/multiloader/classloader/TransformingClassLoader.java) (Transforming class loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Install and launch"]
  node_installer["Installer<br/>[ClientInstall.java]"]
  node_resolver["Game artifacts"]
  node_launcher["Launcher entry<br/>[Main.java]"]
end

subgraph group_mods["Mod loading"]
  node_discovery["Mod discovery<br/>[ModDiscoverer.java]"]
  node_modfiles["Mod file model<br/>[IModFile.java]"]
  node_dependency["Dependency resolution"]
end

subgraph group_runtime["Runtime transformation"]
  node_bootstrap["Loader bootstrap"]
  node_entrydispatch["Entrypoint dispatch"]
  node_query["Entrypoint query"]
  node_mixinconfigs["Mixin config collection"]
  node_mixinservice["Mixin runtime<br/>[MixinService.java]"]
  node_platform["Mixin platform service"]
  node_classloader["Transforming class loader"]
  node_classprocessors["Class processors"]
end

subgraph group_compat["Loader compatibility"]
  node_fabricreader["Fabric metadata reader"]
  node_fabricentry["Fabric entrypoints"]
  node_neoforgereader["NeoForge metadata reader"]
  node_neoforgeentry["NeoForge entrypoints"]
  node_bridge["Loader bridges<br/>[NetworkBridge.java]"]
end

node_user(("Operator"))

node_user -->|"installs game"| node_installer
node_installer -->|"resolves artifacts"| node_resolver
node_user -->|"starts game"| node_launcher
node_launcher -->|"starts loader"| node_bootstrap
node_bootstrap -.->|"discovers mods"| node_discovery
node_discovery -.->|"creates mod files"| node_modfiles
node_bootstrap -.->|"resolves dependencies"| node_dependency
node_fabricreader -->|"implements format"| node_modfiles
node_neoforgereader -.->|"implements format"| node_modfiles
node_bootstrap -->|"collects configs"| node_mixinconfigs
node_mixinconfigs -->|"reads declarations"| node_modfiles
node_bootstrap -.->|"dispatches entrypoints"| node_entrydispatch
node_query -->|"queries instances"| node_entrydispatch
node_bootstrap -.->|"sets up loading"| node_classloader
node_mixinservice -->|"uses game loader"| node_classloader
node_mixinservice -->|"initializes platform"| node_platform
node_mixinservice -.->|"provides transformer"| node_classprocessors
node_platform -->|"uses game loader"| node_classloader
node_fabricentry -.->|"adapts API"| node_bridge
node_neoforgeentry -.->|"adapts API"| node_bridge

click node_installer "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/installer/src/main/java/dev/multiloader/installer/ClientInstall.java"
click node_resolver "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/game-resolver/src/main/java/dev/multiloader/resolver/GameArtifactResolver.java"
click node_launcher "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-agent/src/main/java/dev/multiloader/launcher/Main.java"
click node_bootstrap "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-agent/src/main/java/dev/multiloader/agent/LoaderBootstrap.java"
click node_discovery "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-core/src/main/java/dev/multiloader/core/discovery/ModDiscoverer.java"
click node_modfiles "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-api/src/main/java/dev/multiloader/api/locating/IModFile.java"
click node_dependency "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-core/src/main/java/dev/multiloader/core/resolve/DependencyResolver.java"
click node_fabricreader "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/adapt-fabric/src/main/java/dev/multiloader/adapt/fabric/FabricModFileReader.java"
click node_fabricentry "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/adapt-fabric/src/main/java/dev/multiloader/adapt/fabric/FabricEntrypointProvider.java"
click node_neoforgereader "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/adapt-neoforge/src/main/java/dev/multiloader/adapt/neoforge/NeoForgeModFileReader.java"
click node_neoforgeentry "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/adapt-neoforge/src/main/java/dev/multiloader/adapt/neoforge/NeoForgeEntrypointProvider.java"
click node_bridge "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/bridge-api-common/src/main/java/dev/multiloader/bridge/network/NetworkBridge.java"
click node_entrydispatch "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-agent/src/main/java/dev/multiloader/agent/DispatchedEntrypoints.java"
click node_query "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-agent/src/main/java/dev/multiloader/agent/EntrypointQueryImpl.java"
click node_mixinconfigs "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-mixin/src/main/java/dev/multiloader/mixin/MixinConfigManager.java"
click node_mixinservice "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-mixin/src/main/java/dev/multiloader/mixin/MixinService.java"
click node_platform "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-mixin/src/main/java/dev/multiloader/mixin/platform/MultiLoaderMixinService.java"
click node_classloader "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-classloader/src/main/java/dev/multiloader/classloader/TransformingClassLoader.java"
click node_classprocessors "https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-classloader/src/main/java/dev/multiloader/classloader/ClassProcessorSet.java"

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_installer,node_resolver,node_launcher toneBlue
class node_discovery,node_modfiles,node_dependency toneAmber
class node_bootstrap,node_entrydispatch,node_query,node_mixinconfigs,node_mixinservice,node_platform,node_classloader,node_classprocessors toneMint
class node_fabricreader,node_fabricentry,node_neoforgereader,node_neoforgeentry,node_bridge toneRose
class node_user toneIndigo
```

## Components

### Install and launch

- [Installer](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/installer/src/main/java/dev/multiloader/installer/ClientInstall.java): `installer/src/main/java/dev/multiloader/installer/ClientInstall.java`
- [Game artifacts](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/game-resolver/src/main/java/dev/multiloader/resolver/GameArtifactResolver.java): `game-resolver/src/main/java/dev/multiloader/resolver/GameArtifactResolver.java`
- [Launcher entry](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-agent/src/main/java/dev/multiloader/launcher/Main.java): `loader-agent/src/main/java/dev/multiloader/launcher/Main.java`

### Mod loading

- [Mod discovery](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-core/src/main/java/dev/multiloader/core/discovery/ModDiscoverer.java): `loader-core/src/main/java/dev/multiloader/core/discovery/ModDiscoverer.java`
- [Mod file model](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-api/src/main/java/dev/multiloader/api/locating/IModFile.java): `loader-api/src/main/java/dev/multiloader/api/locating/IModFile.java`
- [Dependency resolution](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-core/src/main/java/dev/multiloader/core/resolve/DependencyResolver.java): `loader-core/src/main/java/dev/multiloader/core/resolve/DependencyResolver.java`

### Runtime transformation

- [Loader bootstrap](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-agent/src/main/java/dev/multiloader/agent/LoaderBootstrap.java): `loader-agent/src/main/java/dev/multiloader/agent/LoaderBootstrap.java`
- [Entrypoint dispatch](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-agent/src/main/java/dev/multiloader/agent/DispatchedEntrypoints.java): `loader-agent/src/main/java/dev/multiloader/agent/DispatchedEntrypoints.java`
- [Entrypoint query](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-agent/src/main/java/dev/multiloader/agent/EntrypointQueryImpl.java): `loader-agent/src/main/java/dev/multiloader/agent/EntrypointQueryImpl.java`
- [Mixin config collection](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-mixin/src/main/java/dev/multiloader/mixin/MixinConfigManager.java): `loader-mixin/src/main/java/dev/multiloader/mixin/MixinConfigManager.java`
- [Mixin runtime](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-mixin/src/main/java/dev/multiloader/mixin/MixinService.java): `loader-mixin/src/main/java/dev/multiloader/mixin/MixinService.java`
- [Mixin platform service](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-mixin/src/main/java/dev/multiloader/mixin/platform/MultiLoaderMixinService.java): `loader-mixin/src/main/java/dev/multiloader/mixin/platform/MultiLoaderMixinService.java`
- [Transforming class loader](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-classloader/src/main/java/dev/multiloader/classloader/TransformingClassLoader.java): `loader-classloader/src/main/java/dev/multiloader/classloader/TransformingClassLoader.java`
- [Class processors](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/loader-classloader/src/main/java/dev/multiloader/classloader/ClassProcessorSet.java): `loader-classloader/src/main/java/dev/multiloader/classloader/ClassProcessorSet.java`

### Loader compatibility

- [Fabric metadata reader](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/adapt-fabric/src/main/java/dev/multiloader/adapt/fabric/FabricModFileReader.java): `adapt-fabric/src/main/java/dev/multiloader/adapt/fabric/FabricModFileReader.java`
- [Fabric entrypoints](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/adapt-fabric/src/main/java/dev/multiloader/adapt/fabric/FabricEntrypointProvider.java): `adapt-fabric/src/main/java/dev/multiloader/adapt/fabric/FabricEntrypointProvider.java`
- [NeoForge metadata reader](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/adapt-neoforge/src/main/java/dev/multiloader/adapt/neoforge/NeoForgeModFileReader.java): `adapt-neoforge/src/main/java/dev/multiloader/adapt/neoforge/NeoForgeModFileReader.java`
- [NeoForge entrypoints](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/adapt-neoforge/src/main/java/dev/multiloader/adapt/neoforge/NeoForgeEntrypointProvider.java): `adapt-neoforge/src/main/java/dev/multiloader/adapt/neoforge/NeoForgeEntrypointProvider.java`
- [Loader bridges](https://github.com/a-team-pjnceadc/minecraft-multi-loader/blob/main/bridge-api-common/src/main/java/dev/multiloader/bridge/network/NetworkBridge.java): `bridge-api-common/src/main/java/dev/multiloader/bridge/network/NetworkBridge.java`

### Other components

- **Operator**

## Connections

- Operator → Installer: installs game
- Installer → Game artifacts: resolves artifacts (evidence: `installer/src/main/java/dev/multiloader/installer/ClientInstall.java`)
- Operator → Launcher entry: starts game
- Launcher entry → Loader bootstrap: starts loader (evidence: `loader-agent/src/main/java/dev/multiloader/launcher/Main.java`)
- Loader bootstrap → Mod discovery: discovers mods (evidence: `loader-agent/src/main/java/dev/multiloader/agent/LoaderBootstrap.java`)
- Mod discovery → Mod file model: creates mod files (evidence: `loader-core/src/main/java/dev/multiloader/core/discovery/ModDiscoverer.java`)
- Loader bootstrap → Dependency resolution: resolves dependencies (evidence: `loader-agent/src/main/java/dev/multiloader/agent/LoaderBootstrap.java`)
- Fabric metadata reader → Mod file model: implements format (evidence: `adapt-fabric/src/main/java/dev/multiloader/adapt/fabric/FabricModFileReader.java`)
- NeoForge metadata reader → Mod file model: implements format (evidence: `adapt-neoforge/src/main/java/dev/multiloader/adapt/neoforge/NeoForgeModFileReader.java`)
- Loader bootstrap → Mixin config collection: collects configs (evidence: `loader-agent/src/main/java/dev/multiloader/agent/LoaderBootstrap.java`)
- Mixin config collection → Mod file model: reads declarations (evidence: `loader-mixin/src/main/java/dev/multiloader/mixin/MixinConfigManager.java`)
- Loader bootstrap → Entrypoint dispatch: dispatches entrypoints (evidence: `loader-agent/src/main/java/dev/multiloader/agent/LoaderBootstrap.java`)
- Entrypoint query → Entrypoint dispatch: queries instances (evidence: `loader-agent/src/main/java/dev/multiloader/agent/EntrypointQueryImpl.java`)
- Loader bootstrap → Transforming class loader: sets up loading (evidence: `loader-agent/src/main/java/dev/multiloader/agent/LoaderBootstrap.java`)
- Mixin runtime → Transforming class loader: uses game loader (evidence: `loader-mixin/src/main/java/dev/multiloader/mixin/MixinService.java`)
- Mixin runtime → Mixin platform service: initializes platform (evidence: `loader-mixin/src/main/java/dev/multiloader/mixin/MixinService.java`)
- Mixin runtime → Class processors: provides transformer
- Mixin platform service → Transforming class loader: uses game loader (evidence: `loader-mixin/src/main/java/dev/multiloader/mixin/platform/MultiLoaderMixinService.java`)
- Fabric entrypoints → Loader bridges: adapts API
- NeoForge entrypoints → Loader bridges: adapts API
