This project is for the Forge mod loader. To see its counterpart for the Fabric mod loader, please go here.
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
any chance for answer to this question?
In reply to AnikaVoin:
There will never be native slots in Curios, it goes against the philosophy of limiting implementation details as much as possible. All of the items added by Curios aren't even meant to be obtained, they're just there as example items for developers. If you do want those items to be obtainable, you have to make a datapack anyways to add recipes for them, so I don't see the issue with adding the slot configuration for them yourself as well.
In reply to TheIllusiveC4:
okay, thanks
does it have version 1.12.2?
In reply to skylar_lock:
For 1.12.2 you have mod called "baubles" its pretty simmilar to this.
In reply to pilotvasily:
ok ty
You see, this mod is the core for the Curios mods, the problem is. This mod also contains its own items, such as Curious necklace, Curious crown, Curious knuckles, and Curious ring, and the problem is, this mod doesn't contain slots for these items, we have to make it ourselves as a datapack. Can you make the slot directly for the mod?
The game crash with curios 1.16.2 and 1.16.1
I'm using the latest forge version.
In reply to alestif_:
Please report all issues to the issue tracker with the crash log attached.
Hi, first of all amazing mod. the how to is super easy to understand. i do have a question regarding the white button that also exists at each of the slots. does those do anything?
In reply to dowakaday:
They toggle the rendering of the item in the slot on/off when applicable.
any chance of a 1.16.3 update :)
In reply to gooberbomb1:
You gotta give developers some time to update their mods.
Curious 1.16.2 - 4.0.0.1 game crash when i press Open/Close curious inventory
In reply to darkyuki1993:
Please report all issues to the issue tracker.
im using forge 33.0.34 for minecraft 1.16.2 and this happens:
error game crashed,
An unexpected issue occured and the game has crashed . Werre sorry for the inconvience
Exit code: 0
Not sure how possible it would be or maybe its already integrated but is there a way to allow "bauble" type items to use the curios system? Such as a backpacks mod?
In reply to Razorfin8Official:
Yes. Curios doesn't dictate anything, you can make whatever kind of slot you want.
so making a pack right, and I wanted to add a custom slot so I went to read up on the users guide and it said to edit the serverconfig in the folder for that world, wouldn't that mean that ONLY that world will have the new slot? And if so is there no way to make it global to all worlds
In reply to superuglyhuman:
Yes. There's a defaultconfig folder in the root folder that can house default configs you can load for every world.