# Aluminis Inject<\/p>\n
A dependency-injection based framework mod for simplifying creation of minecraft mods.
\nTo understand how to use this mod, it is expected to have a basic understanding of
\nObject-Oriented Programming and
\nDependency Injection<\/p>\n
## Why <\/p>\n
Before we can dive into features, let’s talk a little bit about why you might want to use this mod… rather
\nthan standard fabric development. A downfall of fabric, there is no automatic injection: Fabric doesn\u2019t “inject” objects into your classes.
\nYou\u2019re responsible for instantiating and registering everything explicitly. Basically, you make many different classes
\nthen instantiate them manually and finally wire it all together. This is fine for small mods, where not much wiring\/registration
\nis required, but when you’re working on larger, more complex mods… it can become disorganized and confusing fast.<\/p>\n
### 1. Manual Boilerplate
\nIn Fabric, you have to explicitly register every single item, block, event listener, etc. with no abstraction layer.
\nThis means there is more repetitive code, especially as your mod scales up.<\/p>\n
### 2. Scaling Pain
\nA small Fabric mod feels clean and simple.<\/p>\n
A large Fabric mod? Now you\u2019re wrangling dozens or hundreds of manual Registry.register() calls,
\nevent registrations, etc. Without a central container or automation system (like a DI container), scaling to big
\nprojects requires building your own abstractions.<\/p>\n
## Core Features<\/p>\n
### Automatic dependency injection (Autowiring)<\/p>\n
Autowiring is a feature that automatically injects dependencies into a class without requiring
\nexplicit configuration or manual wiring. Instead of writing configuration code to specify which implementation
\nshould be injected, the framework automatically figures it out based on certain rules (in this case, an annotation).<\/p>\n
Of course, some configuration may still be needed for non-class based providers, if you want to use them.
\nFor more information, view the Google Guice Wiki.<\/p>\n
## Getting Started<\/p>\n
First, set up the fabric entrypoint named `aluminis-inject:bootstrap` pointing to a class that extends
\n`net.aluminis.inject.model.AbstractModule`. Aluminis inject will instantiate this class, and
\nuse it to autoload your services.<\/p>\n
“`json
\n“aluminis-inject:bootstrap”: [
\n “net.aluminis.inject.test.module.TestModule”
\n]
\n“`<\/p>\n
In your module entrypoint, be sure to implement the `provideModId()` method, to provide your modId.
\nThis can be injected <\/p>\n
“`java
\nimport com.google.inject.Provides;
\nimport net.aluminis.inject.api.annotation.ModId;
\nimport net.aluminis.inject.api.model.AbstractModule;<\/p>\n
public class TestModule extends AbstractModule {<\/p>\n
@Provides \/\/ Optional (Tells autoloader to make this value a provider)
\n @ModId \/\/ Optional (Tells autoloader to make this value available with the annotation @ModId)
\n public String provideModId() {
\n return “aluminis-inject”;
\n }<\/p>\n
public TestModule() {
\n LoggerFactory.getLogger(MOD_ID).info(“TestModuleInit worked!”);
\n }
\n}
\n“`<\/p>\n
Make your services! Any class with the `@AutoLoad` annotation will be automatically loaded to the mod container.<\/p>\n
“`java
\n@AutoLoad()
\npublic class TestService {
\n public TestService() {<\/p>\n
}
\n}
\n“`<\/p>\n
Services can be injected with other services, or providers too. Autowiring is done automatically! For more information,
\nview the Google Guice Wiki<\/p>\n
“`java
\n@AutoLoad()
\npublic class TestService {
\n @Inject
\n public TestService(@ModId String modId) {
\n LoggerFactory.getLogger(modId).info(“TestService worked!”);
\n }
\n}
\n“`<\/p>\n","protected":false},"excerpt":{"rendered":"
A dependency-injection based framework mod for simplifying creation of minecraft mods<\/p>\n","protected":false},"featured_media":12777,"template":"","meta":{"_minecraft_slug":"aluminis-inject","_minecraft_project_id":"BAwZB2UH","_minecraft_author":"KraftyKaleb","_minecraft_license":"Apache-2.0","_minecraft_downloads":295,"_minecraft_follows":5,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"aluminis-inject.zip","_minecraft_size_bytes":1357135,"_minecraft_version_count":17,"_minecraft_updated_at":"2026-05-15T18:25:12.272173Z","_minecraft_date_created":"2025-03-27T04:27:14.657648Z","_minecraft_date_modified":"2025-03-30T20:48:01.606966Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/aluminis-inject","_minecraft_icon_attachment_id":12777,"_minecraft_imported_at":"2026-05-31T17:09:12+00:00","_minecraft_import_hash":"fd23393c598f087c6d7687e000c10781","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[43,97,873,92],"mod_loader":[99],"minecraft_version":[38,78],"class_list":["post-12776","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-cursed","mod_category-fabric","mod_category-library","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-4","minecraft_version-1-21-5"],"yoast_head":"\n