# ray-t-r/minecraft-forbric-mod-loader architecture

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

- Interactive diagram: https://gitdiagram.com/ray-t-r/minecraft-forbric-mod-loader
- Repository: https://github.com/ray-t-r/minecraft-forbric-mod-loader

## Overview

Forbric is a unified Minecraft mod loader: it discovers Fabric, Forge, and NeoForge mods and runs them together in one instance, with compatibility glue across their APIs. The README also documents a separate installer that downloads/builds the required game artifacts and installs a launcher version. The graph preserves those documented stages and capabilities; several kernel subsystems are represented at the module level because their implementations were not excerpted.

Main entry points: [`forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/Installer.java`](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/Installer.java) (Install orchestration), [`forbric-kernel/src/main/java/net/forbric/kernel/boot/Main.java`](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/boot/Main.java) (Kernel boot), [`forbric-kernel/src/main/java/net/forbric/kernel/fabric/KernelFabricLoader.java`](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/fabric/KernelFabricLoader.java) (Fabric-compatible loader), [`forbric-kernel/src/main/java/net/forbric/kernel/mixin/ForbricMixinService.java`](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/mixin/ForbricMixinService.java) (Mixin integration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_install["Installation"]
  node_installer["Install orchestration<br/>[Installer.java]"]
  node_installerui["Installer window<br/>[InstallerGui.java]"]
  node_jdk["Java discovery<br/>[JdkLocator.java]"]
  node_pins["Version pins<br/>[Pins.java]"]
  node_artifacts["Game artifacts<br/>[GameArtifacts.java]"]
  node_remote["Artifact sources<br/>[RemoteSource.java]"]
end

subgraph group_boot["Mod loading"]
  node_bootmain["Kernel boot<br/>[Main.java]"]
  node_discovery["Mod discovery"]
  node_catalog["Mod catalog<br/>[ModCatalog.java]"]
  node_loader["Fabric-compatible loader"]
  node_entrypoints["Entrypoint storage"]
  node_classloading["Mod class loading"]
end

subgraph group_compat["Compatibility"]
  node_mixins["Mixin integration"]
  node_access["Access transforms"]
  node_eventbridge["Event bridges<br/>[EventBridges.java]"]
  node_crossloader["Cross-loader transfers"]
  node_hopperpatch["Hopper compatibility patch"]
  node_hopperruntime["Fabric storage runtime"]
end

subgraph group_experience["In-game experience"]
  node_modlist["Unified mod list<br/>[ModCatalog.java]"]
  node_settings["Mod settings screens<br/>[ModPresence.java]"]
end

node_user(("Player / installer user"))
node_minecraft[("Minecraft files")]
node_mods[("Mixed mods folder")]
node_minecraftgame(("Minecraft instance"))

node_user -->|"opens"| node_installerui
node_installerui -->|"starts install"| node_installer
node_installer -->|"locates Java"| node_jdk
node_installer -.->|"uses versions"| node_pins
node_installer -->|"builds artifacts"| node_artifacts
node_installer -->|"fetches files"| node_remote
node_remote -->|"downloads"| node_minecraft
node_artifacts -->|"installs version"| node_minecraft
node_user -->|"places mixed mods"| node_mods
node_mods -.->|"provides mods"| node_bootmain
node_bootmain -->|"discovers mods"| node_discovery
node_bootmain -->|"records discoveries"| node_catalog
node_discovery -.->|"classifies mods"| node_catalog
node_bootmain -.->|"starts loading"| node_loader
node_loader -->|"fills entrypoints"| node_entrypoints
node_loader -.->|"loads classes"| node_classloading
node_classloading -->|"supplies classes"| node_mixins
node_mixins -.->|"transforms game"| node_access
node_mixins -.->|"bridges events"| node_eventbridge
node_mixins -.->|"adapts APIs"| node_crossloader
node_hopperpatch -->|"injects calls"| node_hopperruntime
node_hopperruntime -.->|"uses Fabric storage"| node_crossloader
node_catalog -.->|"feeds mod list"| node_modlist
node_user -->|"opens menu"| node_modlist
node_modlist -->|"opens config"| node_settings
node_loader -->|"runs mods"| node_minecraftgame
node_eventbridge -->|"delivers events"| node_minecraftgame
node_crossloader -->|"enables transfers"| node_minecraftgame

click node_installer "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/Installer.java"
click node_installerui "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/InstallerGui.java"
click node_jdk "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/JdkLocator.java"
click node_pins "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/Pins.java"
click node_artifacts "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/GameArtifacts.java"
click node_remote "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/RemoteSource.java"
click node_bootmain "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/boot/Main.java"
click node_discovery "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/discovery/ForbricModDiscoverer.java"
click node_catalog "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/api/ModCatalog.java"
click node_loader "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/fabric/KernelFabricLoader.java"
click node_entrypoints "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/fabricmc/loader/impl/entrypoint/EntrypointStorage.java"
click node_classloading "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/classloading/ForbricClassLoader.java"
click node_mixins "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/mixin/ForbricMixinService.java"
click node_access "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/access/AccessTransformer.java"
click node_eventbridge "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/api/EventBridges.java"
click node_crossloader "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/api/ProtocolExtensions.java"
click node_hopperpatch "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/transform/HopperFabricStorageInjector.java"
click node_hopperruntime "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/runtime/java/net/forbric/kernel/runtime/transfer/KernelFabricHopperStorage.java"
click node_modlist "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/api/ModCatalog.java"
click node_settings "https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/api/ModPresence.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_installerui,node_jdk,node_pins,node_artifacts,node_remote,node_user toneBlue
class node_bootmain,node_discovery,node_catalog,node_loader,node_entrypoints,node_classloading,node_minecraft,node_mods toneAmber
class node_mixins,node_access,node_eventbridge,node_crossloader,node_hopperpatch,node_hopperruntime toneMint
class node_modlist,node_settings toneRose
class node_minecraftgame toneIndigo
```

## Components

### Installation

- [Install orchestration](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/Installer.java): `forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/Installer.java`
- [Installer window](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/InstallerGui.java): `forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/InstallerGui.java`
- [Java discovery](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/JdkLocator.java): `forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/JdkLocator.java`
- [Version pins](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/Pins.java): `forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/Pins.java`
- [Game artifacts](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/GameArtifacts.java): `forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/GameArtifacts.java`
- [Artifact sources](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/RemoteSource.java): `forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/RemoteSource.java`

### Mod loading

- [Kernel boot](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/boot/Main.java): `forbric-kernel/src/main/java/net/forbric/kernel/boot/Main.java`
- [Mod discovery](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/discovery/ForbricModDiscoverer.java): `forbric-kernel/src/main/java/net/forbric/kernel/discovery/ForbricModDiscoverer.java`
- [Mod catalog](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/api/ModCatalog.java): `forbric-kernel/src/main/java/net/forbric/api/ModCatalog.java`
- [Fabric-compatible loader](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/fabric/KernelFabricLoader.java): `forbric-kernel/src/main/java/net/forbric/kernel/fabric/KernelFabricLoader.java`
- [Entrypoint storage](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/fabricmc/loader/impl/entrypoint/EntrypointStorage.java): `forbric-kernel/src/main/java/net/fabricmc/loader/impl/entrypoint/EntrypointStorage.java`
- [Mod class loading](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/classloading/ForbricClassLoader.java): `forbric-kernel/src/main/java/net/forbric/kernel/classloading/ForbricClassLoader.java`

### Compatibility

- [Mixin integration](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/mixin/ForbricMixinService.java): `forbric-kernel/src/main/java/net/forbric/kernel/mixin/ForbricMixinService.java`
- [Access transforms](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/access/AccessTransformer.java): `forbric-kernel/src/main/java/net/forbric/kernel/access/AccessTransformer.java`
- [Event bridges](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/api/EventBridges.java): `forbric-kernel/src/main/java/net/forbric/api/EventBridges.java`
- [Cross-loader transfers](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/api/ProtocolExtensions.java): `forbric-kernel/src/main/java/net/forbric/api/ProtocolExtensions.java`
- [Hopper compatibility patch](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/kernel/transform/HopperFabricStorageInjector.java): `forbric-kernel/src/main/java/net/forbric/kernel/transform/HopperFabricStorageInjector.java`
- [Fabric storage runtime](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/runtime/java/net/forbric/kernel/runtime/transfer/KernelFabricHopperStorage.java): `forbric-kernel/src/runtime/java/net/forbric/kernel/runtime/transfer/KernelFabricHopperStorage.java`

### In-game experience

- [Unified mod list](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/api/ModCatalog.java): `forbric-kernel/src/main/java/net/forbric/api/ModCatalog.java`
- [Mod settings screens](https://github.com/ray-t-r/minecraft-forbric-mod-loader/blob/main/forbric-kernel/src/main/java/net/forbric/api/ModPresence.java): `forbric-kernel/src/main/java/net/forbric/api/ModPresence.java`

### Other components

- **Player / installer user**
- **Minecraft files**
- **Mixed mods folder**
- **Minecraft instance**

## Connections

- Player / installer user → Installer window: opens (evidence: `README.md`)
- Installer window → Install orchestration: starts install (evidence: `README.md`)
- Install orchestration → Java discovery: locates Java
- Install orchestration → Version pins: uses versions
- Install orchestration → Game artifacts: builds artifacts (evidence: `README.md`)
- Install orchestration → Artifact sources: fetches files
- Artifact sources → Minecraft files: downloads (evidence: `README.md`)
- Game artifacts → Minecraft files: installs version (evidence: `README.md`)
- Player / installer user → Mixed mods folder: places mixed mods (evidence: `README.md`)
- Mixed mods folder → Kernel boot: provides mods
- Kernel boot → Mod discovery: discovers mods (evidence: `forbric-kernel/src/main/java/net/forbric/kernel/boot/Main.java`)
- Kernel boot → Mod catalog: records discoveries (evidence: `forbric-kernel/src/main/java/net/forbric/kernel/boot/Main.java`)
- Mod discovery → Mod catalog: classifies mods
- Kernel boot → Fabric-compatible loader: starts loading
- Fabric-compatible loader → Entrypoint storage: fills entrypoints (evidence: `forbric-kernel/src/main/java/net/fabricmc/loader/impl/entrypoint/EntrypointStorage.java`)
- Fabric-compatible loader → Mod class loading: loads classes
- Mod class loading → Mixin integration: supplies classes (evidence: `forbric-kernel/src/main/java/net/forbric/kernel/mixin/ForbricMixinService.java`)
- Mixin integration → Access transforms: transforms game
- Mixin integration → Event bridges: bridges events
- Mixin integration → Cross-loader transfers: adapts APIs
- Hopper compatibility patch → Fabric storage runtime: injects calls (evidence: `forbric-kernel/src/main/java/net/forbric/kernel/transform/HopperFabricStorageInjector.java`)
- Fabric storage runtime → Cross-loader transfers: uses Fabric storage
- Mod catalog → Unified mod list: feeds mod list
- Player / installer user → Unified mod list: opens menu (evidence: `README.md`)
- Unified mod list → Mod settings screens: opens config (evidence: `README.md`)
- Fabric-compatible loader → Minecraft instance: runs mods (evidence: `README.md`)
- Event bridges → Minecraft instance: delivers events (evidence: `README.md`)
- Cross-loader transfers → Minecraft instance: enables transfers (evidence: `README.md`)
