curios_swich

中文介绍

饰品套装切换（Curio Set Switcher） —— 在 Curios 饰品栏上方一键无损切换三套完整饰品套装，闲置套装仅存于玩家 NBT，死亡时不会掉落。

一个轻量小工具，为 Curios 饰品界面添加 [1] [2] [3] 三个按钮，点击即可在三套饰品套装之间无缝切换。

✨ 主要功能

• 一键切换：打开背包，在左侧饰品栏的正上方会出现 [1] [2] [3] 三个按钮，点击即可切换到对应套装。
• 全槽位切换：切换范围覆盖身上所有 Curios 槽位（项链、戒指、腰带、手部、背部、头部等），一个不落。
• 无损切换：附魔、耐久、自定义 NBT 等全部保留，切换过程不丢失任何物品数据。
• 死亡不掉落：闲置套装只保存在玩家 NBT 数据中，不占用物理槽位，死亡时不会被 Curios 或原版计入掉落物；重生后随时切回。
• 通用饰品：可以把特定饰品设为"通用"——它在三个套装中都始终佩戴，切换时不会被换下（如需要一直生效的图腾、徽章等）。
• 全局配置：通用饰品列表保存在 config 目录，新建的世界同样生效。

📦 依赖

• Minecraft 1.20.1
• Forge 47.x
• Curios API 5.3.1+（Forge 版，任意 1.20.1 版本均可）

🛠 安装

1. 安装 Forge 47.x（1.20.1）和 Curios API。
2. 将本模组的 jar 放入 mods 文件夹。
3. 启动游戏，打开背包即可看到切换按钮。

🎮 使用说明

1. 打开背包（默认按 E），左侧饰品栏上方会出现 [1] [2] [3]。
2. 穿上第一套饰品 → 点击 [1]（记录为套装 1 并激活）。
3. 换上第二套饰品 → 点击 [2]；再换上第三套 → 点击 [3]。
4. 以后任意点击 [1] [2] [3] 即可在三套之间切换。切换前会自动把当前穿戴保存为当前套装的最终状态。

⌨ 指令

⚙ 配置文件

• config/curios_switch/universal_items.json —— 通用饰品列表（物品 ID），全局共享，可手动编辑。

❓ 常见问题

• 死亡后套装会丢吗？ 不会。闲置套装只存在玩家 NBT 里，不进掉落物；只有当前穿在身上的那套饰品会像普通物品一样正常掉落（遵循 Curios 的掉落规则）。
• 通用饰品是全局的吗？ 是的，列表存放在 config 目录，对所有世界生效。
• 为什么我的玩家有了一些额外的 Curios 槽位？ 如果整合包没有给玩家注册任何 Curios 槽位，本模组会自动注册标准槽位（项链、戒指、腰带、手部、背部等），以保证功能可用；正常整合包中这些槽位已存在，不会重复。

English Description

Curio Set Switcher — One-click, lossless switching between three full curio sets on the Curios screen. Idle sets live in the player's NBT and never drop on death.

A lightweight utility that adds [1] [2] [3] buttons to the Curios inventory screen, letting you switch between three complete curio loadouts in a single click.

✨ Features

• One-click switching: Open your inventory — three buttons [1] [2] [3] appear right above the curio panel on the left. Click to swap loadouts instantly.
• All slots covered: Every Curios slot on your character is switched together — necklace, rings, belt, hands, back, head and more.
• Lossless: Enchantments, durability and custom NBT are fully preserved — nothing is lost when switching.
• No-drop on death: Idle sets are stored only in the player's NBT data, never in physical slots, so they are not counted as drops by Curios or vanilla when you die.
• Universal items: Mark a specific item as "universal" and it stays equipped across all three sets — it will never be swapped out (great for totems, badges, or always-on trinkets).
• Global config: The universal item list lives in the config folder, so it applies to every newly created world too.

📦 Requirements

• Minecraft 1.20.1
• Forge 47.x
• Curios API 5.3.1+ (Forge, any 1.20.1 version)

🛠 Installation

1. Install Forge 47.x (1.20.1) and the Curios API.
2. Drop the mod jar into the mods folder.
3. Launch the game and open your inventory to see the switch buttons.

🎮 Usage

1. Open your inventory (default key: E) — the [1] [2] [3] buttons appear above the curio panel on the left.
2. Equip loadout #1 → click [1] (saved as set 1 and activated).
3. Equip loadout #2 → click [2]; equip loadout #3 → click [3].
4. Click [1] / [2] / [3] any time to switch between the three sets. Before switching, your current gear is saved as the final state of the active set.

⌨ Commands

⚙ Configuration

• config/curios_switch/universal_items.json — universal item list (item IDs), global and hand-editable.

❓ FAQ

• Will my sets be lost on death? No. Idle sets exist only in the player's NBT and are not dropped. Only the set you are currently wearing drops like normal curio gear (per Curios' drop rules).
• Is the universal list global? Yes — it lives in the config folder and applies to all worlds.
• Why do I have some extra Curios slots? If a modpack doesn't register any curio slots for players, this mod auto-registers the standard ones (necklace, rings, belt, hands, back, etc.) so the feature works. In normal modpacks these slots already exist, so nothing is duplicated.