Curios API Mod [1.21.11, 1.21.10, 1.21.8]

Curios API: Flexible Accessory System & Inventory GUI

Curios is a versatile and expandable accessory and equipment API designed for both players and mod developers. Its primary goal is to give creators a convenient, compatible way to add extra equipment slots, while also allowing players to customize which slots appear.

Expandable equipment slots via a central registry. New slot types can be created and managed by registering an identifier. Identical identifiers automatically merge, eliminating functional overlap and ensuring maximum compatibility with potential items, while unique identifiers remain available for special slot categories.

Slots are created only when needed. No slots are present by default; the system generates them on demand. This prevents empty or irrelevant slots from cluttering the inventory.

Fully customizable and manipulable slots. Each slot can have a custom background, different size, and can be disabled or hidden by default. Developers can use the API to enable or disable specific slots for a player, or to add or remove a certain number of slots of a given type.

Flexible item‑curio relationships using vanilla tags. Items are assigned to curio types through Minecraft’s standard tag system. Categorizing items is as simple as creating a JSON file inside data/curios/tags. Items may belong to multiple curio types, and these assignments can be completely overridden. Refer to the vanilla tag documentation for details.

Full compatibility with existing inventory mechanics. Mending, curses, and other enchantment behaviors work correctly on items placed in curio slots. Additional minor features help developers integrate their existing items and mechanics into the curio system with less effort.

Unified access through a single GUI. Curios provides its own interface, accessible from the player inventory, that displays all available slots in one place. Players no longer need to open separate menus for different slot types. However, developers may still implement their own GUIs for mod‑specific slots if desired.

Official Curios API Documentation and Setup Guides

You can find everything listed below here.

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

Q&A