v13 — Now supporting Minecraft 1.21.x

Build Once.
Deploy Everywhere.

ArchitecturyAPI is the premier cross-platform framework for Minecraft mod development. Write your mod once and run it seamlessly on Fabric, Forge, and NeoForge — with a single shared codebase.

Fabric Forge NeoForge
Why ArchitecturyAPI

Everything you need to build
cross-platform mods

Architectury streamlines multi-loader mod development with a clean abstraction layer, powerful tooling, and a thriving ecosystem trusted by millions of players.

Cross-Platform by Design

Write your mod code once using the Architectury common API and compile it for Fabric, Forge, and NeoForge simultaneously. No more maintaining three separate codebases for the same mod.

Architectury Loom

The dedicated Gradle plugin handles all complex multi-loader build configuration automatically. Scaffold your project with the official template and have it compiling in under ten minutes.

Free & Open Source

Released under the LGPL-3.0 license, ArchitecturyAPI is completely free for personal and commercial use. Fork it, audit it, or contribute — everything is open on GitHub.

Unified Event System

Architectury normalizes the differences between Fabric's event callbacks and Forge's event bus into a single, clean API. Register once, fire everywhere — no platform-specific event wiring needed.

Registry & Networking APIs

Abstracted registry objects, fluid handling, entity attributes, capability-like interfaces, and packet networking that work identically across all platforms. Ship features, not boilerplate.

Thriving Ecosystem

Join thousands of developers building with Architectury. An active Discord, comprehensive documentation at docs.architectury.dev, and hundreds of open-source example mods to learn from.

Platform Support

One API, three platforms

ArchitecturyAPI officially supports all three major Minecraft Java Edition mod loaders so your mods reach the widest possible player base.

🧵

Fabric

The modern, lightweight mod loader known for rapid updates and a developer-friendly API. Ideal for performance-focused and experimental mods.

Fully Supported
⚒️

Forge

The original Minecraft mod loader with over a decade of history and home to thousands of classic mods and the largest modpack ecosystem.

Fully Supported

NeoForge

The next-generation fork of Forge offering modern API improvements and active development while maintaining compatibility with the existing ecosystem.

Fully Supported
By the Numbers

Trusted by the Minecraft modding community

0
Million Downloads
0
Mods Using Architectury
0
Supported Mod Loaders
0
Major API Versions
Built With Architectury

Powering your favorite Minecraft mods

Thousands of mods on Modrinth and CurseForge rely on ArchitecturyAPI. Here are some of the most beloved cross-platform titles in the community.

FAQ

Frequently asked questions

Everything you need to know about ArchitecturyAPI and multi-loader Minecraft mod development.

ArchitecturyAPI is a cross-platform Minecraft modding framework that eliminates the need to maintain separate codebases for Fabric, Forge, and NeoForge. Without it, developers must write and maintain the same mod three times using three completely different APIs. Architectury provides a unified abstraction layer so you write mod logic once in the common module and the build system handles per-platform compilation automatically.
It depends on which parts of Architectury your mod uses. If you call the runtime API modules — events, registries, networking, fluid hooks — then yes, players must have ArchitecturyAPI installed. It is one of the most widely installed mods on both Modrinth and CurseForge, so this is rarely a barrier. If you only use Architectury Loom as a build tool without calling runtime APIs, no runtime dependency is needed.
ArchitecturyAPI supports Minecraft Java Edition from 1.14 through the latest 1.21.x releases. The project actively tracks new Minecraft versions and typically releases compatible builds shortly after major Minecraft updates. Older version branches continue to receive critical bug fixes. Check the GitHub releases page for the full version matrix.
You declare a static method in your common module and annotate it with @ExpectPlatform. At compile time, Architectury Loom transforms the bytecode so that the common method body is replaced by a dispatch to the corresponding platform-specific class. You implement MyHelperFabric and MyHelperForge (and NeoForge) separately. The common code never needs to know which platform it's running on — Loom wires it for you.
Yes. ArchitecturyAPI is licensed under LGPL-3.0, which explicitly permits use in commercial projects — including modpacks sold through platforms like Overwolf or distributed as part of paid server subscriptions. You are free to include it in any modpack. The main LGPL requirement is that modifications to the Architectury library code itself must remain open-source; your own mod code is not affected.
The official documentation lives at docs.architectury.dev and covers everything from initial setup to advanced platform abstraction patterns. The Architectury Discord server is the most active place for questions and real-time support. Bug reports and feature requests go to the GitHub issue tracker.
Get Started Today

Ready to build your
cross-platform mod?

Join thousands of mod developers using ArchitecturyAPI to ship mods that work everywhere. It is free, open-source, and ready to use right now.