? 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, 7ff55, &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 更新检查器:
- 硬编码的异步更新检查器会在管理员登录时通知,并提供可点击下载链接。
? 工作原理
获取头颅:
- 输入
/lh get <player_name> 以获取任何 Minecraft 玩家的皮肤头颅(适用于 Mojang Original 和 SkinsRestorer Warez 账号!)。
- 该头颅将以带有美观自定义 lore 卡片、6 位 ID、时间戳和账号来源标签(
&aOriginal、&cWarez 或 &eDefault)的形式添加到你的背包中。
- 随时打开
/lh history 查看并重新给予你个人历史中之前获取的头颅!
创建命令触发器:
- 在地面或墙壁旁放置任意玩家头颅。
- 注视该头颅(5 格范围内)并设置触发器:
/lh cmd trigger click(交互时触发)
/lh cmd trigger proximity 5(玩家进入 5 格范围内时触发)
- 添加顺序命令:
/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
- 该头颅现在永久受保护、不可破坏,且如果周围方块被破坏,它将悬浮在空中!
? 命令与别名
命令别名: /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(可选)
? LayerHeads
LayerHeads is an ultra-optimized, feature-packed player head and head command plugin for Paper and Purpur servers running on Java 21 to 25 and Minecraft versions 1.21 through 26.x. It allows players to fetch custom skins for both Official Mojang (Original) and SkinsRestorer (Warez) players with persistent metadata, manage their personal head histories through a clean GUI, and gives server administrators the power to turn any placed player head into an interactive, indestructible command trigger!
It is the perfect addition to survival, RPG, lobby, hub, and adventure servers—ideal for interactive NPC heads, clickable reward pedestals, hidden proximity easter eggs, quest triggers, and more!
✨ Key Features
- ⚡ Instant Real-Time SkinsRestorer Synchronization:
- Full native integration with SkinsRestorer
- Automatically captures skin changes in real-time when players execute
/skin <name> or /skin url.
- Zero-delay cache invalidation ensures that the very next
/lh get command immediately provides the updated custom skin without waiting for TTL expiration!
- ?️ Intelligent Account Origin Classification (
{type}):
&aOriginal: Verified official Mojang accounts fetched directly from official Mojang session servers.
&cWarez: Offline/cracked accounts, live online server profiles, or custom skins set via SkinsRestorer.
&eDefault: Automatic Steve/Alex fallback if no skin exists on Mojang or SkinsRestorer.
- All type labels and colors are fully customizable in
config.yml!
- ? MiniMessage & Legacy Color Support:
- Full support for Kyori MiniMessage formatting tags (
<green>, <gray>, <gradient:#55ff55:#00aa00>, <rainbow>, <bold>, <italic>, etc.) alongside classic Legacy & Hex colors (&a, &b, &7, 7ff55, &x&r&r&g&g&b&b).
- ? Clean 6-Digit Head IDs & Aesthetic Lore Cards:
- Generates clean 6-digit identification numbers (e.g.
#{id} ➔ #849201) and compact date formats (26.08.2026 21:00) with customizable borders and placeholders.
- ? Multi-Skin History GUI (
/lh history):
- Keeps distinct skin versions for the same player name—if a player changes their skin, both heads are preserved as separate entries!
- Clicking any head in the history menu gives you the exact historical head and skin texture.
- ? Interactive Head Commands:
- Attach multiple sequential console and player commands to any placed player head block with customizable execution order!
- ⚡ Click & Proximity Triggers:
- Trigger head commands by clicking or when players enter a configurable radius (with smart entry/exit detection that triggers once per entry).
- ?️ Indestructible & Floating Heads:
- Heads with assigned commands are protected against player breaking, explosions, and physics updates.
- ? Advanced Condition & Selector Engine:
- Full support for vanilla command block syntax, target selectors (
@p, @s, @a, @r), scoreboards (score=points:5..), tags (tag=vip), levels, gamemodes, and /execute if ....
- ? 2D Inventory Heads:
- Automatically deploys flat 2D head item models for ItemsAdder, Nexo, or Oraxen resource pack pipelines.
- **? Ultra-Low Resource Footprint **:
- Engineered for high-load production servers with 100+ concurrent players.
- Asynchronous debounced storage I/O, bounded self-cleaning skin cache, and 0ms disk lookups.
- ? Built-in Modrinth Update Checker:
- Hardcoded async update checker notifies server administrators upon login with clickable download links.
? How It Works
Fetching Heads:
- Type
/lh get <player_name> to fetch any Minecraft player's skin head (works for both Mojang Original and SkinsRestorer Warez accounts!).
- The head is added to your inventory with an aesthetic custom lore card, 6-digit ID, timestamp, and account origin tag (
&aOriginal, &cWarez, or &eDefault).
- Open
/lh history at any time to view and re-give previously fetched heads from your personal history!
Creating Command Triggers:
- Place any player head on the ground or against a wall.
- Look at the head (within 5 blocks) and set a trigger:
/lh cmd trigger click (triggers on interaction)
/lh cmd trigger proximity 5 (triggers when players enter within 5 blocks)
- Add sequential commands:
/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
- The head is now permanently protected, indestructible, and floats in mid-air if the surrounding blocks are broken!
? Commands & Aliases
Command Aliases: /lh, /layerheads, /head, /heads, /lhead, /lheads
Player Commands:
/lh get <player_name> — Fetches the player head with custom skin and metadata.
/lh history — Opens your personal head fetch history menu.
Admin & Command Block Commands:
/lh cmd add <id> <player|console> <command...> — Adds a command with a sequential ID.
/lh cmd set <id> <player|console> <command...> — Modifies/replaces an existing command.
/lh cmd remove <id> — Removes a specific command from the targeted head.
/lh cmd list — Lists all commands and trigger settings configured on the targeted head.
/lh cmd trigger <click|proximity> [radius] — Sets the trigger action and optional radius.
/lh cmd clear — Clears all commands and removes protection from the targeted head.
/lh reload — Reloads configuration, storage, and 2D resource pack integrations.
⚙️ Permissions
layerheads.admin:
description: Full administrator access to all LayerHeads features.
default: op
layerheads.use:
description: Allows fetching heads and opening personal history.
default: true
layerheads.command.get:
description: Allows using /lh get <player>.
default: true
layerheads.command.history:
description: Allows using /lh history.
default: true
layerheads.command.cmd:
description: Allows managing commands on head blocks.
default: op
layerheads.command.cmd.add:
description: Allows adding commands to head blocks.
default: op
layerheads.command.cmd.set:
description: Allows modifying commands on head blocks.
default: op
layerheads.command.cmd.remove:
description: Allows removing commands from head blocks.
default: op
layerheads.command.cmd.list:
description: Allows viewing commands on head blocks.
default: op
layerheads.command.cmd.trigger:
description: Allows setting trigger mode on head blocks.
default: op
layerheads.command.cmd.clear:
description: Allows clearing commands from head blocks.
default: op
layerheads.command.reload:
description: Allows reloading plugin configuration (/lh reload).
default: op
? Command Syntax & Conditions
When configuring head commands, you can prefix commands with conditions or use full vanilla selector arguments:
| Condition Syntax |
Description |
Example |
tag=<name> |
Player must have the scoreboard tag |
tag=vip say Hello VIP! |
tag=!<name> |
Player must NOT have the scoreboard tag |
tag=!member kick %player% |
score=<obj>:<range> |
Player's score must match integer range |
score=coins:10.. give %player% diamond 1 |
scores={<obj>=<val>} |
Multi-objective condition block |
scores={level=5..,coins=100..} say High level! |
level=<range> |
Player EXP level condition |
level=10.. title %player% actionbar {"text":"Level 10!"} |
gamemode=<mode> |
Player gamemode condition |
gamemode=survival heal %player% |
permission=<node> |
Player permission node condition |
permission=group.hero say Welcome hero! |
[cond1,cond2] |
Bracketed compound conditions |
[tag=vip,score=coins:50] give %player% emerald 1 |
Available Item & Command Placeholders:
{id} or %id% — Clean 6-digit numeric identification ID (e.g. 849201)
{type} or %type% — Account / skin origin (&aOriginal, &cWarez, &eDefault)
{date} or %date% — Compact creation date & time (e.g. 26.08.2026 21:00)
{time} or %time% — Time only (e.g. 21:00)
{short_date} or %short_date% — Short date (e.g. 26.08.26)
{player} or %player% — Player username
{world} or %world% — World name of the head block
{x}, {y}, {z} — Coordinates of the head block
- Full PlaceholderAPI support if installed on your server!
? Compatibility & Dependencies
- Java Versions: Java 21, Java 25
- Server Software: Paper, Purpur
- Minecraft Versions: 1.21 to 26.x
- SkinsRestorer (Supported)
- LuckPerms & Vault (Supported)
- PlaceholderAPI (Optional)
- ItemsAdder / Nexo / Oraxen (Optional)
评论 0
登录后参与评分
还没有评论,来抢沙发吧