Aluminis Inject
by Aluminis
Aluminis Inject is a Fabric library that adds dependency injection, so a mod's classes can be wired together automatically instead of by hand.
What it does
Fabric does not inject objects into classes, so a mod author normally creates and registers every instance explicitly and wires them together. That works for small mods but becomes disorganized quickly in larger ones. Aluminis Inject, built on the Google Guice model, replaces much of that wiring with automatic injection based on declared rules and annotations.
The framework is set up through a Fabric entrypoint named aluminis-inject:bootstrap that points to a class extending net.aluminis.inject.model.AbstractModule. That module must provide a mod ID. Classes marked with an AutoLoad annotation are instantiated when the mod container loads, and services can receive other services as injected dependencies. Some configuration remains for providers that are not class-based. Fabric API is required, and the library is published for 1.21.4 and 1.21.5, with 2.0.0-alpha for 1.21.5 as the latest file. It is an alpha release on the alpha channel, and its source code and issue tracker are public.
Key features
Automatic autowiring
Dependencies are injected into a class without manual configuration, and the framework works out the implementation from the declared rules.
AutoLoad services
Classes annotated with AutoLoad are instantiated automatically when the mod container loads them.
Service-to-service injection
Services can be injected with other services and providers, so components connect without explicit instantiation.
Module bootstrap
A single module class, registered under the aluminis-inject:bootstrap entrypoint, sets up the framework and supplies the mod ID.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Requirements
Dependencies declared by the latest file for each loader.
Required 1
Use cases
Who it’s for: Mod developers building on Fabric who already understand object-oriented programming and dependency injection. The library assumes that background and does not teach it.
How it compares
Loot Inject is a Fabric mod for 1.21 – 1.21.5 that runs on the server alone, under the MIT License, so players need nothing installed. Dynamic Registries Modifier is a Fabric mod for 1.21.1 – 1.21.8 that can run on a client, a server or both, under the CC0 1.0 Universal license. Aluminis Inject is for mod developers and is not a gameplay mod, so it differs from both in purpose as well as version range.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| Aluminis Inject | Fabric | 1.21.4 – 1.21.5 | Client or server, optional | 2025-03-30 |
| Loot Inject | Fabric | 1.21 – 1.21.5 | Server-side only | 2025-04-14 |
| Dynamic Registries Modifier | Fabric | 1.21.1 – 1.21.8 | Client or server, optional | 2025-08-23 |
Questions
Does Aluminis Inject require Fabric API?
Which game versions does Aluminis Inject support?
Does the server need Aluminis Inject?
In the catalog
Aluminis Inject is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 15,307 mods support Minecraft 1.21.5.
Similar mods
What the author says
A dependency-injection based framework mod for simplifying creation of minecraft mods. To understand how to use this mod, it is expected to have a basic understanding of Object-Oriented Programming and Dependency Injection Before we can dive into features, let's talk a little bit about why you might want to use this…
Official listing
- Modrinth page
- modrinth.com/mod/aluminis-inject
- Owner
- Aluminis
- Published
- 2025-03-22
- Updated on Modrinth
- 2025-03-30
- Facts verified
- 2026-10-15