✦ CuriosPaper ✦
Paper 与 Spigot 的终极自定义饰品栏系统
戒指 · 项链 · 披风 · 皇冠 · 腰带 · 护符 —— 以及更多。
完全服务端运行。无需安装模组。兼容基岩版玩家。强大的开发者 API。
把它当作 Baubles / Curios —— 但专为 Paper & Spigot 打造,支持 3D 模型、战利品表、GUI 编辑器、基岩版容器支持以及完整的插件 API。
? 什么是 CuriosPaper?
CuriosPaper 为你的 Minecraft 服务器添加了一套完整的饰品槽位系统。玩家可以通过整洁的分层 GUI 装备戒指、项链、披风、腰带、护符等物品——并全面支持 Java 版和基岩版玩家。

包含所有 9 种槽位类型的主饰品菜单
⚡ 功能特性
? 核心饰品系统
|
特性 |
描述 |
| ? |
9 种槽位类型 |
头部、项链、背部、身体、腰带、手部、手镯、戒指、护符 |
| ✨ |
能力系统 |
药水效果与玩家属性修改器,支持自定义操作 |
| ⚡ |
快速装备 |
Shift + 右键即可将手中的饰品瞬间装备 |
| ? |
快捷键系统 |
可配置的潜行键绑定以打开饰品 GUI——无需使用命令 |
| ? |
鞘翅背部槽位 |
在背部饰品槽位中装备鞘翅(1.21.3+) |
| ☠️ |
死亡行为 |
死亡时保留、掉落或自动检测饰品——完全可配置 |
| ? |
基岩版支持 |
原生支持 Geyser 和 Floodgate,并提供自定义铁砧与锻造台 GUI |
? 3D 模型系统
当装备饰品时,直接将自定义 3D 模型附加到玩家身体上。模型通过同步的隐形盔甲架渲染——对所有附近的玩家可见。
- ? 追踪玩家移动、旋转、潜行、游泳、飞行和旁观者模式
- ?️ 智能可见性剔除——从穿戴者的第一人称视角或飞行/卸下过程中隐藏模型
- ? 三叉戟与鞘翅兼容性——投掷、激流附魔和鞘翅飞行期间模型自动隐藏
- ? 生物模型——生物可以视觉上穿着它们将会掉落的物品
- ? 逐项切换——玩家可以右键点击来显示/隐藏他们的模型
- ? GUI 卸下保护——打开物品栏时模型暂时卸下,以防止视觉重叠
?️ 游戏内 GUI 编辑器
可视化创建和配置所有内容——无需手动编辑 YAML:
| 编辑器 |
功能 |
| 物品编辑器 |
设置名称、材质、描述、模型数据、槽位类型 |
| 能力编辑器 |
配置药水效果与属性修改器及操作 (ADD_NUMBER, ADD_SCALAR, MULTIPLY_SCALAR_1) |
| 配方编辑器 |
形状、无形状、熔炉、烧制、烟熏炉、铁砧与锻造台配方 |
| 战利品表编辑器 |
浏览服务器所有战利品表,使用预设项向地牢宝箱中添加物品 |
| 生物掉落编辑器 |
配置哪些生物掉落你的物品及其概率 |
| 交易编辑器 |
按职业和价格范围设置村民交易 |
| 3D 模型编辑器 |
配置身体挂载的 3D 模型及俯仰角限制 |

已装备饰品的槽位物品栏
? 物品获取途径
| 渠道 |
描述 |
| 合成配方 |
7 种配方类型——形状、无形状、熔炉、烧制、烟熏炉、铁砧、锻造台 |
| 战利品表 |
物品出现在地牢宝箱、矿井、神殿、要塞等位置 |
| 生物掉落 |
任何类型的生物都可以以可配置的概率和数量掉落饰品 |
| 村民交易 |
饰品根据职业和等级出现在村民交易池中 |
| 命令 |
/curios give <item> [player] [amount] 用于直接发放物品 |
? 开发者 API
为其他插件集成 CuriosPaper 提供的全面 API:
CuriosPaperAPI api = CuriosPaper.getInstance().getCuriosPaperAPI();
// 将任意物品标记为饰品
ItemStack ring = api.tagAccessoryItem(myItem, "ring");
// 检查玩家佩戴了什么
List<ItemStack> rings = api.getEquippedItems(player, "ring");
boolean hasRing = api.hasEquippedItems(player, "ring");
int count = api.countEquippedItems(player, "ring");
// 在运行时注册槽位、物品、配方、战利品表
api.registerSlot("earring", "Earring", "DIAMOND", 2);
api.registerItemLootTable("my_ring", new LootTableData("minecraft:chests/simple_dungeon", 0.25));
api.setItemModelConfig("my_cape", true, "LEATHER_HORSE_ARMOR", null, "myplugin:cape", 45f, 30f);
// 从插件的 JAR 文件中贡献资源包资产
api.registerResourcePackAssetsFromJar(myPlugin);
自定义事件:
| 事件 |
触发时机 |
AccessoryEquipEvent |
玩家装备、卸下或切换饰品时 |
CuriosLootGenerateEvent |
战利品容器中生成自定义物品(可取消) |
CuriosMobDropEvent |
生物掉落自定义物品(可取消) |
CuriosRecipeTransferEvent |
通过配方制作自定义物品(数据传递) |
CuriosCraftEvent |
通过合成/熔炼/锻造创建自定义物品(最终结果) |
CuriosModelEquipEvent |
即将在玩家身上显示的 3D 模型 |
CuriosMobModelEquipEvent |
即将在生物身上显示的 3D 模型 |
PlayerDeathCurioDropEvent |
玩家死亡时触发,用于过滤/取消饰品掉落 |
?️ 配置展示与设置说明
⚙️ 点击展开设置与配置文件
1. 安装与初始设置
- 下载
CuriosPaper.jar 并将其放入服务器的 plugins/ 目录。
- 启动服务器以生成默认配置文件(
config.yml、messages.yml、items.yml 等)。
- 在
config.yml 中选择所需的 资源包交付模式:
SELF:CuriosPaper 通过嵌入式 HTTP 服务器托管资源包(端口:8080)。
LINK:通过外部 URL 提供您的资源包(例如 Modrinth、Dropbox 或网站主机)。
NONE:完全禁用自动资源包提示。
2. Bedrock 版与 Geyser 集成设置
CuriosPaper 包含对通过 GeyserMC / Floodgate 连接的 Bedrock Edition 玩家的自动检测与支持。
- 自动设置(Geyser 在同一服务器上):
CuriosPaper 会自动检测 Geyser,将
CuriosPaper_Geyser.zip 和 CuriosPaper_mappings.json 提取到 plugins/CuriosPaper/geyser/ 中,并将它们复制到 Geyser 的 packs/ 和 custom_mappings/ 文件夹。
- Bedrock 自定义容器:
Bedrock 玩家无法原生使用 Java 版的铁砧/锻造台容器数据包而不出现故障。CuriosPaper 为 Bedrock 玩家提供了原生的 3 行箱子 GUI(
BedrockAnvilGUI 和 BedrockSmithingGUI),支持 1.20+ 模板锻造以及经验值修复/重命名。
3. 主插件配置 (/plugins/CuriosPaper/config.yml)
# CuriosPaper 自定义饰品槽位配置
version: "2.0.1"
# 更新检查器
updates:
check-for-updates: true
# 存储引擎设置
storage:
# 选定的引擎:YAML (flatfile)、SQLITE、MYSQL 或 MONGODB
engine: "YAML"
mysql:
host: "localhost"
port: 3306
database: "minecraft"
username: "root"
password: ""
table-prefix: "curios_"
mongodb:
connection-string: "mongodb://localhost:27017"
database: "minecraft"
collection: "curios_playerdata"
# 资源包设置
resource-pack:
# 模式:SELF(嵌入式 HTTP 主机)、LINK(外部 URL)或 NONE
mode: SELF
port: 8080
host-ip: "123.45.67.89"
url: ""
hash: ""
force-pack: false
prompt-message: "请接受资源包以查看自定义饰品!"
# 功能开关
features:
# 允许在后槽位装备鞘翅
allow-elytra-on-back-slot: true
# 铁砧和锻造台的自定义 Bedrock GUI
use-custom-smithing-gui: true
use-custom-anvil-gui: true
# 在 GUI 中显示空的饰品槽位
show-empty-slots: true
# 饰品保留规则:Always(总是)、Auto(跟随 keepInventory)、Never(从不)
keep-curio-inventory:
type: "Auto"
# 用于打开饰品菜单的潜行快捷键
hotkey:
enabled: true
slot: 8
sneak-type: "double" # single(单击)、double(双击)或 hold(按住)
4. 消息配置 (/plugins/CuriosPaper/messages.yml)
# 消息自定义,支持旧版 (&a) 和 HEX (<#FF5555>) 颜色代码
prefix: "&6[CuriosPaper] "
items:
quick-equip-lore: "&8▶ Shift + 右键点击以装备"
slot-lore: "&6槽位:&e{slots}"
ability-when-worn: "&7佩戴时效果:"
ability-potion-effect: "&9{effect} {level}"
# 属性修改器操作描述格式 (v2.0.1)
ability-attribute-positive: "&9+{value} {attribute}"
ability-attribute-negative: "&c-{value} {attribute}"
ability-attribute-scalar-positive: "&9+{value}% {attribute}"
ability-attribute-scalar-negative: "&c-{value}% {attribute}"
ability-attribute-multiply-positive: "&9x{value} {attribute}"
ability-attribute-multiply-negative: "&cx{value} {attribute}"
? 工作原理
1. /baubles → 打开饰品菜单
2. 点击槽位图标 → 打开该槽位的物品栏
3. 放置饰品 → 能力立即生效!
或使用快速装备: 手持已标记的物品 + Shift + 右键点击 即可瞬间装备。
或使用快捷键: 选择快捷栏槽位 + 双击潜行键 打开菜单。
? 统计数据
? 兼容性
|
要求 |
| Minecraft |
1.14.4 — 1.21+ |
| 服务端 |
Spigot, Paper, Purpur, Folia* |
| Java |
8+ |
| GeyserMC |
支持(包含自定义 Bedrock 资源包和映射文件) |
| 依赖项 |
无(独立运行) |
*Folia 支持处于实验阶段
? Geyser 与 Bedrock Edition 支持
CuriosPaper 为通过 GeyserMC 加入的 Bedrock Edition 玩家提供完整的 GUI 槽位图标和自定义容器支持。
- 自动配置: 如果 Geyser 运行在同一服务器上,CuriosPaper 将在启动时自动检测 Geyser 的文件夹,提取映射和资源包,并直接将其复制到 Geyser 的
packs/ 和 custom_mappings/ 文件夹中。
- 自定义基岩版 GUI(铁砧与锻造台): 基岩版玩家将获得专用的 3 行箱子界面,用于铁砧(修复、重命名、合并)和锻造台(支持 1.20+ 下界合金模板及旧版配方)。
- 手动配置(代理/独立服务器):
- 从服务器的
plugins/CuriosPaper/geyser/ 目录获取文件。
- 将
CuriosPaper_Geyser.zip 复制到你的 Geyser packs/ 文件夹中。
- 将
CuriosPaper_mappings.json 复制到你的 Geyser custom_mappings/ 文件夹中。
- 确保 Geyser 的
config.yml 中 enable-custom-content 设置为 true,然后重启 Geyser。
? 快速开始
# 1. 从 Modrinth 或 GitHub Releases 下载 CuriosPaper.jar
# 2. 将其放入服务器的 plugins/ 文件夹
# 3. 启动服务器
# 4. 完成!在游戏中使用 /baubles 命令
60 秒打造第一个饰品
/curios create speed_ring # 创建新物品
在 GUI 中:设置名称、材质、槽位类型 → 添加速度能力 → 添加配方 → 完成。
/curios give speed_ring # 获得该物品
/baubles # 打开饰品菜单
将其放入戒指槽位 — 速度 I 生效!?
? 文档
完整文档网站涵盖以下内容:
| 章节 |
主题 |
| 入门指南 |
安装、概念、首个饰品教程 |
| 配置 |
槽位、功能、能力、性能、数据库及基岩版 GUI |
| 系统 |
饰品、能力、配方、战利品表、生物掉落、交易、3D 模型、基岩版支持、热键、死亡行为 |
| GUI 编辑器 |
物品、能力、配方、战利品表、生物掉落、交易、3D 模型编辑器 |
| 开发者 API |
获取 API、饰品、战利品表、3D 模型、资源包、事件 |
| 示例 |
包含战利品表、能力和配方的完整插件示例 |
? v2.0.1 更新内容
- ? 基岩版铁砧与锻造台 GUI — 为基岩版玩家提供专用的 3 行箱子界面,以访问铁砧(结合、修复、带经验消耗的重命名)和锻造台(1.20+ 模板及旧版锻造)。
- ? 属性修改器操作 — 配置玩家修饰符能力,支持特定操作:
ADD_NUMBER(固定值)、ADD_SCALAR(百分比 %)和 MULTIPLY_SCALAR_1(乘数 x)。
- ✈️ 飞行与旁观者模式下的模型自动隐藏 — ArmorStand 3D 模型在玩家切换飞行状态 (
isFlying)、进入旁观者模式或摆出特殊姿势 (SWIMMING, FALL_FLYING, SPIN_ATTACK) 时会自动隐藏。
- ? 库存卸下安全机制 — 打开库存时 3D 模型会暂时卸下,并在关闭后 2 个刻钟自动重新装上,以消除视觉上的 GUI 重叠。
- ?️ 灵活的服务器版本解析 — 改进了
VersionUtil 中的版本解析正则表达式,以支持非标准的 Paper 开发构建版本(例如 26.2.build.48-alpha)。
- ? 命令与 GUI 改进 — 修复了
give 命令的消息目标定位问题,以及实现不区分大小写的颜色剥离 GUI 标题匹配。
完整更改日志 → CHANGELOGS.md
? 社区
discord.gg/r5YXqgrGya
获取帮助 · 报告错误 · 建议功能 · 保持更新
☕ 支持本项目
如果 CuriosPaper 对您有所帮助,请考虑留下打赏——这将有助于维持项目的持续运营!
ko-fi.com/brothergaming52
? 面向开发者
Maven
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
<dependency>
<groupId>com.github.Brothergaming52</groupId>
<artifactId>CuriosPaper</artifactId>
<version>2.0.1</version>
<scope>provided</scope>
</dependency>
plugin.yml
depend: [CuriosPaper]
完整 API 文档 → curiospaper.run.place/api
✦ CuriosPaper ✦
The Ultimate Custom Accessory Inventory System for Paper & Spigot
Rings · Necklaces · Capes · Crowns · Belts · Charms — and more.
Fully server-side. No mods required. Bedrock Edition compatible. Powerful developer API.
Think of it as Baubles / Curios — but for Paper & Spigot, with 3D models, loot tables, GUI editors, Bedrock container support, and a full plugin API.
? What is CuriosPaper?
CuriosPaper adds a complete accessory slot system to your Minecraft server. Players can equip rings, necklaces, capes, belts, charms, and more through a clean, tiered GUI — with full support for Java and Bedrock Edition players.

The main accessory menu with all 9 slot types
⚡ Features
? Core Accessory System
|
Feature |
Description |
| ? |
9 Slot Types |
Head, Necklace, Back, Body, Belt, Hands, Bracelet, Ring, Charm |
| ✨ |
Ability System |
Potion effects & player attribute modifiers with custom operations |
| ⚡ |
Quick Equip |
Shift + Right-Click to instantly equip accessories from your hand |
| ? |
Hotkey System |
Configurable sneak keybind to open the accessory GUI — no commands needed |
| ? |
Elytra Back Slot |
Equip elytra in the back accessory slot (1.21.3+) |
| ☠️ |
Death Behavior |
Keep, drop, or auto-detect accessories on death — fully configurable |
| ? |
Bedrock Support |
Native Geyser & Floodgate support with custom Anvil & Smithing GUIs |
? 3D Model System
Attach custom 3D models directly to the player's body when accessories are equipped. Models are rendered using synchronized invisible armor stands — visible to all nearby players.
- ? Tracks player movement, rotation, sneaking, swimming, flying, and spectator mode
- ?️ Smart visibility culling — hide models from wearer's first-person view or during flight/dismount
- ? Trident & Elytra compatibility — models auto-hide during throws, riptide, and elytra flight
- ? Mob models — mobs can visually wear items they'll drop
- ? Per-item toggle — players can right-click to show/hide their models
- ? GUI Dismount Protection — models temporarily dismount when opening inventories to prevent visual overlap
?️ In-Game GUI Editors
Create and configure everything visually — no manual YAML editing required:
| Editor |
What It Does |
| Item Editor |
Set name, material, lore, model data, slot type |
| Ability Editor |
Configure potion effects & attribute modifiers with operations (ADD_NUMBER, ADD_SCALAR, MULTIPLY_SCALAR_1) |
| Recipe Editor |
Shaped, shapeless, furnace, blast, smoker, anvil & smithing recipes |
| Loot Table Editor |
Browse all server loot tables, add items to dungeon chests with presets |
| Mob Drop Editor |
Configure which mobs drop your items and at what chance |
| Trade Editor |
Set up villager trades with professions and price ranges |
| 3D Model Editor |
Configure body-mounted 3D models with pitch limits |

Slot inventory with accessories equipped
? Item Distribution
| Channel |
Description |
| Crafting Recipes |
7 recipe types — shaped, shapeless, furnace, blast, smoker, anvil, smithing |
| Loot Tables |
Items appear in dungeon chests, mineshafts, temples, strongholds, and more |
| Mob Drops |
Any mob type can drop accessories with configurable chance & amount |
| Villager Trades |
Accessories appear in villager trade pools by profession and level |
| Commands |
/curios give <item> [player] [amount] for direct distribution |
? Developer API
A comprehensive API for other plugins to integrate with CuriosPaper:
CuriosPaperAPI api = CuriosPaper.getInstance().getCuriosPaperAPI();
// Tag any item as an accessory
ItemStack ring = api.tagAccessoryItem(myItem, "ring");
// Check what a player is wearing
List<ItemStack> rings = api.getEquippedItems(player, "ring");
boolean hasRing = api.hasEquippedItems(player, "ring");
int count = api.countEquippedItems(player, "ring");
// Register slots, items, recipes, loot tables at runtime
api.registerSlot("earring", "Earring", "DIAMOND", 2);
api.registerItemLootTable("my_ring", new LootTableData("minecraft:chests/simple_dungeon", 0.25));
api.setItemModelConfig("my_cape", true, "LEATHER_HORSE_ARMOR", null, "myplugin:cape", 45f, 30f);
// Contribute resource pack assets from your plugin's JAR
api.registerResourcePackAssetsFromJar(myPlugin);
Custom Events:
| Event |
When It Fires |
AccessoryEquipEvent |
Player equips, unequips, or swaps an accessory |
CuriosLootGenerateEvent |
Custom item generated in a loot container (cancellable) |
CuriosMobDropEvent |
Custom item dropped by a mob (cancellable) |
CuriosRecipeTransferEvent |
Custom item crafted via a recipe (data transfer) |
CuriosCraftEvent |
Custom item created via craft/smelt/smith (final) |
CuriosModelEquipEvent |
3D model about to be displayed on player |
CuriosMobModelEquipEvent |
3D model about to be displayed on mob |
PlayerDeathCurioDropEvent |
Fired on player death to filter/cancel curio drops |
?️ Configuration Showcase & Setup Instructions
⚙️ Click to Expand Setup & Configuration Files
1. Installation & Initial Setup
- Download
CuriosPaper.jar and place it into your server's plugins/ directory.
- Start the server to generate default configuration files (
config.yml, messages.yml, items.yml, etc.).
- Choose your desired Resource Pack Delivery Mode in
config.yml:
SELF: CuriosPaper hosts the resource pack on an embedded HTTP server (port: 8080).
LINK: Serve your resource pack via an external URL (e.g. Modrinth, Dropbox, or web host).
NONE: Disable automatic resource pack prompt completely.
2. Bedrock & Geyser Integration Setup
CuriosPaper includes automatic detection and support for Bedrock Edition players connecting via GeyserMC / Floodgate.
- Automatic Setup (Geyser on same server):
CuriosPaper automatically detects Geyser, extracts
CuriosPaper_Geyser.zip and CuriosPaper_mappings.json into plugins/CuriosPaper/geyser/, and copies them to Geyser's packs/ and custom_mappings/ folders.
- Bedrock Custom Containers:
Bedrock players cannot natively use Java Anvil/Smithing container packets without glitches. CuriosPaper provides native 3-row Chest GUIs (
BedrockAnvilGUI and BedrockSmithingGUI) for Bedrock players, supporting 1.20+ template smithing and XP repair/renaming.
3. Main Plugin Config (/plugins/CuriosPaper/config.yml)
# Configuration for CuriosPaper Custom Accessory Slots
version: "2.0.1"
# Update Checker
updates:
check-for-updates: true
# Storage Engine Settings
storage:
# Selected engine: YAML (flatfile), SQLITE, MYSQL, or MONGODB
engine: "YAML"
mysql:
host: "localhost"
port: 3306
database: "minecraft"
username: "root"
password: ""
table-prefix: "curios_"
mongodb:
connection-string: "mongodb://localhost:27017"
database: "minecraft"
collection: "curios_playerdata"
# Resource Pack Settings
resource-pack:
# Mode: SELF (embedded HTTP host), LINK (external URL), or NONE
mode: SELF
port: 8080
host-ip: "123.45.67.89"
url: ""
hash: ""
force-pack: false
prompt-message: "Please accept the resource pack to view custom accessories!"
# Feature Toggles
features:
# Allow elytra equipping in back slots
allow-elytra-on-back-slot: true
# Custom Bedrock GUIs for Anvils and Smithing Tables
use-custom-smithing-gui: true
use-custom-anvil-gui: true
# Display empty accessory slots in GUI
show-empty-slots: true
# Keep Curios on Death: Always, Auto (follows keepInventory), or Never
keep-curio-inventory:
type: "Auto"
# Sneak keybind hotkey to open accessory menu
hotkey:
enabled: true
slot: 8
sneak-type: "double" # single, double, or hold
4. Messages Configuration (/plugins/CuriosPaper/messages.yml)
# Message customization with legacy (&a) and HEX (<#FF5555>) color support
prefix: "&6[CuriosPaper] "
items:
quick-equip-lore: "&8▶ Shift + Right Click to equip"
slot-lore: "&6Slot: &e{slots}"
ability-when-worn: "&7When worn:"
ability-potion-effect: "&9{effect} {level}"
# Attribute Modifier Operation Lore Formatting (v2.0.1)
ability-attribute-positive: "&9+{value} {attribute}"
ability-attribute-negative: "&c-{value} {attribute}"
ability-attribute-scalar-positive: "&9+{value}% {attribute}"
ability-attribute-scalar-negative: "&c-{value}% {attribute}"
ability-attribute-multiply-positive: "&9x{value} {attribute}"
ability-attribute-multiply-negative: "&cx{value} {attribute}"
? How It Works
1. /baubles → Opens the accessory menu
2. Click a slot icon → Opens that slot's inventory
3. Place an accessory → Abilities activate instantly!
Or use Quick Equip: Hold a tagged item + Shift + Right-Click to equip instantly.
Or use the Hotkey: Select a hotbar slot + Double-Sneak to open the menu.
? Stats
? Compatibility
|
Requirements |
| Minecraft |
1.14.4 — 1.21+ |
| Server |
Spigot, Paper, Purpur, Folia* |
| Java |
8+ |
| GeyserMC |
Supported (custom Bedrock resource pack & mappings included) |
| Dependencies |
None (standalone) |
*Folia support is experimental
? Geyser & Bedrock Edition Support
CuriosPaper provides full GUI slot icon and custom container support for Bedrock Edition players joining via GeyserMC.
- Automatic Setup: If Geyser is running on the same server, CuriosPaper will automatically detect Geyser's folder on startup, extract the mappings and resource pack, and copy them directly to Geyser's
packs/ and custom_mappings/ folders.
- Custom Bedrock GUIs (Anvil & Smithing): Bedrock players get dedicated 3-row chest interfaces for Anvils (repair, rename, combine) and Smithing Tables (supports 1.20+ Netheriite templates and legacy recipes).
- Manual Setup (Proxy/Separate Server):
- Retrieve files from your server's
plugins/CuriosPaper/geyser/ directory.
- Copy
CuriosPaper_Geyser.zip into your Geyser packs/ folder.
- Copy
CuriosPaper_mappings.json into your Geyser custom_mappings/ folder.
- Ensure
enable-custom-content is set to true in Geyser's config.yml and restart Geyser.
? Quick Start
# 1. Download CuriosPaper.jar from Modrinth or GitHub Releases
# 2. Drop it into your server's plugins/ folder
# 3. Start the server
# 4. Done! Use /baubles in-game
First Accessory in 60 Seconds
/curios create speed_ring # Create a new item
In the GUI: set the name, material, slot type → add a Speed ability → add a recipe → done.
/curios give speed_ring # Get the item
/baubles # Open accessory menu
Place it in a ring slot — Speed I activates! ?
? Documentation
The full documentation site covers:
| Section |
Topics |
| Getting Started |
Installation, concepts, first accessory walkthrough |
| Configuration |
Slots, features, abilities, performance, databases & Bedrock GUIs |
| Systems |
Accessories, abilities, recipes, loot tables, mob drops, trades, 3D models, Bedrock support, hotkeys, death behavior |
| GUI Editors |
Item, ability, recipe, loot table, mob drop, trade, 3D model editors |
| Developer API |
Getting the API, accessories, loot tables, 3D models, resource packs, events |
| Examples |
Complete plugin examples with loot tables, abilities, and recipes |
? What's New in v2.0.1
- ? Bedrock Anvil & Smithing GUIs — Dedicated 3-row chest interfaces for Bedrock Edition players to access Anvil (combining, repairing, renaming with XP cost) and Smithing Tables (1.20+ templates & legacy smithing).
- ? Attribute Modifier Operations — Configure player modifier abilities with specific operations:
ADD_NUMBER (flat value), ADD_SCALAR (percentage %), and MULTIPLY_SCALAR_1 (multiplier x).
- ✈️ Flight & Spectator Model Auto-Hiding — ArmorStand 3D models automatically hide when players toggle flight (
isFlying), enter spectator mode, or enter special poses (SWIMMING, FALL_FLYING, SPIN_ATTACK).
- ? Inventory Dismount Safety — 3D models temporarily dismount when opening inventories and auto-remount 2 ticks after close to eliminate visual GUI overlaps.
- ?️ Flexible Server Version Parsing — Improved version parsing regex in
VersionUtil for non-standard Paper dev builds (e.g. 26.2.build.48-alpha).
- ? Command & GUI Improvements — Fixed
give command messaging targeting and case-insensitive color-stripped GUI title matching.
Full changelog → CHANGELOGS.md
? Community
discord.gg/r5YXqgrGya
Get help · Report bugs · Suggest features · Stay updated
☕ Support the Project
If CuriosPaper has been useful to you, consider leaving a tip — it helps keep the project alive!
ko-fi.com/brothergaming52
? For Developers
Maven
<repository>
<id>jitpack.io</id>
<url>https://jitpack.io</url>
</repository>
<dependency>
<groupId>com.github.Brothergaming52</groupId>
<artifactId>CuriosPaper</artifactId>
<version>2.0.1</version>
<scope>provided</scope>
</dependency>
plugin.yml
depend: [CuriosPaper]
Full API docs → curiospaper.run.place/api
评论 0
登录后参与评分
还没有评论,来抢沙发吧