Overview#
Accessories is an accessory and equipment-slot framework for Minecraft mods. It gives developers a clean, extensible way to add wearable accessory slots - rings, amulets, necklaces, belts, gloves, capes, back items, and more - to players and other entities, and it provides a unified in-game accessories screen, slot groups, and an API for reacting to what a player has equipped.
Accessories is a dependency library: it has no standalone content and adds no gameplay of its own. It only becomes useful when a mod that adds accessories requires it. Accessories itself builds on owo-lib, so owo-lib must be installed alongside it.
Which Mods Need It#
Install Accessories whenever a mod that adds wearable accessories lists it as a dependency (mod id accessories). Without it, those mods will not load.
- The Aether uses Accessories for its wearable items and accessory slots.
- Any other mod that adds rings, amulets, capes, belts, or similar accessory items through this framework needs it.
Accessories has its own requirement: it depends on owo-lib. Always install owo-lib + Accessories together, plus the mod that actually adds the accessories.
Developer API#
Accessories is consumed by other mods as a dependency (mod id accessories). It requires owo-lib (mod id owo) on the classpath.
Adding it to a dev environment (Gradle):
repositories {
maven { url "https://maven.wispforest.io" }
}
dependencies {
modImplementation "io.wispforest:accessories:<version>"
modImplementation "io.wispforest:owo-lib:<version>" // required
}
Key entry points (package root io.wispforest.accessories):
io.wispforest.accessories.api- the mainAccessoriesAPI, theAccessoryinterface, and capabilities for reading/modifying equipped accessories.- Slot definitions - accessory slots and slot groups are defined through data (the
accessoriesdata type) so packs and mods can add or tweak slots. io.wispforest.accessories.menu- the in-game accessories screen/menu.- Events/criteria - hooks for reacting when accessories are equipped or unequipped.
Refer to the upstream Accessories documentation for the full API and current version coordinates.
FAQ & Troubleshooting#
What does Accessories do on its own? Nothing visible - it is a framework. It only matters when a mod uses it to add accessory slots.
A mod says it needs Accessories - what do I do? Install Accessories and owo-lib in your mods folder alongside that mod.
I get a missing-dependency error for accessories or owo. Accessories needs owo-lib; make sure both are installed at compatible versions.
Where is the accessories screen? It is opened through the interface the accessory-adding mod exposes; Accessories provides the screen, the mod provides the items and slots.
Do I need it if no mod asks for it? No. It has no content of its own; install it only when a mod requires it.