Adorned (Curios)

This project is for the NeoForge mod loader only.

Project Overview

Adorned represents the evolution and continuation of the Curios system for Minecraft versions 1.21 and above on the NeoForge platform. The primary goal of the mod is to ensure full compatibility with projects that previously used Curios in older game versions. To achieve this, the original API and tag structure are preserved, and the internal identifier remains "curios" to maintain backward compatibility.

Adorned is a universal and expandable system for working with accessories and additional equipment. Developers get a convenient tool for adding new equipment slots, while players gain the ability to customize these slots according to their preferences. By default, the mod doesn't add any content except for the inventory interface. Initially, only two items are available, which can be found in creative mode and serve as examples for integration with other mods.

Key Features

Expandable Slot System

New equipment slots are easily created and managed through a central identifier registry. Identical identifiers are automatically merged, eliminating functional duplication and ensuring maximum compatibility with various items. Meanwhile, unique identifiers can be used to designate special slot types.

On-Demand Slot Creation

The system doesn't include pre-installed slots — all are created only as needed. This approach prevents the appearance of extra, unused slots for which there are no suitable items.

Flexible Slot Configuration

Each slot can be fully customized: change backgrounds, sizes, as well as disable or hide by default. Developers through the API get access to functions for enabling/disabling player slots, and can also add or remove a specific number of slots of any type.

Integration with Tag System

The connection between items and slot types is implemented through Minecraft's standard tag system. To categorize items, it's sufficient to create a JSON file in the data/curios/tags folder. Items can be assigned to an unlimited number of slot types, and these settings can be completely overridden.

Complete Integration with Inventory Mechanics

All items equipped in Adorned slots support enchantments (including Mending) and curses. For developers, various helper functions are provided to simplify the integration of existing items and mechanics into the slot system.

Convenient Interface

The mod includes its own graphical interface, accessible from the player's inventory, which displays all available additional equipment slots. This allows viewing all extended equipment in one place without needing to switch between different interfaces. Developers can create their own interfaces for specific slots of their mods. The default key to open the interface is 'G'.