HeadDisguisePlugin
一款适用于 PaperMC 1.21.6 的全面 Minecraft 插件,提供沉浸式的玩家头颅与伪装系统。
功能特性
? 核心功能
玩家头颅掉落:死亡时掉落自定义玩家头颅,保留玩家的皮肤和名称
双装备系统:通过物品栏槽位或手持右键 anywhere 来装备头颅
自动伪装:与 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 时的头颅掉落
控制拾取限制
自定义伪装行为
启用调试日志
工作原理
死亡事件:当玩家死亡时,会掉落一个带有其用户资料的自定义头颅
头颅创建:头颅在 NBT 数据中存储原始拥有者的 UUID 和名称
装备:玩家可以通过物品栏或右键来装备头颅
伪装应用:LibsDisguises API 应用皮肤和名称更改
消息处理:死亡消息反映伪装后的身份
开发
使用 Maven 和现代 Java 实践构建:
关注点分离
事件驱动架构
全面的错误处理
详细的日志记录以便调试
许可证
本插件按原样提供,仅供教育和开发目的使用。
HeadDisguisePlugin
A comprehensive Minecraft plugin for PaperMC 1.21.6 that creates an immersive player head and disguise system.
Features
? Core Functionality
Player Head Drops: Custom player heads drop on death, preserving the player's skin and name
Dual Equipping System: Equip heads via inventory slot or right-click anywhere
Automatic Disguises: Integration with LibsDisguises for seamless skin/name changes
Custom Death Messages: Death messages show disguised names instead of real ones
Self-Pickup Prevention: Players cannot pick up their own dropped heads
?️ Technical Features
Built for PaperMC 1.21.6 with Java 21
Robust event handling and error management
NBT data preservation for head metadata
Permission-based access control
Clean, modular architecture
Installation
Prerequisites:
PaperMC 1.21.6 server
Usage
For Players
Equipping Heads:
Drag a player head to your helmet slot in inventory
OR right-click with the head in hand for instant equipping
Disguising: Automatically applied when head is equipped
Combat: Use heads mid-fight for tactical disguises
For Admins
/headdisguise reload - Reload plugin and remove all disguises
/headdisguise remove [player] - Remove disguise from specified player
/headdisguise info - Display plugin information
Permissions
headdisguise.use - Allow using head disguises (default: true)
headdisguise.admin - Access to admin commands (default: op)
headdisguise.bypass.selfpickup - Can pick up own dropped heads (default: op)
Configuration
The plugin includes a config.yml for customizing behavior:
Toggle PvP-only head drops
Control pickup restrictions
Customize disguise behavior
Enable debug logging
How It Works
Death Event: When a player dies, a custom head with their profile is dropped
Head Creation: Heads store original owner UUID and name in NBT data
Equipping: Players can equip heads via inventory or right-click
Disguise Application: LibsDisguises API applies skin and name changes
Message Handling: Death messages reflect disguised identities
Development
Built with Maven and modern Java practices:
Clean separation of concerns
Event-driven architecture
Comprehensive error handling
Extensive logging for debugging
License
This plugin is provided as-is for educational and development purposes.
评论 0
登录后参与评分
还没有评论,来抢沙发吧