原创 娱乐 [1.21.4~26.x] ElytraChestplate 鞘翅盔甲 —— 盔甲 + 鞘翅合二为一，装备即滑翔！ 1.0.0

[MD] ## 一、插件信息 | 项目 | 内容 | | ----- | ------------------------------------------------------------ | | 适用服务端 | Paper | | 支持版本 | **1.21.4 \~ 26.2** | | 运行环境 | Java 21 及以上 | | 前置依赖 | 无（纯 Paper 原生 API，不需其他插件） | | 测试版本 | Paper 26.2 | *** ## 二、插件简介 厌倦了「穿鞘翅就不能穿胸甲」的取舍？本插件让你在**锻造台**把任意胸甲和鞘翅合成为「鞘翅胸甲」： - 装备后同时拥有**盔甲防御值**与**鞘翅滑翔能力**； - 外观在身上显示为胸甲模型，手持时显示专属鞘翅模型（需加载配套资源包）； - 支持**下界合金升级**，把普通鞘翅胸甲进一步升级为下界合金材质； - 所需资源包已随插件内置，首次启动会导出到 `plugins/ElytraChestplate/resourcepack.zip`，由服主自行托管后让玩家加载（详见下方说明）。 *** ## 三、功能特性 - ✅ **7 种材质**：对应不同盔甲外观（皮革 / 锁链 / 金 / 铁 / 钻石 / 下界合金 / turtle 等），每种可在配置中独立开关。 - ✅ **锻造台合成**：已注册 7 个 `SmithingTransformRecipe`，**鞘翅可正常放入锻造台 addition 槽**，无需指令也能合成。 - ✅ **下界合金升级**：可继续用下界合金锭在锻造台升级已合成的鞘翅胸甲。 - ✅ **内置资源包**：插件启动时把所需资源包导出到 `plugins/ElytraChestplate/resourcepack.zip`（并计算 SHA1，可用 `/ec resourcepack` 查看），服主托管该文件后玩家即可获得模型与装备渲染表现。 - ✅ **完整指令与权限**：`/elytrachestplate`（别名 `/ec`）提供 give / list / reload / resourcepack 等子命令，权限分级管理。 - ✅ **高度可配置**：每种材质的合成开关、物品显示名称、资源包 URL 均可在 `config.yml` 中修改。 *** ## 四、安装教程 1. 下载本帖附件中的 `elytrachestplate-1.0.0.jar`； 2. 将 jar 放入服务端的 `plugins/` 文件夹； 3. **重启服务器**（插件首次启动会自动生成配置并导出资源包）； 4. 用指令 `/ec give <玩家> <材质>` 发放，或在锻造台用「胸甲 + 鞘翅」合成； 5. **资源包托管（视觉表现必需）**：插件已把资源包导出到 `plugins/ElytraChestplate/resourcepack.zip`。请将其传到可公网/局域网访问的位置（对象存储、CDN、GitHub Releases 等），再把该直链填入 `config.yml` 的 `resource-pack.url`；玩家进服时会自动下载。也可让玩家手动加载该 zip。 6. **（推荐）用 CraftEngine 合并资源包**：若服务器已装 [CraftEngine](https://github.com/Xiao-MoMi/CraftEngine)，可不必单独托管本插件资源包，而是把它合并进 CraftEngine 统一生成的资源包里（详见下一节）。 > 提示：请确保服务端为 **Paper 1.21.4 及以上**，且使用 **Java 21+** 运行。 *** ## 五、资源包合并（配合 CraftEngine） 如果你服务器已经在用 **CraftEngine**（Xiao-MoMi），可以**不单独托管**本插件的资源包，而是把它**合并进 CraftEngine 统一生成的资源包**里。这样玩家只需加载一个资源包，就能同时获得 CraftEngine 的内容与本插件的鞘翅胸甲模型/渲染，也不会出现多个资源包互相覆盖的问题。 做法：在 CraftEngine 的 `config.yml` 里配置 `merge-external-zip-files`，把本插件导出的 `ElytraChestplate/resourcepack.zip` 加进合并列表即可。示例： ```yaml merge-external-zip-files: - "CustomNameplates/resourcepack.zip" - "BetterModel/build.zip" - "ElytraChestplate/resourcepack.zip" ``` > 说明：`ElytraChestplate/resourcepack.zip` 就是本插件启动后自动导出到 `plugins/ElytraChestplate/resourcepack.zip` 的文件（路径相对于 `plugins/` 目录）。只要它存在于插件文件夹内，CraftEngine 在生成资源包时会一并合并。采用此方式后，本插件 `config.yml` 里的 `resource-pack.url` 留空即可，无需再单独推送。 *** ## 六、指令一览 | 指令 | 说明 | 权限 | | ---------------------------------- | --------------------------------- | ------------------------ | | `/elytrachestplate give <玩家> <材质>` | 给玩家发放指定材质的鞘翅胸甲 | `elytrachestplate.give` | | `/elytrachestplate list` | 列出所有可用材质 | `elytrachestplate.admin` | | `/elytrachestplate reload` | 重载配置文件 | `elytrachestplate.admin` | | `/elytrachestplate resourcepack` | 显示资源包导出路径 / SHA1 / 配置 URL（供服主托管用） | 无（玩家可用） | | 别名 | `/ec` | — | 材质名称示例：`leather` / `chainmail` / `golden` / `iron` / `diamond` / `netherite` / `turtle`（以 `/ec list` 实际输出为准）。 *** ## 七、权限节点 | 权限 | 作用 | | ------------------------ | ---------------------- | | `elytrachestplate.give` | 允许使用 give 子命令发放物品 | | `elytrachestplate.admin` | 允许 list / reload 等管理指令 | | `elytrachestplate.craft` | 允许在锻造台合成（默认玩家拥有） | *** ## 八、配置文件（config.yml） ```yaml # 是否启用对应材质的合成与发放 materials: leather: true iron: true diamond: true netherite: true # 锻造台合成 crafting: # 是否允许"胸甲 + 鞘翅 -> 鞘翅胸甲"（锻造台） enabled: true # 是否允许"鞘翅胸甲 + 下界合金锭 -> 下界合金鞘翅胸甲"（锻造台） netherite-upgrade: true # 物品显示名（{type} 会被替换为材质中文名，例如：鞘翅铁胸甲） item-name: "鞘翅{type}胸甲" # 资源包（视觉表现必需：模型 / 装备渲染 / 鞘翅纹饰） resource-pack: # 资源包下载地址。留空则不自动推送，插件仍会把精简后的资源包 zip 导出到 # plugins/ElytraChestplate/resourcepack.zip 供你自行托管 # 示例：https://example.com/elytra/resourcepack.zip url: "" # 是否强制使用资源包（true 时未加载资源包的玩家会被拒绝进入） force: false # 玩家加入时自动推送资源包（仅当 url 已配置） auto-push: true ``` *** ## 九、致谢与声明 - 仅供学习与交流使用，转载请保留原作者与改编信息。 - 如有问题或建议，欢迎在帖子下留言。 [/MD]

十、截图​