{"id":79951,"date":"2026-06-04T17:34:34","date_gmt":"2026-06-04T14:34:34","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/"},"modified":"2026-06-04T17:34:34","modified_gmt":"2026-06-04T14:34:34","slug":"headplugin","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/","title":{"rendered":"HeadPlugin"},"content":{"rendered":"<p># \ud83d\udc80 Head Plugin<\/p>\n<p>![Minecraft Version](https:\/\/img.shields.io\/badge\/Minecraft-1.21.x-brightgreen?style=for-the-badge&#038;logo=minecraft)<br \/>\n![Platform](https:\/\/img.shields.io\/badge\/Platform-PaperMC-blueviolet?style=for-the-badge&#038;logo=papermc&#038;logoColor=white)<br \/>\n![Customizable](https:\/\/img.shields.io\/badge\/Config-Fully%20Customizable-orange?style=for-the-badge&#038;logo=gear&#038;logoColor=white)<br \/>\n![License](https:\/\/img.shields.io\/badge\/License-MIT-blue?style=for-the-badge)<\/p>\n<p>&#8212;<\/p>\n<p>### \u2728 Overview<br \/>\nA feature-rich plugin that adds a rewarding mechanic to **PvP** and **PvE**: dropping player heads on death! Fully customizable with lore support to memorialize epic battles.<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83d\udea7 Development &#038; Support<\/p>\n<p>**HeadPlugin is currently in active development!** Many more features, flexible layouts, and extended customization options are planned for future updates.<\/p>\n<p>If you need support, want to report an issue, or have a great idea for a new feature you&#8217;d like to see added, please join our **Discord Server**! We would love to hear your feedback and suggestions.<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83c\udf1f Features<\/p>\n<p>*   \ud83c\udfaf **Customizable Drop Rates**: Set the percentage chance (0% &#8211; 100%) for a head to drop.<br \/>\n*   \ud83d\udcdc **Rich Lore Support**: Heads can display:<br \/>\n    *   Name of the Victim<br \/>\n    *   Name of the Killer (if PvP)<br \/>\n    *   Cause of Death (if PvE)<br \/>\n    *   Date and Time of death<br \/>\n*   \ud83d\udccd **Flexible Drop Locations**:<br \/>\n    *   **Ground**: Drop item naturally at the death location.<br \/>\n    *   **Inventory**: Directly place the head in an inventory.<br \/>\n*   \ud83c\udf92 **Inventory Targeting**: Choose who gets the head &#8211; the **Victim**, the **Killer**, or **Both**.<br \/>\n*   \ud83d\uded1 **Anti-Abuse Limits**: Set a maximum lifetime limit of heads a player can drop to prevent farming.<br \/>\n*   \ud83c\udfd7\ufe0f **Placement Protection**: Optionally prevent players from placing heads to ensure the lore is preserved and not lost to block data.<br \/>\n*   \ud83d\udce2 **Broadcast System**: Announce head drops to the entire server.<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83d\udcdc Commands &#038; Permissions<\/p>\n<p>| Command | Description | Permission |<br \/>\n| :&#8212; | :&#8212; | :&#8212; |<br \/>\n| `\/headplugin reload` | \ud83d\udd04 Reloads the configuration | `headplugin.admin` |<br \/>\n| `\/headplugin status` | \ud83d\udce1 Displays plugin version | `(None)` |<br \/>\n| `(None)` | \ud83c\udf81 Ability to drop heads on death | `headplugin.drop` |<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83d\udcf7 Photo Examples<\/p>\n<p>![Example](https:\/\/cdn.modrinth.com\/data\/cached_images\/9f47513095dd3872355f34a2b5b00f196380d41e.png)<\/p>\n<p>![Player kills another player](https:\/\/cdn.modrinth.com\/data\/cached_images\/4d5cafe75bd936e68d996afbcc6e4ef4198a444e.png)<\/p>\n<p>> **Note:** If it&#8217;s another player that killed the victim, it will show &#8220;Killed by&#8230;&#8221; (see `config.yml` below). Conversely, if it&#8217;s an environmental death, the cause will be displayed as shown in the example.<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83c\udfa5 Video<\/p>\n<p><iframe loading=\"lazy\" width=\"560\" height=\"315\" src=\"https:\/\/www.youtube-nocookie.com\/embed\/vwoWLGGKyb4\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" allowfullscreen><\/iframe><\/p>\n<p>&#8212;<\/p>\n<p>## \u2699\ufe0f Configuration<\/p>\n<p>Customize drop rates, messages, and lore formats in `config.yml`.<\/p>\n<p>&#8220;`yaml<br \/>\n# HeadPlugin Configuration v1.0<br \/>\n#<br \/>\n# A plugin that drops player heads on death with customizable lore, names, and limits.<br \/>\n#<\/p>\n<p># The percentage chance that a head will drop (0.0 to 100.0)<br \/>\ndrop-chance: 100.0<\/p>\n<p># Where the head should appear:<br \/>\n# &#8211; GROUND: Drops items on the ground where the player died.<br \/>\n# &#8211; INVENTORY: Added directly to the player&#8217;s inventory (see inventory-target).<br \/>\nspawn-location: GROUND<\/p>\n<p># If spawn-location is INVENTORY, who should receive the head?<br \/>\n# Options: VICTIM, KILLER, BOTH<br \/>\n# Default: VICTIM (to match original behavior)<br \/>\ninventory-target: BOTH<\/p>\n<p># If true, heads will ONLY drop if the player was killed by another player (PvP).<br \/>\n# If false, heads can drop from any death cause (PvE, suicide, etc).<br \/>\nvictim-only: false<\/p>\n<p># Prevent players from placing the head on the ground?<br \/>\n# This prevents the lore (Killer, Date) from being lost.<br \/>\n# Default: true<br \/>\nprevent-head-placement: true<\/p>\n<p># Maximum number of heads a player can drop IN TOTAL (Lifetime limit).<br \/>\n# If a player has already dropped this many heads, they will not drop any more.<br \/>\nmax-heads: 1<\/p>\n<p># Message sent to player when they receive a head (leave empty to disable)<br \/>\n# %player% is replaced with the name of the head owner.<br \/>\nhead-received-message: &#8220;&#038;aYou have retrieved %player%&#8217;s head!&#8221;<br \/>\nhead-received-killer-message: &#8220;&#038;aYou executed %player% and took their head!&#8221;<\/p>\n<p># ==========================================<br \/>\n#              Head Customization<br \/>\n# ==========================================<\/p>\n<p># The display name of the head item.<br \/>\n# Placeholders: <player>\nhead-name: &#8220;&#038;d<player>&#8216;s Head&#8221;<\/p>\n<p># Lore (Item Description) Configuration<br \/>\nlore:<br \/>\n    # Date format used in the date line (Java SimpleDateFormat)<br \/>\n    # Common examples: &#8220;dd\/MM\/yyyy HH:mm&#8221;, &#8220;MM-dd-yyyy&#8221;<br \/>\n    date-format: &#8220;dd\/MM\/yyyy HH:mm&#8221;<\/p>\n<p>    # Line displayed when a player is killed by another entity\/player<br \/>\n    # Placeholders: <killer><br \/>\n    killer-line: &#8220;&#038;cKilled by <killer>&#8221;<\/p>\n<p>    # Line displayed when a player dies from the environment (fall, lava, etc.)<br \/>\n    # Placeholders: <cause><br \/>\n    environment-line: &#8220;&#038;cDied by <cause>&#8221;<\/p>\n<p>    # Line displayed for the date<br \/>\n    # Placeholders: <date><br \/>\n    date-line: &#8220;&#038;cDate: <date>&#8221;<\/p>\n<p># ==========================================<br \/>\n#                Broadcasts<br \/>\n# ==========================================<\/p>\n<p>broadcast:<br \/>\n    # Whether to announce head drops in chat to everyone.<br \/>\n    enabled: true<\/p>\n<p>    # Message to broadcast<br \/>\n    # Placeholders: <player>, <killer> (empty if no killer)<br \/>\n    # Note: If there is no killer, you might want a generic message or the plugin handles &#8220;Unknown&#8221; for <killer>.<br \/>\n    message: &#8220;&#038;6<player> dropped their head!&#8221;<br \/>\n&#8220;`<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83d\udce5 Installation<\/p>\n<p>1.  **Download** the `HeadPlugin.jar` file.<br \/>\n2.  **Upload** it to your server&#8217;s `plugins` folder.<br \/>\n3.  **Restart** your server to generate the default `config.yml`.<br \/>\n4.  **Customize** the `config.yml` to set drop rates and lore messages.<br \/>\n5.  Type `\/headplugin reload` or restart your server to apply changes.<\/p>\n<p>&#8212;<\/p>\n<p>## \ud83d\udc8e Credits<\/p>\n<p>*   \ud83d\udc68\u200d\ud83d\udcbb **Development**: Obsyron<\/p>\n","protected":false},"excerpt":{"rendered":"<p>The HeadPlugin is a small Minecraft plugin built for PaperMC servers. Its main job is to drop player heads when someone dies, along with a few extra features:<\/p>\n","protected":false},"featured_media":79952,"template":"","meta":{"_minecraft_slug":"headplugin","_minecraft_project_id":"EQQldFiD","_minecraft_author":"obsyrixx","_minecraft_license":"MIT","_minecraft_downloads":137,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"headplugin.zip","_minecraft_size_bytes":68256456,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T18:50:08.970695Z","_minecraft_date_created":"2026-01-31T20:47:04.648164Z","_minecraft_date_modified":"2026-02-09T22:46:56.739099Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/headplugin","_minecraft_icon_attachment_id":79952,"_minecraft_imported_at":"2026-06-04T14:34:35+00:00","_minecraft_import_hash":"8eb4e33b8bc42fb352920d60847fb66b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-79951","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>HeadPlugin - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"HeadPlugin - Minecraft\" \/>\n<meta property=\"og:description\" content=\"The HeadPlugin is a small Minecraft plugin built for PaperMC servers. Its main job is to drop player heads when someone dies, along with a few extra features:\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/headplugin\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/headplugin\\\/\",\"name\":\"HeadPlugin - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/headplugin\\\/#primaryimage\"},\"image\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/headplugin\\\/#primaryimage\"},\"thumbnailUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/headplugin-icon-8193e60f03a85ba7ecf0533ca15c11509ba0cb2e_96.webp\",\"datePublished\":\"2026-06-04T14:34:34+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/headplugin\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/headplugin\\\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/headplugin\\\/#primaryimage\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/headplugin-icon-8193e60f03a85ba7ecf0533ca15c11509ba0cb2e_96.webp\",\"contentUrl\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/wp-content\\\/uploads\\\/2026\\\/06\\\/headplugin-icon-8193e60f03a85ba7ecf0533ca15c11509ba0cb2e_96.webp\",\"width\":96,\"height\":96},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/headplugin\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"HeadPlugin\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"HeadPlugin - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/","og_locale":"en_US","og_type":"article","og_title":"HeadPlugin - Minecraft","og_description":"The HeadPlugin is a small Minecraft plugin built for PaperMC servers. Its main job is to drop player heads when someone dies, along with a few extra features:","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/","name":"HeadPlugin - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"primaryImageOfPage":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/#primaryimage"},"image":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/#primaryimage"},"thumbnailUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/headplugin-icon-8193e60f03a85ba7ecf0533ca15c11509ba0cb2e_96.webp","datePublished":"2026-06-04T14:34:34+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/#primaryimage","url":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/headplugin-icon-8193e60f03a85ba7ecf0533ca15c11509ba0cb2e_96.webp","contentUrl":"https:\/\/vpesports.com\/minecraft\/wp-content\/uploads\/2026\/06\/headplugin-icon-8193e60f03a85ba7ecf0533ca15c11509ba0cb2e_96.webp","width":96,"height":96},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/headplugin\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"HeadPlugin"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/79951","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media\/79952"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=79951"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=79951"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=79951"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=79951"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}