How ray-t-r/minecraft-forbric-mod-loader works
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: Installer.java Install orchestration · Main.java Kernel boot · KernelFabricLoader.java Fabric-compatible loader · ForbricMixinService.java Mixin integration
Components 24
Installation
- Install orchestration
forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/Installer.java - Installer window
forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/InstallerGui.java - Java discovery
forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/JdkLocator.java - Version pins
forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/Pins.java - Game artifacts
forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/GameArtifacts.java - Artifact sources
forbric-kernel-installer/src/main/java/net/forbric/installer/kernel/RemoteSource.java
Mod loading
- Kernel boot
forbric-kernel/src/main/java/net/forbric/kernel/boot/Main.java - Mod discovery
forbric-kernel/src/main/java/net/forbric/kernel/discovery/ForbricModDiscoverer.java - Mod catalog
forbric-kernel/src/main/java/net/forbric/api/ModCatalog.java - Fabric-compatible loader
forbric-kernel/src/main/java/net/forbric/kernel/fabric/KernelFabricLoader.java - Entrypoint storage
forbric-kernel/src/main/java/net/fabricmc/loader/impl/entrypoint/EntrypointStorage.java - Mod class loading
forbric-kernel/src/main/java/net/forbric/kernel/classloading/ForbricClassLoader.java
Compatibility
- Mixin integration
forbric-kernel/src/main/java/net/forbric/kernel/mixin/ForbricMixinService.java - Access transforms
forbric-kernel/src/main/java/net/forbric/kernel/access/AccessTransformer.java - Event bridges
forbric-kernel/src/main/java/net/forbric/api/EventBridges.java - Cross-loader transfers
forbric-kernel/src/main/java/net/forbric/api/ProtocolExtensions.java - Hopper compatibility patch
forbric-kernel/src/main/java/net/forbric/kernel/transform/HopperFabricStorageInjector.java - Fabric storage runtime
forbric-kernel/src/runtime/java/net/forbric/kernel/runtime/transfer/KernelFabricHopperStorage.java
In-game experience
- Unified mod list
forbric-kernel/src/main/java/net/forbric/api/ModCatalog.java - Mod settings screens
forbric-kernel/src/main/java/net/forbric/api/ModPresence.java
Other components
- Player / installer user
- Minecraft files
- Mixed mods folder
- Minecraft instance
Connections 28
- Player / installer user → Installer window: opens
README.md - Installer window → Install orchestration: starts install
README.md - Install orchestration → Java discovery: locates Java
- Install orchestration → Version pins: uses versions
- Install orchestration → Game artifacts: builds artifacts
README.md - Install orchestration → Artifact sources: fetches files
- Artifact sources → Minecraft files: downloads
README.md - Game artifacts → Minecraft files: installs version
README.md - Player / installer user → Mixed mods folder: places mixed mods
README.md - Mixed mods folder → Kernel boot: provides mods
- Kernel boot → Mod discovery: discovers mods
forbric-kernel/src/main/java/net/forbric/kernel/boot/Main.java - Kernel boot → Mod catalog: records discoveries
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
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
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
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
README.md - Unified mod list → Mod settings screens: opens config
README.md - Fabric-compatible loader → Minecraft instance: runs mods
README.md - Event bridges → Minecraft instance: delivers events
README.md - Cross-loader transfers → Minecraft instance: enables transfers
README.md