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
Adding to Your Project:
Add the following to your build.gradle file:
repositories {
maven {
url = "https://maven.theillusivec4.top/"
}
}
dependencies {
runtimeOnly fg.deobf("top.theillusivec4.curios:curios:${version}")
compileOnly fg.deobf("top.theillusivec4.curios:curios:${version}:api")
}
do have this for 1.12.2?
In reply to minda99:
no use baubles, its similar you can put back or belt type tools in it among others.
There is no slot for the ring or necklace, neither for the other things. it only has 2 travel bags and a tool belt.
In reply to rybugluvskats611:
This is just an API. It adds no slots by default. The slots that you currently have are all added by other mods using this API.
In reply to TheIllusiveC4:
Okay, thanks. But, how do you get the default slots?
In reply to rybugluvskats611:
There are no default slots. If you're asking how to get certain slots like ring or necklace, please refer to this guide: https://github.com/TheIllusiveC4/Curios/wiki/How-to-Use:-Users
How would one set it up so that an item using curios would give certain modifiers when worn in said slot? Like what is the tag used to define the various different curios slots?
EDIT: This is being done in the base game using CT and possibly commands. I'm not hard coding in any items.
In reply to ForgottenSalt:
I'm not really familiar with what method you're using to define the modifiers. The various curios slots are defined by whatever identifier the registering mod gives it. I'd have to learn more about what you're trying to do before I can give you an adequate answer. Do you have any scripts or documentation that you could show me that describes what you're doing with the items?
In reply to TheIllusiveC4:
Like this:
/give @p minecraft:shield{AttributeModifiers:[{AttributeName:"generic.armorToughness",Name:"generic.armorToughness",Amount:1,Operation:0,UUIDLeast:404637,UUIDMost:955319,Slot:"head"}]} 1It allows me to add attribute modifiers when in certain slots.
In reply to ForgottenSalt:
Hmm, there's no current way to do this now, but I'll look into seeing if I can add some way into it.
In reply to TheIllusiveC4:
That would be great if you can as it would add so many possibilities for this mod for map makers and modpack developers.
In reply to ForgottenSalt:
I've since released a new update for the 1.15.2 version that has this functionality using a "CurioAttributeModifiers" tag.
In reply to TheIllusiveC4:
Do you have an example on how you would go about formatting it? I checked the guides, but didn't see anything there for it. Thanks for being so quick to help!
In reply to ForgottenSalt:
It's exactly the same format as AttributeModifiers, just replace the tag "AttributeModifiers" with "CurioAttributeModifiers" and make sure that the "Slot" is the identifier name of the curio slot instead of the armor slot names. You'll know it worked if you see the right tooltips on the item.
In reply to TheIllusiveC4:
Alright, sounds good. Thanks again!
I've followed all how to use:user walk through have the orange text, the slot ui but can't slot the item in it's slot
In reply to ShadyLamp2k:
Are you sure the slot identifier is exactly the same as the datapack file you made for the item tags?
In reply to TheIllusiveC4:
In reply to TheIllusiveC4:
In reply to TheIllusiveC4:
In reply to ShadyLamp2k:
Everything looks right to me. If both the slots and the tooltip on the items are showing up then it should be working fine. Maybe try testing it in another world? Or a different launcher? I'm not really sure.