# HeadDisguisePlugin
一个为 PaperMC 1.21.6 创建沉浸式玩家头部和伪装系统的综合性 Minecraft 插件。
# 特性
🎭 核心功能
玩家头部掉落：玩家死亡时会掉落自定义的头部，保留玩家的皮肤和姓名
双重装备系统：通过物品栏插槽或右键单击任何位置装备头部
自动伪装：与 LibsDisguises 集成，实现无缝的皮肤/姓名更改
自定义死亡消息：死亡消息显示伪装姓名而不是真实姓名
防止自捡取：玩家不能捡起自己的掉落头部
🛠️ 技术特性
专为 PaperMC 1.21.6 和 Java 21 构建
强大的事件处理和错误管理
头部元数据 NBT 数据保留
基于权限的访问控制
干净、模块化的架构
安装
先决条件：
PaperMC 1.21.6 服务器
用法
对于玩家
装备头部：
将玩家头部拖动到物品栏中的头盔插槽
或者用手持头部右键单击以立即装备
伪装：当装备头部时自动应用
战斗：在战斗中使用头部进行战术伪装
对于管理员
/headdisguise reload - 重新加载插件并删除所有伪装
/headdisguise remove [player] - 删除指定玩家的伪装
/headdisguise info - 显示插件信息
权限
headdisguise.use - 允许使用头部伪装（默认：true）
headdisguise.admin - 访问管理员命令（默认：op）
headdisguise.bypass.selfpickup - 可以捡起自己的掉落头部（默认：op）
配置
该插件包含一个 config.yml 文件，用于自定义行为：
切换仅 PvP 头部掉落
控制捡取限制
自定义伪装行为
启用调试日志记录
工作原理
死亡事件：当玩家死亡时，会掉落一个带有其个人资料的自定义头部
头部创建：头部将其原始所有者 UUID 和姓名存储在 NBT 数据中
装备：玩家可以通过物品栏或右键单击装备头部
伪装应用：LibsDisguises API 应用皮肤和姓名更改
消息处理：死亡消息反映伪装身份
开发
使用 Maven 和现代 Java 实践构建：
清晰的职责分离
事件驱动架构
全面的错误处理
广泛的日志记录用于调试
# 许可
此插件按原样提供，用于教育和开发目的。