Regalia Slots API

👑 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

1. Install as a dependency of another mod that requires it, on both client and server.
2. Open the accessory screen from the button in your inventory.
3. 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