Architectury API is a library mod that provides an intermediary abstraction layer designed to simplify developing multiplatform mods across Fabric, Forge, NeoForge, and Quilt for Minecraft. Created by shedaniel, it allows mod developers to write a single codebase that works seamlessly across multiple mod loaders without duplicating platform-specific code.
One of the biggest headaches in the Minecraft modding ecosystem is fragmentation. Fabric, Forge, NeoForge, and Quilt each have their own APIs, event systems, and registry methods — meaning mod developers who want to support multiple platforms often have to maintain separate codebases that do essentially the same thing. Architectury API solves this problem by sitting between the mod and the loader, translating calls so developers can write once and deploy everywhere. With over 68 million downloads since its release in November 2020, Architectury has become one of the most essential library mods in the entire Minecraft modding ecosystem. It is the backbone behind countless popular mods that support multiple loaders simultaneously.
Key Features of Architectury API
- Cross-Platform Abstraction Layer — Architectury API abstracts the differences between Fabric API, Forge API, NeoForge, and Quilt into a single unified interface. This means mod developers do not need to learn and maintain four separate implementations of the same functionality. For players, this translates to more mods being available on their preferred loader.
- Over 90 Event Hooks — The API currently provides more than 90 event hooks that cover a wide range of game mechanics and lifecycle moments. These hooks give developers consistent access to events like world loading, entity interactions, and rendering callbacks regardless of which loader is running underneath. This comprehensive coverage means fewer compatibility issues and more stable mods.
- Networking Abstraction — Handling packets and network communication between client and server differs across loaders. Architectury API provides a unified networking layer that lets developers send and receive packets without writing loader-specific networking code. This reduces bugs and ensures consistent multiplayer behavior across all supported platforms.
- Game Registry Abstraction — Registering blocks, items, entities, and other game objects follows different patterns on each loader. Architectury wraps these registration systems into one clean API, eliminating boilerplate code and reducing the chances of registration-order bugs that can cause crashes on startup.
- @ExpectPlatform Annotation — This powerful annotation allows developers to define methods that automatically resolve to platform-specific implementations at runtime. You write the common interface once, provide the Fabric and Forge implementations separately, and Architectury wires them together. It works on static methods and dramatically reduces the complexity of cross-platform projects.
- Open Source Under LGPL-3.0 — Architectury API is fully open source under the LGPL-3.0 license, meaning anyone can inspect the code, contribute improvements, or learn from its architecture. The source is available on GitHub, and the project welcomes community contributions. This transparency gives both developers and players confidence in the library's quality and longevity.
- Comprehensive Toolchain Ecosystem — Beyond the API itself, Architectury offers a complete development toolchain including Architectury Loom (a fork of Fabric Loom with multiplatform capabilities), a Gradle plugin for project setup, and ready-to-use mod templates. This ecosystem makes it straightforward to start a new multiplatform mod project from scratch.
Screenshots
How to Install Architectury API
- First, make sure you have your preferred mod loader installed. Architectury API supports Fabric, Forge, NeoForge, and Quilt — install whichever one matches the mods you want to use.
- Download the correct Architectury API file for your Minecraft version and loader from the download section below. Double-check that the file matches both your game version and your loader.
- Open your Minecraft installation folder. You can find it by launching Minecraft, going to Options → Resource Packs → Open Pack Folder, then navigating one level up.
- Place the downloaded
.jarfile into themodsfolder. If the folder does not exist, create it manually. - Launch Minecraft using your mod loader profile. Architectury API runs as a background library — you will not see it in-game, but mods that depend on it will now function correctly.
Requirements & Compatibility
| Requirement | Details |
|---|---|
| Supported Loaders | Fabric, Forge, NeoForge, Quilt |
| Minecraft Versions | 1.18.2 – 1.21.11 |
| Latest Build | v19.0.1 for Minecraft 1.21.11 |
| License | LGPL-3.0-only |
| Dependencies | Fabric API (on Fabric), respective loader API for other platforms |
What's New
- Architectury API v19.0.1 has been released with full support for Minecraft 1.21.11.
- The latest update was published on December 16, 2025, porting the library to the newest game version.
- Both NeoForge and Fabric builds are available for the latest Minecraft versions from 1.21.4 through 1.21.11.
- The project continues its consistent update cadence, supporting new Minecraft versions shortly after their release.
Pros and Cons
Pros
- Supports all four major mod loaders: Fabric, Forge, NeoForge, and Quilt
- Over 90 event hooks covering a wide range of game systems
- Actively maintained with rapid updates for new Minecraft versions
- Open source with a large and engaged developer community
- Complete toolchain with Loom, Gradle plugin, and project templates
- Appears to be lightweight — as a library mod, it adds no gameplay overhead
Cons
- Adds an extra dependency players must install alongside dependent mods
- Primarily useful for developers — regular players only install it as a requirement
- The @ExpectPlatform annotation is limited to static methods only
- Architectury API is optional within the Architectury ecosystem — some developers use only the Gradle plugin, which can cause confusion about what to install
Alternatives to Architectury API
- Sinytra Connector — A compatibility layer that allows running Fabric mods on Forge/NeoForge without requiring developers to maintain separate builds, offering a different approach to the cross-platform problem.
- Fabric API — The core API library for Fabric mod development, essential if you are building Fabric-only mods and do not need cross-platform support.
- Forgified Fabric API — A port of Fabric API to NeoForge that allows Fabric-based code to run on NeoForge, serving as another bridge between the two ecosystems.
Download Architectury API
| Minecraft Version | Fabric | NeoForge |
|---|---|---|
| For Minecraft 1.21.11 | Download | Download |
| For Minecraft 1.21.10 | Download | Download |
| For Minecraft 1.21.9 | Download | Download |
| For Minecraft 1.21.8 | Download | Download |
| For Minecraft 1.21.7 | Download | Download |
| For Minecraft 1.21.6 | Download | Download |
| For Minecraft 1.21.5 | Download | Download |
| For Minecraft 1.21.4 | Download | Download |
| For Minecraft 1.21.3 | Download | Download |
| For Minecraft 1.21.2 | Download | Download |
| For Minecraft 1.21.1 | Download | Download |
| For Minecraft 1.21 | Download | Download |
Always download mods from official sources to stay safe.
Frequently Asked Questions
Do I need Architectury API as a regular player?
Yes — you need it if any of your installed mods list Architectury API as a dependency. Many popular mods that support multiple loaders rely on this library behind the scenes. Check your mod descriptions; if Architectury is listed under requirements, download and install the matching version for your loader and Minecraft version.
Does Architectury API work with NeoForge?
Yes — Architectury API fully supports NeoForge alongside Fabric, Forge, and Quilt. Recent releases provide dedicated NeoForge and Fabric builds for Minecraft versions 1.21.4 through 1.21.11. Make sure you download the correct build that matches your loader.
Will Architectury API affect my game performance?
No noticeable impact — Architectury API is a library mod that provides code abstractions for other mods to use. It does not add any visual elements, new blocks, or active background processes to your game. It appears to be lightweight and only runs code when dependent mods call its API functions.
Can I use Architectury API with OptiFine or Sodium?
Yes — Architectury API operates at the API abstraction level and does not modify rendering or game performance systems. It should be compatible with optimization mods like Sodium or OptiFine since they work on entirely different parts of the game. However, always check for known conflicts with your specific mod combination.
Is Architectury API the same as the Architectury Plugin?
No — they are separate components of the Architectury ecosystem. The Architectury Plugin is a Gradle plugin that enables multiplatform project setup and build configuration for mod developers. The Architectury API is the runtime library that provides cross-platform event hooks, networking, and registry abstractions. Developers can use the plugin without the API, but most multiplatform mods benefit from both.
