Wiki 9Minecraft Wiki 9Minecraft

Cardinal Components API Mod Wiki & Guide

Java EditionModGuides 4FAQ 20Related mods 60

A developer library that attaches reusable data components to game objects, enabling other mods to store and synchronize custom state without adding blocks or items itself.

DownloadCardinal Components API Mod

Get the files on 9Minecraft

Contents (5)
  1. Overview
  2. Guides
  3. Frequently asked questions
  4. Gallery
  5. You May Also Like

Overview

Cardinal Components API (CCA) is a specialized library mod designed for the Fabric and Quilt ecosystems. It provides a standardized, modular, and extremely fast way for mods to attach arbitrary data (known as "components") to various Minecraft objects. Unlike traditional NBT-based data storage, CCA uses ASM-generated extensions to ensure that data access is nearly as fast as native field access.

For players, this mod is a silent dependency required by many popular gameplay mods to handle complex mechanics like mana systems, leveling, custom energy types, or persistent player statistics. For developers, it eliminates the need for manual packet handling, complex mixins, or redundant storage logic.

Guides

Step-by-step, in-game.

Diagnosing Lag or Crashes Caused by Component SynchronizationWhy Synchronization Matters Cardinal Components can synchronize data between server and client. If a dependent mod…Fixing a World That Won't Load Because of Missing Component DataRecognizing the Symptom After removing or updating a mod that relied on Cardinal Components, your world may fail to…How to Check Which Mods Use Cardinal Components on Your WorldWhy You'd Want to Know Cardinal Components API is a library, so it doesn't add anything you can see on its own. Any…Understanding Why Your Custom Data Disappears After a Mod UpdateThe Underlying Mechanic Cardinal Components attaches data to game objects — players, chunks, entities, items, worlds,…

Frequently asked questions

What does Cardinal Components actually do in my game?
It's a library that lets other mods attach custom data to things like players, entities, chunks, or the world itself. On its own it adds nothing you can see or craft — it only matters because other installed mods depend on it.
How do I know if a mod I installed needs Cardinal Components?
Check that mod's dependencies on its download page or in its mod list entry; if Cardinal Components is listed as required, you need it. If you remove it while such a mod is installed, that mod will usually fail to load or crash.
Can I just install Cardinal Components and play normally?
Yes — it's a background library, so once it's installed alongside the mods that use it, you don't interact with it directly. There's no config screen or item to use; it just needs to be present.
Why did my custom data (levels, progress, stored values) vanish after updating a mod?
Component data is tied to how a mod defines and names its components, so if the mod changed its data format or IDs in an update, old data can no longer be read. This is a change made by the mod using Cardinal Components, not by Cardinal Components itself.

See all 20 Cardinal Components API questions ›