Curios API

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[15.0.0-beta.2+26.1.2] - 2026.04.13

Changed

• Updated to Minecraft 26.1.2

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[15.0.0-beta.1+26.1] - 2026.03.25

Changed

• Updated to Minecraft 26.1

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[14.0.0+1.21.11] - 2026.02.16

Changed

• Updated to Minecraft 1.21.11

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[13.0.0+1.21.10] - 2026.02.16

Added

• Added ICurioRenderer#render method with SubmitNodeCollector parameter

Changed

• Changed CuriosCapability#ITEM_HANDLER type to ResourceHandler of ItemResource
• Changed ICurioRendere#ModelRenderer methods to take SubmitNodeCollector instead of MultiBufferSource

Deprecated

• Deprecated ICurioRenderer#render method with MultiBufferSource parameter

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[12.0.0+1.21.8] - 2026.02.16

Added

• Added new constructors for CurioCanEquipEvent, CurioCanUnequipEvent, and CurioChangeEvent
• Added ICuriosItemHandler#loadDatapacks

Changed

• ICuriosItemHandler, ICurioStacksHandler, and IDynamicStackHandler now extend ValueIOSerializable

Deprecated

• Deprecated old constructors for CurioCanEquipEvent, CurioCanUnequipEvent, and CurioChangeEvent
• Deprecated tag-based serialization and deserialization methods:
  • serializeNBT and deserializeNBT in IDynamicStackHandler
  • serializeNBT and deserializeNBT in ICurioStacksHandler
  • writeTag and readTag in IDynamicStackHandler

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[10.0.1+1.21.4] - 2025.05.17

Fixed

• Fixed loot context crash

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[11.0.1+1.21.5] - 2025.05.17

Fixed

• Fixed loot context crash

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[11.0.0+1.21.5] - 2025.05.15

Changed

• Updated to Minecraft 1.21.5

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[10.0.0+1.21.4] - 2025.05.15

For an in-depth overview of API changes, refer to this guide.

Added

• Added ways for developers to listen to state changes (when an item is the same) and differentiate them from item changes:
  • CurioChangeEvent is now abstract, with added CurioChangeEvent.Item and CurioChangeEvent.State subclasses
  • onStateChange method added to ICurio and ICurioItem
• A new preset slot type, feet, has been added with an included default icon
• Added slot type predicates for more advanced checking in CurioAttributeModifier
• Added new data generation options, including the ability to generate tags within the same provider as the Curios data
• Added curios:player_like entity type tag, with entries for players and armor stands
• Added entities field to slot type data files for marking default entity types to add the slot type to automatically, without needing a corresponding curios/entities file
• Added the ability to create slots directly inside curios/entities data files, without needing a corresponding curios/slots file
• Added curios:generic_exclusions item tag for declaring curio items that should not be equipable into the generic curio slot by default
• Added preset slot type constants and tags to CuriosSlotTypes and CuriosTags respectively

Changed

• Updated to Minecraft 1.21.4
• Following the state change additions, onUnequip and onEquip no longer fire if the detected items are the same
• ICurioRenderer#render parameters have been adjusted for Minecraft changes
• ICurio.DropRule has moved to top.theillusivec4.curios.api.common.DropRule
• CurioAttributeModifierEvent now uses CurioAttributeModifiers instead of maps
• Moved SetCurioAttributesFunction to the official API package

Removed

• Removed all previously deprecated classes and methods

Deprecated

• Deprecated slot type methods in CuriosApi, replaced by methods in CuriosSlotTypes.
• Deprecated getAttributeModifiers in ICurio and ICurioItem
• Deprecated CuriosRendererRegistry, replaced by methods in ICurioRenderer
• Deprecated the previous utility methods in ICurioRenderer, replaced by setupHumanoidAnimations and copyHumanoidProperties
• Deprecated attribute map methods in CurioAttributeModifierEvent
• Deprecated CuriosTooltip
• Deprecated ISlotType#getIdentifier, replaced by getId
• Deprecated ICurioSlotExtension#getSlotTooltip, replaced by getSlotTooltip with an additional parameter for original tooltip lines

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[9.5.1+1.21.1] - 2025.05.14

Fixed

• Fixed crash on world load after updating from 9.4.2+1.21.1 or below #520

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[9.5.0+1.21.1] - 2025.05.14

Added

• [API] Added active states for slots to allow developers to enable or disable slots on entities during gameplay, accessible through new methods ICuriosItemHandler#isSlotActive and ICuriosItemHandler#setSlotActive

Changed

• Updated ja_jp localization #513

The format is based on Keep a Changelog and this project adheres to Semantic Versioning. Prior to version 5.2.0, this project used Forge Recommended Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[5.14.1+1.20.1] - 2025.04.13

Fixed

• Fixed slot modifiers and invalid stacks when using ICuriosItemHandler#saveInventory

The format is based on Keep a Changelog and this project adheres to Semantic Versioning. Prior to version 5.2.0, this project used Forge Recommended Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[5.14.0+1.20.1] - 2025.04.09

Added

• [API] Added ICuriosItemHandler#saveInventory(boolean, BiPredicate<ItemStack, SlotContext>) for more specific filtering on inventory saves

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[9.4.2+1.21.1] - 2025.04.08

Changed

• Inventory#contains(Predicate<ItemStack>) and Inventory#hasAnyMatching(Predicate<ItemStack>) now also check the curios inventory

The format is based on Keep a Changelog and this project adheres to Semantic Versioning. Prior to version 5.2.0, this project used Forge Recommended Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[5.13.0+1.20.1] - 2025.04.08

Added

• [API] Added ICuriosItemHandler#saveInventory(boolean, Predicate<ItemStack>) for filtering inventory saves

Changed

• Inventory#hasAnyMatching(Predicate<ItemStack>) now also checks the curios inventory

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[9.4.1+1.21.1] - 2025.04.04

Fixed

• Fixed missing inventory when a player fails to join a server #481
• Fixed Curios panel rendering beneath EMI themed panels #503

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[9.4.0+1.21.1] - 2025.03.24

Changed

• Updated tooltip logic to follow NeoForge conventions, including the use of AddAttributeTooltipsEvent and GatherSkippedAttributeTooltipsEvent #496

Fixed

• Fixed previous slot modifiers persisting after deserialization which caused inconsistent behavior when using extra slots
• Fixed caching errors that caused certain functions to misidentify curio inventory contents
• Fixed deprecated usage of ICurio#getDropRule
• Fixed datagen output not being deterministic #497
• Fixed missing slot localization fallbacks on item tooltips
• Fixed slot modifier tooltip localizations
• Fixed curios:set_curio_attributes loot table function

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[9.3.1+1.21.1] - 2025.03.12

Fixed

• Fixed slot tooltip rendering

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

This is a copy of the changelog for the most recent version. For the full version history, go here.

[9.3.0+1.21.1] - 2025.03.10

Added

• Added ICurioSlotExtension for defining additional slot behavior
• Added CuriosTags for more convenient access to commonly used Curios tags #495