Curios API — Guide

Which Mods Need It

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.

Developer API

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

Adding it to a dev environment (Gradle):

repositories {
    maven { url " }
}
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.