✦ 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复制到你的 Geyserpacks/文件夹中。 - 将
CuriosPaper_mappings.json复制到你的 Geysercustom_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
由 Brothergaming52 ❤️ 制作
Documentation · Discord · Ko-fi · Changelog · bStats · GitHub
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧