LayerHeads

插件

· 作者 xoam24

LightWeight Player Head 插件 - 头部皮肤获取,2D 头部,交互式头部命令。

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

最新 1.0.0 · 26.2 · Paper / Purpur

一键开服(送7天)

? LayerHeads

LayerHeads 是一款为运行在 Java 21 至 25 且 Minecraft 版本为 1.21 至 26.x 的 Paper 和 Purpur 服务器打造的超优化、功能丰富的玩家头颅及头颅命令插件。它允许玩家获取 官方 Mojang (Original) 和 SkinsRestorer (Warez) 玩家的自定义皮肤,并附带持久化元数据;通过简洁的 GUI 管理个人头颅历史记录;同时赋予服务器管理员将任何已放置的玩家头颅转化为交互式、不可破坏的命令触发器的能力!

它是生存服、RPG 服、大厅服、Hub 服和冒险服的完美补充——非常适合用于交互式 NPC 头颅、可点击奖励基座、隐藏的近距彩蛋、任务触发器等场景!


✨ 主要特性

  • ⚡ 即时实时 SkinsRestorer 同步:
    • 与 SkinsRestorer 完全原生集成。
    • 当玩家执行 /skin <name> 或 /skin url 时,自动实时捕获皮肤更改。
    • 零延迟缓存失效确保下一个 /lh get 命令能立即提供更新后的自定义皮肤,无需等待 TTL 过期!
  • ?️ 智能账号来源分类 ({type}):
    • &aOriginal:直接从官方 Mojang 会话服务器获取的已验证官方 Mojang 账号。
    • &cWarez:离线/破解账号、在线服务器配置文件,或通过 SkinsRestorer 设置的自定义皮肤。
    • &eDefault:如果 Mojang 或 SkinsRestorer 上不存在皮肤,则自动回退到 Steve/Alex 默认皮肤。
    • 所有类型标签和颜色均可在 config.yml 中完全自定义!
  • ? MiniMessage 与传统颜色支持:
    • 全面支持 Kyori MiniMessage 格式化标签(<green>, <gray>, <gradient:#55ff55:#00aa00>, <rainbow>, <bold>, <italic> 等)以及经典的 Legacy & Hex 颜色(&a, &b, &7, &#55ff55, &x&r&r&g&g&b&b)。
  • ? 整洁的 6 位数字头颅 ID 与美观的 Lore 卡片:
    • 生成整洁的 6 位识别号码(例如 #{id} ➔ #849201)和紧凑的日期格式(26.08.2026 21:00),支持自定义边框和占位符。
  • ? 多皮肤历史 GUI (/lh history):
    • 为同一玩家名称保留不同的皮肤版本——如果玩家更改了皮肤,两个头颅都会作为单独的条目被保留!
    • 在历史菜单中点击任意头颅,即可获得该历史时刻的确切头颅和皮肤纹理。
  • ? 交互式头颅命令:
    • 可将多个顺序执行的控制台和玩家命令附加到任何已放置的玩家头颅方块上,并支持自定义执行顺序!
  • ⚡ 点击与近距触发器:
    • 通过点击或玩家进入可配置半径(具备智能进出检测,每次进入仅触发一次)来触发自定义头颅命令。
  • ?️ 不可破坏与悬浮头颅:
    • 已分配命令的头颅受到保护,免受玩家破坏、爆炸和物理更新的影响。
  • ? 高级条件与选择器引擎:
    • 全面支持原版命令方块语法、目标选择器(@p, @s, @a, @r)、计分板(score=points:5..)、标签(tag=vip)、等级、游戏模式以及 /execute if ...。
  • ? 2D 库存头颅:
    • 自动部署平面的 2D 头颅物品模型,适用于 ItemsAdder、Nexo 或 Oraxen 资源包管道。
  • ? 超低资源占用:
    • 专为拥有 100+ 并发玩家的高负载生产服务器设计。
    • 异步去抖存储 I/O、有界的自清理皮肤缓存以及 0ms 磁盘查找。
  • ? 内置 Modrinth 更新检查器:
    • 硬编码的异步更新检查器会在管理员登录时通知,并提供可点击下载链接。

? 工作原理

获取头颅:

  1. 输入 /lh get <player_name> 以获取任何 Minecraft 玩家的皮肤头颅(适用于 Mojang Original 和 SkinsRestorer Warez 账号!)。
  2. 该头颅将以带有美观自定义 lore 卡片、6 位 ID、时间戳和账号来源标签(&aOriginal、&cWarez 或 &eDefault)的形式添加到你的背包中。
  3. 随时打开 /lh history 查看并重新给予你个人历史中之前获取的头颅!

创建命令触发器:

  1. 在地面或墙壁旁放置任意玩家头颅。
  2. 注视该头颅(5 格范围内)并设置触发器:
    • /lh cmd trigger click(交互时触发)
    • /lh cmd trigger proximity 5(玩家进入 5 格范围内时触发)
  3. 添加顺序命令:
    • /lh cmd add 1 console tellraw %player% {"text":"Welcome to the secret area!","color":"aqua"}
    • /lh cmd add 2 player tag=vip me collected their VIP bonus!
    • /lh cmd add 3 console give %player% diamond 1
  4. 该头颅现在永久受保护、不可破坏,且如果周围方块被破坏,它将悬浮在空中!

? 命令与别名

命令别名: /lh, /layerheads, /head, /heads, /lhead, /lheads

玩家命令:

  • /lh get <player_name> — 获取带有自定义皮肤和元数据的玩家头颅。
  • /lh history — 打开你的个人头颅获取历史菜单。

管理员与命令方块命令:

  • /lh cmd add <id> <player|console> <command...> — 添加带有顺序 ID 的命令。
  • /lh cmd set <id> <player|console> <command...> — 修改/替换现有命令。
  • /lh cmd remove <id> — 从指定头颅中移除特定命令。
  • /lh cmd list — 列出指定头图上配置的所有命令和触发器设置。
  • /lh cmd trigger <click|proximity> [radius] — 设置触发动作和可选半径。
  • /lh cmd clear — 清除所有命令并从指定头图上移除保护。
  • /lh reload — 重载配置、存储以及 2D 资源包集成。

⚙️ 权限

layerheads.admin:
  description: 对 LayerHeads 所有功能的完全管理员访问权限。
  default: op

layerheads.use:
  description: 允许获取头颅并打开个人历史记录。
  default: true

layerheads.command.get:
  description: 允许使用 /lh get <player>。
  default: true

layerheads.command.history:
  description: 允许使用 /lh history 命令。
  default: true

layerheads.command.cmd:
  description: 允许管理头颅方块上的命令。
  default: op

layerheads.command.cmd.add:
  description: 允许向头颅方块添加命令。
  default: op

layerheads.command.cmd.set:
  description: 允许修改头颅方块上的命令。
  default: op

layerheads.command.cmd.remove:
  description: 允许移除头颅方块上的命令。
  default: op

layerheads.command.cmd.list:
  description: 允许查看头颅方块上的命令。
  default: op

layerheads.command.cmd.trigger:
  description: 允许设置头颅方块的触发模式。
  default: op

layerheads.command.cmd.clear:
  description: 允许清除头颅方块上的命令。
  default: op

layerheads.command.reload:
  description: 允许重新加载插件配置(/lh reload)。
  default: op

? 命令语法与条件

在配置头颅命令时,你可以用条件前缀包裹命令,或使用完整的原版选择器参数:

条件语法 描述 示例
tag=<name> 玩家必须拥有记分板标签 tag=vip say Hello VIP!
tag=!<name> 玩家不得拥有记分板标签 tag=!member kick %player%
score=<obj>:<range> 玩家的分数必须匹配整数范围 score=coins:10.. give %player% diamond 1
scores={<obj>=<val>} 多目标条件块 scores={level=5..,coins=100..} say High level!
level=<range> 玩家经验等级条件 level=10.. title %player% actionbar {"text":"Level 10!"}
gamemode=<mode> 玩家游戏模式条件 gamemode=survival heal %player%
permission=<node> 玩家权限节点条件 permission=group.hero say Welcome hero!
[cond1,cond2] 括号内的复合条件 [tag=vip,score=coins:50] give %player% emerald 1

可用的物品与命令占位符:

  • {id} 或 %id% — 纯净的 6 位数字识别 ID(例如 849201)
  • {type} 或 %type% — 账号/皮肤来源(&aOriginal, &cWarez, &eDefault)
  • {date} 或 %date% — 紧凑的创建日期和时间(例如 26.08.2026 21:00)
  • {time} 或 %time% — 仅时间(例如 21:00)
  • {short_date} 或 %short_date% — 短日期(例如 26.08.26)
  • {player} 或 %player% — 玩家用户名
  • {world} 或 %world% — 头颅方块所在的世界名称
  • {x}, {y}, {z} — 头颅方块的坐标
  • 如果服务器已安装 PlaceholderAPI,则支持完整的 PlaceholderAPI 功能!

? 兼容性与依赖项

  • Java 版本: Java 21, Java 25
  • 服务端软件: Paper, Purpur
  • Minecraft 版本: 1.21 至 26.x
  • SkinsRestorer(受支持)
  • LuckPerms & Vault(受支持)
  • PlaceholderAPI(可选)
  • ItemsAdder / Nexo / Oraxen(可选)

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源