👑 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 — the 11 built-in preset slots (back, belt, body, bracelet, charm, curio, feet, hands, head, necklace, ring) are granted to player-like entities out of the box, and other mods that depend on this API can request more.
If you were told to install this mod, it's because another mod on the pack depends on it. The NeoForge and Forge builds also ship a Curios API compatibility layer, so mods built against Curios work against Regalia without the real Curios mod installed. The Fabric build does not include that layer.
|
|
🎯 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.
📦 Sensible default slots
The 11 preset slots are granted to player-like entities by default and can be trimmed or reordered through the
slots config option. With none configured, slots are only created when a mod or datapack asks for them.
🎨 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 (NeoForge and Forge builds)
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. Client-side shims of internal Curios classes (
CuriosScreen,
CuriosLayer) keep mods such as Apothic Attributes and Epic Fight loading and rendering curios correctly. Existing worlds that used the real Curios keep their equipped items (first-login migration, NeoForge builds only).
🧱 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 | NeoForge and Forge builds only. 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 (NeoForge only). |
top.theillusivec4.curios.api | NeoForge and Forge builds only. 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 / loader | see Available Versions below |
| Fabric only | Fabric API and Forge Config API Port |
| Java | 21+ for Minecraft 1.21.1, 25+ for Minecraft 26.x |
| Side | Client and Server (required on both) |
| Incompatible with | NeoForge and Forge builds: the real Curios API (shared curios mod id — install one or the other) |
📦 Available Versions
| Minecraft | Loader | Java | Latest build | Status |
| 26.3 | NeoForge 26.3.0.77+ | 25 | 0.0.0-beta.2 | Beta — port to Minecraft 26.3 |
| 26.3 | Forge 66.0.11+ | 25 | 1.0.0 | New — Forge port, with the Curios compatibility layer |
| 26.3 | Fabric Loader 0.19.5+ | 25 | 1.0.0 | New — Fabric port, without the Curios compatibility layer |
| 26.2 | NeoForge 26.2.0.57+ | 25 | 1.1.5 | Stable |
| 26.2 | Forge 65.1.4+ | 25 | 1.0.0 | New — Forge port, with the Curios compatibility layer |
| 26.2 | Fabric Loader 0.19.5+ | 25 | 1.0.0 | New — Fabric port, without the Curios compatibility layer |
| 26.1.2 | Forge 64.1.4+ | 25 | 1.1.6 | New — Forge port, with the Curios compatibility layer |
| 26.1.2 | Fabric Loader 0.19.5+ | 25 | 1.0.0 | New — Fabric port, without the Curios compatibility layer |
| 1.21.1 | NeoForge 21.1.259+ | 21 | 1.0.3 | Stable |
| 1.21.1 | Fabric Loader 0.19.5+ | 21 | 1.0.5 | New — Fabric port, without the Curios compatibility layer |
| 1.21.1 | Forge 52.1.16+ | 21 | 1.0.5 | New — Forge port, with the Curios compatibility layer |
All versions share this CurseForge project. Pick the file that matches your Minecraft version and loader — the API surface is the same across all of them.
🎮 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