牢李插件系列
搜索

功能与获取介绍

3D 武器与时装皮肤、玩家人偶试衣间、经济、跨服、指令、权限和安装说明。

LiSkin 是一款基于 CraftEngine 的现代物品换肤插件，为服务器提供武器、工具、帽子、背包、羽翼等 3D 外观，并配有完整的皮肤商店、试穿、收藏、权限保护和跨服同步功能。

插件只修改物品的外观组件，不会替换原物品，也不会改变原物品的品质、属性、附魔、耐久和其他插件数据。

钻石剑应用皮肤后，移除皮肤依然是钻石剑，不会错误还原成铁剑。

✨ 功能特色

特性 说明
🎨 CraftEngine 3D 换肤 支持武器、工具、头饰、背包、羽翼和其他 3D 外观
🖥️ 综合 GUI 适配主手、全部皮肤、已拥有、收藏和管理功能集中在一个菜单
👁️ 临时试穿 右键皮肤即可试穿，结束或超时后自动恢复原外观
🧍 沉浸试衣 NPC 顶部按分类选装，临时进入旁观视角，用玩家自身皮肤的人偶旋转展示
💰 菜单直接购买 购买后菜单不会关闭，立即刷新为已拥有状态
💎 双经济支持 支持 Vault 金币和 PlayerPoints 点券，可按皮肤单独配置
🔒 精细权限 支持总权限、分类权限和每个皮肤的独立权限
🛡️ 权限保护 无权限或未解锁玩家拿到皮肤物品时，自动还原为原物品外观
🌐 跨服安全 MySQL 同步解锁与收藏，事务锁防止卡跨服重复购买或消耗
⭐ 收藏系统 玩家可以收藏常用皮肤，并在菜单中快速筛选
🎒 背部饰品 背包、羽翼、披风和喷气背包统一使用胸甲槽
⚡ Folia 调度 支持 Paper、Purpur、Folia、Luminol 等主流服务端分支
📦 单一资源目录 所有 CE 配置、模型和贴图统一放在 skins 文件夹

📦 配套资源

当前配套资源包含：

  • 101 个 LiSkin 皮肤
  • 101 个对应 CraftEngine 物品
  • 129 个模型文件
  • 166 张模型贴图
  • 动态武器、弓、弩、盾牌和钓竿状态模型
  • 武器、工具、法杖、帽子、头盔、背包、羽翼、披风与气球饰品

所有资源已经合并到一个 CraftEngine 资源目录：

plugins/
├─ LiSkin-1.9.7.jar
└─ CraftEngine/
   └─ resources/
      └─ skins/
         ├─ pack.yml
         ├─ configuration/
         │  └─ skins.yml
         ├─ resourcepack/
         └─ source-notices/

不需要分别安装多个资源包，复制一个 skins 文件夹即可。

🖥️ 综合皮肤菜单

玩家输入：

/liskin

即可打开完整皮肤面板。

菜单内可以直接完成：

  • 自动匹配当前主手物品
  • 查看全部皮肤
  • 查看已经拥有的皮肤
  • 查看收藏皮肤
  • 购买或免费解锁皮肤
  • 应用皮肤
  • 临时试穿
  • 解锁手中的 CE 皮肤物品
  • 移除当前皮肤
  • 结束试穿
  • 翻页与刷新匹配

操作方式：

左键：购买或应用
右键：临时试穿
Shift + 点击：收藏或取消收藏

没有权限的皮肤不会被隐藏，而是以锁定状态显示，方便玩家知道服务器提供了哪些外观。

👁️ 试穿模式

玩家可以在购买前临时试穿皮肤。

右键皮肤图标
/liskin preview <皮肤ID>
/liskin preview stop

试穿具有完整恢复保护：

  • 时间结束自动恢复
  • 主手物品发生变化自动恢复
  • 移动物品自动恢复
  • 玩家死亡或退出自动恢复
  • 插件关闭自动恢复
  • 不会解锁皮肤
  • 不会扣除金币或点券

试穿时间和是否允许试穿未解锁皮肤均可在配置中调整。

🧍 常驻人偶试衣间

管理员使用 /liskin fitting set a 设置展示点，使用 /liskin fitting set b 设置观看点。A 点会生成常驻原生玩家人偶 NPC；玩家蹲下并用主手右键后，可在顶部“全部”和 16 个分类之间切换，下方浏览对应皮肤，不必逐个输入 ID。

选择服装后，玩家默认临时进入旁观模式，在 B 点观看一个套用自身玩家皮肤、持续旋转的个人可见人偶。武器进入主手，装备进入对应槽位，背包和羽翼等展示模型同步跟随。试衣不购买、不解锁、不修改玩家物品，结束后会清理人偶、恢复原游戏模式并按配置返回原位置。

观看过程中再次蹲下并用主手右键任意位置，就能重新打开分类服装菜单并连续换装，不需要再次输入指令。

🔐 安全的物品还原

LiSkin 不会把原物品直接替换成皮肤来源物品。

插件只保存和修改必要的视觉组件：

  • CustomModelData
  • Item Model
  • Equippable 外观
  • LiSkin 自有 PDC 标记

不会修改：

  • 原物品 Material
  • 武器或装备品质
  • 属性与伤害
  • 附魔
  • 耐久度
  • 其他插件写入的 NBT/PDC

当玩家移除皮肤，或者无权限玩家拿到皮肤物品时，插件会恢复该物品应用皮肤前的真实外观。

💰 Vault 与 PlayerPoints

全服使用 PlayerPoints：

economy:
  default-provider: "PLAYERPOINTS"

  playerpoints:
    display-name: "点券"

单独指定某个皮肤使用点券：

skins:
  example_skin:
    currency: "PLAYERPOINTS"
    price: 500

支持的货币类型：

DEFAULT
VAULT
PLAYERPOINTS

购买成功后菜单不会关闭，皮肤会立即变成“已拥有”状态。

🌐 跨服防刷保护

群组服可以让所有子服连接同一个 MySQL 数据库：

storage:
  type: "MYSQL"
  server-id: "survival-1"
  cache-refresh-seconds: 3
  purchase-lock-seconds: 30

跨服模式支持：

  • 解锁数据同步
  • 收藏数据同步
  • 在线缓存自动刷新
  • 购买事务锁
  • 手持物品解锁事务锁
  • 重复扣款保护
  • 数据库提交失败自动退款
  • 物品消耗失败自动返还
  • 数据库不可用时阻止使用旧缓存绕过权限

每台子服必须配置不同的 server-id。

🎮 常用命令

命令 说明
/liskin 打开综合皮肤菜单
/liskin menu 打开综合皮肤菜单
/liskin unlock 解锁主手中的 CE 皮肤物品
/liskin apply <ID> 对主手物品应用皮肤
/liskin preview <ID> 临时试穿皮肤
/liskin preview stop 结束当前试穿
/liskin fitting、fitting menu 打开全部服装试衣菜单
/liskin fitting start <ID> 直接开始指定皮肤的人偶试衣
/liskin fitting stop 结束人偶试衣并返回
/liskin fitting set <a|b> 管理员设置展示点和观看点
/liskin remove 移除当前皮肤并恢复原外观
/liskin wardrobe 打开已拥有皮肤
/liskin shop 打开全部皮肤
/liskin list 查看已解锁皮肤
/liskin debug hand 查看主手物品外观信息
/liskin reload 重载配置
/liskin admin unlock <玩家> <ID> 管理员解锁皮肤
/liskin admin lock <玩家> <ID> 管理员移除皮肤

所有指令均带有参数补全。

🔑 主要权限

liskin.user
# 默认玩家权限组，包含菜单、解锁、应用、试穿、移除、商店和全部基础分类权限

liskin.use
# 允许使用 /liskin 主命令

liskin.menu
# 允许打开 LiSkin 综合皮肤菜单

liskin.unlock
# 允许使用手中的 CraftEngine 皮肤物品解锁对应皮肤

liskin.apply
# 允许把已经解锁的皮肤应用到兼容物品

liskin.preview
# 允许使用命令或菜单右键临时试穿皮肤

liskin.fitting
# 允许打开试衣菜单并观看旋转玩家人偶

liskin.admin.fitting
# 允许设置试衣间 A/B 点

liskin.remove
# 允许移除当前皮肤并恢复物品原始外观

liskin.shop
# 允许打开全部皮肤和商店视图

liskin.shop.buy
# 允许使用 Vault 金币或 PlayerPoints 点券购买皮肤

liskin.skin.use
# 允许持有并显示已经应用皮肤的物品；缺少时会自动还原外观

liskin.category.<分类>
# 允许使用指定分类的皮肤，例如 liskin.category.sword 或 liskin.category.helmet

liskin.admin.reload
# 允许使用 /liskin reload 重载插件配置

liskin.admin.unlock
# 允许管理员为指定玩家解锁皮肤

liskin.admin.lock
# 允许管理员移除指定玩家已经解锁的皮肤

liskin.admin.debug
# 允许使用 /liskin debug hand 查看主手物品的皮肤和组件信息

每个皮肤还可以在 skins.yml 中设置独立权限：

permission: "liskin.skin.example"

可配合 LuckPerms 管理玩家权限。

🔧 运行环境

项目 要求
LiSkin 1.9.7
服务端 Paper 26.1.2/26.2 或兼容分支
Java Java 25
CraftEngine 26.7.4
PlayerPoints 可选
Vault 可选
LuckPerms 可选
PlaceholderAPI 可选
MySQL 仅跨服模式需要

1.9.7 已在 Paper 26.1.2 build 74 与 CraftEngine 26.7.4 环境完成启动、旧配置与消息升级、停服清理验证；分类状态和配置资源通过自动化测试覆盖。旁观视角与菜单点击画面仍应由真人客户端在正式服上线前确认。

📥 安装方法

  1. 安装 CraftEngine。
  2. 将 LiSkin-1.9.7.jar 放入服务器 plugins。
  3. 将完整的 skins 文件夹放入：
plugins/CraftEngine/resources/skins
  1. 完整重启服务器。
  2. 玩家输入 /liskin 打开菜单。

如果以前安装过分开的旧资源目录，请先删除旧目录，避免 CraftEngine 重复注册同一物品。

📌 资源授权说明

插件本体与第三方模型素材的授权相互独立。

论坛公开发布时，请确认模型和贴图拥有公开分发授权。购买获得但禁止转售或分享的素材，只能用于已获得授权的服务器，不应单独上传或重新销售。

📎 下载与联系

  • 插件版本：LiSkin 1.9.7
  • 下载地址：请填写下载链接
  • 使用文档：请填写文档链接
  • 问题反馈：请填写反馈地址
  • 作者：请填写作者名称