Curios API Wiki

Curios API is a flexible inventory framework for Minecraft mods. It adds equippable accessory slots - rings, amulets, necklaces, belts, charms, back items, bracelets, hands, heads, and generic "curio" slots - that other mods register and fill with their own wearable items. Alongside the slots themselves it provides a dedicated Curios screen next to the regular player inventory (opened with its own keybind or the button in the inventory), so equipped accessories are managed in one place.

Curios API has no standalone content: on its own it adds no blocks, no mobs, and no gameplay. Slots only appear when a mod registers them, and items only become equippable when a mod marks them as curios. You install it because another mod requires it as a dependency or integrates with it to enable extra equipment slots.

Install Curios API whenever a mod lists it as a required dependency, or when a mod offers optional integration you want to enable. If a required dependency is missing, the game reports a missing-dependency error for the mod id curios.

• Many equipment and accessory mods (rings, amulets, charms, backpacks, artifacts) build their wearable slots on Curios API.
• Some mods use it optionally: with Curios API installed they unlock extra accessory slots - for example, Ice and Fire can use it to enable a dragon-charm accessory slot.
• Modpacks frequently include it as shared infrastructure for several accessory mods at once.

Rule of thumb: add Curios API when a mod tells you to (or when you want a mod's optional accessory slots), and leave it out otherwise.

Curios API is consumed by other mods as a dependency (mod id curios).

Adding it to a dev environment (Gradle):

repositories {
    maven { url "https://maven.theillusivec4.top/" }
}
dependencies {
    // use the artifact/version that matches your Minecraft version
    implementation "top.theillusivec4.curios:curios-neoforge:<version>"
}

Key concepts:

• Slot types - registered through data (data/curios/slots/*.json) or the API; common types include ring, necklace, belt, charm, back, head, hands, and curio (generic).
• ICurioItem / item capability - implement or attach to make an item equippable in curio slots, with hooks for tick, equip/unequip, attribute modifiers, and render.
• CuriosApi - the central lookup for slot registries and helper methods to find equipped curios on an entity.
• Slot assignment via tags - items can be made equippable by adding them to curios:<slot> item tags, no code needed.

Consult the upstream Curios documentation and wiki for full API details and current version coordinates.

What does Curios API do on its own? Nothing visible - it is a framework. Slots and items come from the mods that use it.

A mod says it needs "curios" - what do I do? Add Curios API to your mods folder alongside that mod and launch again.

I get a missing-dependency error for curios. A mod needs Curios API but it is not installed (or the version is too old). Install a matching Curios API build so the mod can load.

How do I see my accessory slots? Open your inventory and use the Curios button (or the dedicated keybind) to open the accessories screen. Slots only show up when installed mods actually register them.

Do I need it if no mod asks for it? No. Without a mod registering slots or curio items it does nothing.

Is it safe to remove? Only if no installed mod still requires it. Items equipped in curio slots are dropped or returned when their slots disappear, so unequip valuables first.