CuriosPaper

插件

· 作者 Brothergaming52

为 Paper MC 制作 Curios API

0 本站下载 0 关注 更新于 3 个月前

最新 2.0.1 · 26.2 · Paper / Purpur

一键开服(送7天)
CuriosPaper Banner

✦ CuriosPaper ✦

Paper 与 Spigot 的终极自定义饰品栏系统

戒指 · 项链 · 披风 · 皇冠 · 腰带 · 护符 —— 以及更多。
完全服务端运行。无需安装模组。兼容基岩版玩家。强大的开发者 API。


把它当作 Baubles / Curios —— 但专为 Paper & Spigot 打造,支持 3D 模型、战利品表、GUI 编辑器、基岩版容器支持以及完整的插件 API。


? 什么是 CuriosPaper?

CuriosPaper 为你的 Minecraft 服务器添加了一套完整的饰品槽位系统。玩家可以通过整洁的分层 GUI 装备戒指、项链、披风、腰带、护符等物品——并全面支持 Java 版和基岩版玩家。

Main Accessory Menu

包含所有 9 种槽位类型的主饰品菜单


⚡ 功能特性

? 核心饰品系统

特性 描述
? 9 种槽位类型 头部、项链、背部、身体、腰带、手部、手镯、戒指、护符
✨ 能力系统 药水效果与玩家属性修改器,支持自定义操作
⚡ 快速装备 Shift + 右键即可将手中的饰品瞬间装备
? 快捷键系统 可配置的潜行键绑定以打开饰品 GUI——无需使用命令
? 鞘翅背部槽位 在背部饰品槽位中装备鞘翅(1.21.3+)
☠️ 死亡行为 死亡时保留、掉落或自动检测饰品——完全可配置
? 基岩版支持 原生支持 Geyser 和 Floodgate,并提供自定义铁砧与锻造台 GUI

? 3D 模型系统

当装备饰品时,直接将自定义 3D 模型附加到玩家身体上。模型通过同步的隐形盔甲架渲染——对所有附近的玩家可见。

  • ? 追踪玩家移动、旋转、潜行、游泳、飞行和旁观者模式
  • ?️ 智能可见性剔除——从穿戴者的第一人称视角或飞行/卸下过程中隐藏模型
  • ? 三叉戟与鞘翅兼容性——投掷、激流附魔和鞘翅飞行期间模型自动隐藏
  • ? 生物模型——生物可以视觉上穿着它们将会掉落的物品
  • ? 逐项切换——玩家可以右键点击来显示/隐藏他们的模型
  • ? GUI 卸下保护——打开物品栏时模型暂时卸下,以防止视觉重叠

?️ 游戏内 GUI 编辑器

可视化创建和配置所有内容——无需手动编辑 YAML:

编辑器 功能
物品编辑器 设置名称、材质、描述、模型数据、槽位类型
能力编辑器 配置药水效果与属性修改器及操作 (ADD_NUMBER, ADD_SCALAR, MULTIPLY_SCALAR_1)
配方编辑器 形状、无形状、熔炉、烧制、烟熏炉、铁砧与锻造台配方
战利品表编辑器 浏览服务器所有战利品表,使用预设项向地牢宝箱中添加物品
生物掉落编辑器 配置哪些生物掉落你的物品及其概率
交易编辑器 按职业和价格范围设置村民交易
3D 模型编辑器 配置身体挂载的 3D 模型及俯仰角限制

Slot Inventory

已装备饰品的槽位物品栏

? 物品获取途径

渠道 描述
合成配方 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. 安装与初始设置

  1. 下载 CuriosPaper.jar 并将其放入服务器的 plugins/ 目录。
  2. 启动服务器以生成默认配置文件(config.yml、messages.yml、items.yml 等)。
  3. 在 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+ 下界合金模板及旧版配方)。
  • 手动配置(代理/独立服务器):
    1. 从服务器的 plugins/CuriosPaper/geyser/ 目录获取文件。
    2. 将 CuriosPaper_Geyser.zip 复制到你的 Geyser packs/ 文件夹中。
    3. 将 CuriosPaper_mappings.json 复制到你的 Geyser custom_mappings/ 文件夹中。
    4. 确保 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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源