HeadDrop 击杀掉头插件

HeadDrop 击杀掉头插件

> 让每一次击杀都有收获——玩家与生物死亡时按概率掉落头颅，支持自定义几率、战利品表、排行榜、Discord 通知，兼容 Paper/Folia/Spigot 多平台，GPL-3.0 开源。
基本信息

| 项目 | 信息 |
| --- | --- |
| 插件名称 | HeadDrop |
| 开发者 | RRS（RRS-9747，Patreon: rrscreation）|
| 最新版本 | 26.4（2026-08 前后，GitHub 标记为最新 Release）|
| 许可协议 | GPL-3.0-or-later |
| 兼容版本 | Minecraft Java 1.13.x – 26.2 |
| 运行平台 | Paper、Purpur、Spigot、Folia（4.19+）、Geyser Extension |
| 前置依赖 | 无硬依赖；可选 PlaceholderAPI（占位符）、WorldGuard（区域检查）|
| 项目地址 | https://modrinth.com/plugin/headdrop |
| 源码仓库 | https://github.com/RRS-9747/HeadDrop |
| 官方文档 | Wiki（Modrinth 页面「Visit wiki」入口）、Discord 支持 |
| SpigotMC 资源 | https://www.spigotmc.org/resources/99976/ |
简介

HeadDrop 是一款为 Minecraft Java 版服务器打造的「击杀掉头」插件。无论是 PvP 玩家击杀还是打怪farm，击杀行为都可能按配置概率掉落对应实体的头颅——玩家头保留皮肤纹理，生物头覆盖原版及各类变种（含 boss）。核心卖点是 Claim Your Trophies – Every Kill Counts（收集战利品，每一杀都算数），用可收集的「头颅 trophy」激励玩家对抗与farm，提升服务器的竞争性与趣味性。

插件完全免费（另有 Premium 付费版提供高级特性与优先支持），本体零硬依赖、高度优化，宣称在大服上零卡顿；原生兼容 Folia 分区异步调度，并针对 Geyser（基岩版）做了扩展适配。
核心特性
玩家与生物头颅掉落
玩家死亡、生物被击杀时按概率掉落对应头颅；支持自定义掉落几率，玩家头保留 UUID 皮肤纹理。
变种与 Boss 全覆盖
支持所有类型、所有变种的生物头颅，包括苦力怕、末影人、各类 boss；后续版本持续补齐新版本生物（如铜傀儡、快乐恶魂、1.21.11 新生物等）。
完全可自定义
可在配置中调整各类实体的掉落几率、重命名头颅、添加 lore、设置头衔前后缀与广播消息；支持黑白名单精确控制。
抢夺附魔加成
可通过 Looting（抢夺）等级提升头颅掉落率，并在配置中简化抢夺等级的计算方式（v5.4.0 优化）。
排行榜系统
内置排行榜，可追踪收集头颅最多的玩家；支持通过命令查询，并附带内置网站展示（需启用数据库）。
Discord 集成
头颅掉落（尤其是稀有掉落）时可实时推送通知到 Discord，便于运营与活动监控。
Folia 与异步优化
原生兼容 Folia（4.19+），所有逻辑按区域调度，多线程安全；配置值缓存、WorldGuard 检查优化，号称零延迟。
自定义音效（1.20+）
不同生物头颅掉落可播放独特音效，增强打击感。
环境要求

| 项目 | 要求 |
| --- | --- |
| 服务端 | Paper、Purpur、Spigot 及其分支；Folia 4.19+ 可原生运行 |
| Java 版本 | Java 17 或以上（跟随新版服务端）|
| 兼容 MC 版本 | 1.13.x – 26.2 |
| 可选依赖 | PlaceholderAPI（占位符 {WEAPON} 等）、WorldGuard（区域检查）、Geyser（基岩兼容扩展）|
| 数据库 | 排行榜/统计可选启用（支持自动清理，v5.4.1 起）|
安装方法
从 Modrinth 或 SpigotMC（资源 #99976）下载 HeadDrop-26.4.jar
将 jar 放入服务端 plugins/ 目录
重启服务器，插件首次加载会生成默认 config.yml
按需在配置中调整掉落几率、名单、数据库、Discord webhook 等
执行 /headdrop reload 热重载配置（部分变更仍需重启）

> 升级提醒：跨大版本升级（尤其 v2.0、配置结构变更时）建议备份旧 config.yml 后删除让其重新生成，再逐项迁移——官方曾在 2.0、2.4 等版本明确提示重置配置。新版许可为 GPL-3.0-or-later（旧仓库曾标 AGPL-3.0，以 Modrinth 为准）。
命令与权限

| 命令 | 说明 | 权限 | 默认 |
| --- | --- | --- | --- |
| /hd [help\|reload\|leaderboard\|debug\|gui] | 主命令，含重载、排行榜、调试、GUI | 见子项 | — |
| /hd reload | 重载配置文件 | headdrop.reload | OP |
| /hd leaderboard | 查看头颅收集排行榜 | headdrop.view.leaderboard | 所有玩家 |
| /hd gui | 打开 HeadDrop 界面 | headdrop.gui.view | 所有玩家 |
| /hd debug | 调试信息（开发者用）| headdrop.admin | OP |
| /head [玩家] | 获取（指定玩家的）头颅 | headdrop.head | 所有玩家 |

权限节点（基础）：
headdrop.head — 允许使用 /head 获取头颅
headdrop.reload — 允许 /headdrop reload 重载配置
headdrop.notify — 接收插件更新与提醒
headdrop.player — 启用玩家头颅掉落
headdrop.killer — 击杀生物时掉落头颅
headdrop.chance. — 按权限分组提升掉落几率
headdrop.gui.move — 允许在 GUI 中管理头颅

> 说明：排行榜需启用数据库；GUI 访问需 headdrop.gui.view；玩家头使用持久化的 UUID 纹理；部分配置变更的重载可能仍需完整重启。Tab 补全自 1.13+ 起可用。命令体系以官方 Wiki/plugin.yml 为准，不同大版本间个别节点曾有调整。

近期更新
26.4（2026-08 前后）：新版本号体系；修复若干生物音效问题，新增铜傀儡，修复鸡/猪/蛙/牛，添加 1.21.11 支持及相关新生物，更新全部依赖库
26.1 / 5.4.5（2026-01-12）：新增 1.21.11 支持，新版本号系统；5.4.5（2025-06-28）添加 1.21.6 支持、快乐恶魂头、插件优化
5.4.4（2025-05-29）：lore 改为永久保留，更新全部 API
5.4.3（2025-04-05）：修复 Require weapon 问题
5.4.2（2025-03-27）：1.21.5 支持，排行榜网站更新，新增牛/猪/鸡变种、愤怒狼头、颤抖炽足兽头，新增本地占位符 {WEAPON}，升级 bStats
5.4.1（2025-03-18）：修复数据库问题，新增自动数据库清理
5.4.0（2025-03-18）：迁移至 Modrinth；修复双重随机检查、权限检查优化、简化抢夺等级计算、线程安全改进、PlaceholderAPI 线程安全、配置值缓存、WorldGuard 检查优化、API 回归；从 Premium 下放 Required-Weapon、Effects
5.3.3（2024-12-08）：新增 Nerf-Spawner，更新 API
5.3.1（2024-11-24）：掉落几率优化，头颅恢复可堆叠（修复）
5.3.0：修复 1.21 API 问题，更新全部 API，支持 1.21.3，添加 Creaking 头，放弃更老版本支持
已知限制
玩家头颅纹理依赖 Mojang 皮肤服务（在线模式）；离线服使用内嵌的预打包纹理（约 87 个）
个别版本曾出现「调整掉落几率后无视设定必掉头」的 bug，需重置配置解决（v5.3.1 前后用户反馈）
排行榜、Web 统计依赖数据库，未启用时对应功能不可用
Premium 版独占部分高级定制与机制，免费版功能以发布页说明为准
作者与相关链接
RRS（RRS-9747）— Patreon: https://patreon.com/rrscreation
Modrinth：https://modrinth.com/plugin/headdrop
SpigotMC 资源页：https://www.spigotmc.org/resources/99976/
GitHub：https://github.com/RRS-9747/HeadDrop