Regalia Slots API
- By
Flexible and expandable accessory/equipment API. Add extra equipment slots (rings, amulets, and more) to Minecraft in a compatible, user-configurable way — fork of Curios API by TheIllusiveC4.
👑 Regalia Slots API
A flexible, expandable accessory / equipment-slot API for players and developers. Fork of Curios API.
✨ Overview
|
Regalia Slots API gives mod developers a central library for adding extra accessory / equipment slots in a convenient, compatible way, and gives players a single GUI to manage them. By default the mod adds no content beyond that inventory screen — every slot is created on demand by other mods that depend on this API. If you were told to install this mod, it's because another mod on the pack depends on it. It also ships a Curios API compatibility layer, so mods built against Curios work against Regalia without the real Curios mod installed. |
|
🎯 Features
🧩 Expandable slots through a central registry
New equipment slots are registered through an identifier registry. Identical identifiers merge to avoid redundancy; unique identifiers mark special slot types.
📦 Slots are created on demand
No slots exist by default — each is created only when a mod asks for it, so there are no superfluous empty slots.
🎨 Fully customizable slots
Custom backgrounds, per-type sizes, hidden / disabled by default, per-player enable/disable and add/remove of slots of a given type.
🏷️ Tag-driven item→slot relations
Accessory items are selected through the vanilla tag system — categorizing an item is just adding it to the right data/regalia_slots_api/tags file.
🔄 Integrates with vanilla mechanics
Mending and Curses apply to items in accessory slots, plus developer helpers for wiring existing items and mechanics.
🤝 Curios API compatibility
Bundles a verbatim copy of the Curios API and a second logical curios mod id, so mods that check ModList.isLoaded("curios") and import top.theillusivec4.curios.api.* recognize Regalia's slots. Existing worlds that used the real Curios keep their equipped items (first-login migration).
🧱 Mod Structure
| Area | What it provides |
|---|---|
api | Public API surface: slot types, slot context/result, the ICurio / ICurioItem capabilities, events, tags, tooltip and trigger helpers. Also published as a separate -api jar. |
common | Slot and entity data managers, the curio inventory capability + stack handlers, the inventory / container menu, and the client↔server sync packets. |
client | The accessory GUI opened from the inventory (buttons, pages, cosmetic toggle) and the on-entity render layer. |
compat/curios | The Curios compatibility layer: the ICuriosPlatform SPI adapter, the @Mod("curios") entry point registering the curios:inventory / curios:item capabilities, and the legacy Curios data migration. |
top.theillusivec4.curios.api | Verbatim copy of the Curios API (matching the upstream version each build targets), for binary compatibility with mods compiled against the real Curios. |
mixin / server | Small vanilla patches the slot logic needs, and the /regalia_slots_api command family. |
📄 Requirements
| Minecraft / NeoForge | see Available Versions below |
| Java | 21+ |
| Side | Client and Server (required on both) |
| Incompatible with | the real Curios API (shared curios mod id — install one or the other) |
📦 Available Versions
| Minecraft | NeoForge | Java | Latest build | Status |
|---|---|---|---|---|
| 26.2 | 26.2.0.45-beta+ | 21 | 1.1.3 | Stable |
| 1.21.1 | 21.1.249+ | 21 | 1.0.0 | Stable |
Both versions share this CurseForge project. Pick the file that matches your Minecraft version — the API surface is the same across both.
🎮 How to Use
- Install as a dependency of another mod that requires it, on both client and server.
- Open the accessory screen from the button in your inventory.
- Configure slots per preference in
config/regalia_slots_api-common.toml— by default the 11 preset slots (back, belt, body, bracelet, charm, curio, feet, hands, head, necklace, ring) are granted to players.
🙏 Credits & License
Regalia Slots API is a fork of Curios API by TheIllusiveC4, rebranded under a new mod id, package and assets. The 26.2 build targets the current NeoForge line; the 1.21.1 build is a re-fork from the upstream Curios 1.21.1 sources (see Available Versions). All credit for the original design and implementation goes to the original author. Licensed LGPL-3.0-or-later, same as upstream; the full license text ships in the jar (COPYING.LESSER).
Maintained by Stalking Dragons.
https://codex.skdragons.com/
Codex Stalking Dragons — Minecraft Modding
Regalia Slots API Team
