原创 工具 娱乐 YiyunCEskin - 专为CraftEngine设计的皮肤插件 | 支持Folia | 1.21.4+ v1.2.2

[MD] # YiyunCEskin **CraftEngine 物品皮肤插件 — 让每一件装备都独一无二** YiyunCEskin 是一款为 Minecraft 服务器设计的物品换肤插件。依托 CraftEngine 的物品模型系统，玩家可以为武器和盔甲自由更换外观——支持 3D 模型和传统盔甲层渲染，不替换原版物品，即换即显。  *** ## 为什么选择 YiyunCEskin | 特性 | 说明 | | ---------------- | ---------------------------------- | | 🎨 **真正的 3D 换肤** | CraftEngine 驱动完整 3D 模型渲染，不是简单的材质替换 | | 🔒 **安全可靠** | 从不修改原物品数据，移除皮肤后装备完全恢复 | | 📦 **物理皮肤卷轴** | 拖拽卷轴即可应用皮肤，支持一次性消耗或永久使用 | | 🖥️ **直观 GUI** | 按材质自动匹配可用皮肤，收藏管理与快速检索 | | 🌐 **全平台兼容** | 同时支持 Paper、Purpur、Folia、Luminol等 | | 🔐 **精细权限** | 基于 LuckPerms，每个皮肤可独立配置权限；无权限显示 🔒 锁定状态 | | 🪞 **盔甲模仿** | 将皮革盔甲伪装成钻石/下界合金外观，保持原防御属性不变 | | 🎯 **动作触发** | 应用/移除/攻击/交互时触发音效、粒子、命令等自定义动作 | *** ## 快速开始 1. 安装 **CraftEngine**（必须）、**LuckPerms**（权限管理）、**PlaceholderAPI**（可选） 2. 将 `YiyunCEskin-1.0.0-SNAPSHOT.jar` 放入 `plugins/` 文件夹 3. 重启服务器 4. 输入 `/yskin` 打开 GUI，选择一个皮肤点击应用 5. （可选）在 `plugins/YiyunCEskin/skins/` 目录下添加自定义皮肤配置 *** ## 功能一览 ### 🎨 外观定制 支持所有可修改的物品属性：CustomModelData、皮革染色、盔甲纹饰、附魔闪光、物品标签、提示框样式、自定义 NBT 标签。CE 皮肤自动从源物品提取 item_model + equippable（支持 3D 和非 3D 装备穿戴渲染）——配置最少化。 ### 📦 皮肤卷轴 管理员通过 `/yskin give` 生成皮肤卷轴，玩家拖拽到目标装备上即可应用。卷轴可配置为： - 一次性消耗（使用后消失） - 可重复使用（解包时返还） 配合解包器可随时移除已应用的皮肤。 ### 🖥️ GUI 面板 - 按手持物品材质自动匹配可用皮肤 - 🔍 一键切换「已拥有」/「全部」视图；无权限皮肤显示 🔒 锁定，不隐藏 - 📂 收藏皮肤管理，支持多个默认皮肤——登录自动应用（剑一个、镐一个，各材质互不冲突） - 📁 皮肤按配置文件分组排序，整洁有序 - 🪡 纹饰可选保留或清除，GUI 一键切换，全局可配置默认行为 - 👁️ 左键应用 / 右键预览，交互直观 ### 🪞 盔甲模仿 将任意盔甲伪装成其他材质的外观——皮革变钻石、锁链变下界合金。**保持原盔甲的防御/韧性/击退属性不变**，只有外观改变。支持自定义伪装耐久度上限。拖拽模仿物品进入铁砧/砂轮/附魔/锻造台会被拦截保护。 ### 🎯 动作系统 皮肤支持在特定事件触发自定义动作： | 触发时机 | 可用动作 | | ------------- | ------------------------------------------------------- | | 应用/移除皮肤 | 消息、音效、粒子、命令 | | 攻击实体 | MESSAGE、SOUND、PARTICLE、PLAYER\_COMMAND、CONSOLE\_COMMAND | | 交互（左右键/空气/方块） | 同上 | *** ## 命令 | 命令 | 权限 | 说明 | |------|------|------| | `/yskin` | 默认 | 打开皮肤 GUI | | `/yskin apply <ID>` | 默认 | 对手持物品应用皮肤 | | `/yskin remove` | 默认 | 移除手持物品的皮肤 | | `/yskin menu` | 默认 | 同 `/yskin`，打开 GUI | | `/yskin list [页码]` | 默认 | 列出所有可用皮肤 | | `/yskin info` | 默认 | 查看手持物品当前皮肤信息 | | `/yskin give <ID> [玩家] [--keep]` | 管理员 | 给予皮肤卷轴 | | `/yskin drop <ID> <x> <y> <z> [世界]` | 管理员 | 在指定坐标丢出卷轴 | | `/yskin unwrapper` | 管理员 | 给予解包器 | | `/yskin open <玩家>` | 管理员 | 为其他玩家打开 GUI | | `/yskin create [ID]` | 管理员 | 从手中物品生成皮肤 YAML 配置 | | `/yskin reload` | 管理员 | 重载配置和皮肤 | | `/yskin debug [on\|off\|verbose]` | 管理员 | 切换调试日志 | *** ## 依赖 | 插件 | 要求 | 说明 | | ---------------------------- | -- | ------------------------ | | **CraftEngine（推荐 26.6+ 版本）** | 必须 | 提供物品模型和装备渲染能力 | | **LuckPerms** | 必须 | 皮肤级权限管理（无 LuckPerms 时带权限的皮肤永久锁定） | | PlaceholderAPI | 可选 | 皮肤名称和描述中解析占位符 | *** ## 技术亮点 **面向高版本设计** —— 专为 Minecraft 1.21.4+ 打造，充分利用现代 Paper API 和 Data Components 体系。使用 **JDK 21** 开发，享受虚拟线程和最新 Java 特性带来的性能优势。 **高性能设计**： - 皮肤数据通过物品 PDC（PersistentDataContainer）轻量存储，随物品序列化，零额外 IO - O(1) 材质索引反向查询——百万级皮肤配置下仍可毫秒级匹配 - 修改器链基于 `editMeta()` 原子操作，避免反复克隆元数据对象 - GUI 中物品不进入容器，仅跟踪背包槽位号——省去物品克隆和序列化开销 - 事件驱动 + 移动阈值去重，杜绝无效刷新 **Folia 原生兼容** —— 使用 `FoliaScheduler` 统一调度层，所有 entity 操作严格在区域线程执行。同一套代码在 Paper 和 Folia 上均以零延迟运行，无需任何配置切换。 ## 兼容性 **Minecraft 1.21.4+** / **JDK 21** 兼容 Paper 及其所有主流分支（Purpur、Leaf、Folia、Luminol 等），一套 JAR 全平台通用。 *** ## 配置 配置文件位于 `plugins/YiyunCEskin/`： - `config.yml` — 主配置文件（GUI、权限、预览、快捷键等） - `skins/*.yml` — 皮肤配置文件 - `collections/*.yml` — 材质集合文件（将多个材质归为一组） - `gui/main.yml` — 主 GUI 布局（装饰、按钮位置、皮肤区大小） - `gui/favorites.yml` — 收藏 GUI 布局 详细配置指南请参阅 [USER_GUIDE.md](https://docs.qq.com/aio/DVExkTGFiamxwZnd6) *** ## 统计 YiyunCEskin 使用 bStats 匿名收集使用数据。你可以在 `plugins/bStats/config.yml` 中随时关闭。查看统计：[bstats.org/plugin/bukkit/YiyunCEskin/32106](https://bstats.org/plugin/bukkit/YiyunCEskin/32106) *** ## 联系 & 社区 | | | |------|------| | **作者** | CHL_chun | | **QQ** | 2919089965 | | **QQ交流群** | 1093090518 | > 💡 下载插件需要金粒。金粒不足？进群免费下载，无需金粒。 [/MD]