跳到正文

Regalia Slots API

作者:LlaGuiT0

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.

NeoForge
Minecraft 26.2 and 1.21.1
Library
LGPL-3.0-or-later


✨ 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.

Codex Stalking Dragons

🎯 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. 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).

🧱 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.57+ 21 1.1.4 Stable
1.21.1 21.1.259+ 21 1.0.2 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.


Codex Stalking Dragons


https://codex.skdragons.com/

Codex Stalking Dragons — Minecraft Modding

常见问题

Regalia Slots API 支持哪些 Minecraft 版本?

Regalia Slots API 支持 Minecraft Java 版 1.21.1–26.3,共 3 个版本,可用的加载器:NeoForge。下载时注意选择和你游戏版本一致的文件。

Regalia Slots API 怎么安装?

先用 PCL2 或 HMCL 启动器安装对应版本的 NeoForge,再把下载的 .jar 文件放进游戏目录的 mods 文件夹,重新启动游戏即可。开启了版本隔离的,mods 文件夹在 versions/版本名 下面。

评论

登录后评论和评分

LlaGuiT0 的其他作品

查看全部 →