Curios API

Overview

Curios is a flexible and expandable accessory/equipment API for users and developers. The purpose is to provide functionality for developers to add extra accessory/equipment slots in a convenient and compatible manner, as well as to give users the ability to configure these slots to their preferences. By default, Curios does not add any content except for an inventory GUI. There are no slots and only two items, the latter only being available through the Creative menu and primarily serving as examples for developers to use when coding their own integration.

Features
Expandable equipment slots through a central library. New equipment slots can be made and managed easily through an identifier registry. Identical identifiers will be merged together to avoid functional redundancies and provide maximum compatibility to potential items, while unique identifiers can still be used to mark special types when appropriate.
Slots are only made on-demand. There are no slots included by default, all slots are created only as needed. This reduces instances where one or more superfluous slots are present without any suitable items to go into the slot.
Slots are completely customizable and manipulable. Slots can have custom backgrounds, different sizes, and can even be disabled or hidden by default. But how would a player even access disabled slots? Through the API, developers can access functions to enable/disable a player's slots or add/remove a certain number of slots of a given type.
Flexible item->curio relations using the vanilla tag system. Potential curios are selected through the vanilla tag system, which means that categorizing items into curio types is as easy as creating a .json file in the data/curios/tags folder. Items can be categorized into as many curio types as you want as long as they're tagged in the appropriate files, and these settings can even be overridden entirely. For more information, see the vanilla tag system.
Complete integration with other inventory mechanics. Mending and Curses will work with all applicable items equipped in the curio slots. There are also various minor features for developers that make it simpler to integrate their current items or mechanics into the curio system.
Accessible from a single GUI. Curios comes with its own GUI accessible from the inventory that shows all of the available slots to a player. This allows players to see all of the extended equipment slots in a central location without needing to access different inventory GUIs. However, developers can still provide their own GUIs for their mod-specific slots if they want. The default keybinding for the GUI is 'g'.

Documentation
Setting Up the Development Environment
Slots
Example Datapack
Slots Configuration
Commands
Legacy Documentation for 1.19.x and Below

ABOUT THIS LISTING

This page describes Curios API by TheIllusiveC4. The description and screenshots are the author's own, imported from their listing on Modrinth on 3 October 2026: https://modrinth.com/mod/curios

Mythiq.net hosts no files for it. The download button goes straight to the release file on cdn.modrinth.com, so you are downloading from the author's own host, not from a copy of ours.

The download count, rating and comments on this page start at zero and count Mythiq.net only. The source's own figures are not copied here — they measure a different site, and a number that cannot be checked against our own ledger is not worth printing.

MOD LOADER

This release is built for Neoforge. A mod built for one loader will not load under another — Fabric mods do not run on Forge, and vice versa.

GAME VERSION

Built for Minecraft 26.3. Minecraft mods are tied to an exact version: a 1.21.4 build will refuse to load on 1.21.5.

THIS IS A LIBRARY

On its own it adds nothing you can see. It is here because other mods require it, and installing it is usually something another mod asked you to do.

DEPENDENCIES

Check the author's listing for required libraries before you start the game — a missing dependency shows up as a crash on launch, not as a warning.

1. Install Neoforge for the Minecraft version you play, if you have not already.

2. Download the .jar with the button on this page. Do not unzip it — a mod jar is installed as it is.

3. Put it in your mods folder:

Windows — %APPDATA%\.minecraft\mods

macOS — ~/Library/Application Support/minecraft/mods

Linux — ~/.minecraft/mods

4. Launch the game with the Neoforge profile selected.

ON A SERVER

Anything that changes world generation or gameplay has to be installed on the server as well as on every client. Client-side visual and interface mods do not.

UPDATING

Replace the old .jar rather than adding the new one beside it. Two versions of the same mod in the folder is a crash on launch.