💀 VoidHeads | Advanced Death Trophies

VoidHeads is a professional, high-performance death trophy and memorial system designed for modern Minecraft servers. It enhances the survival and PvP experience by automatically dropping or placing player heads upon death, preserving the legacy of fallen warriors with precise location data and unique visual identity.

🛠️ Key Features

• Smart Drop System – Seamlessly toggle between dropping heads as a collectible ITEM or automatically placing them as a BLOCK at the exact death site.
• Persistent Data Tracking – Heads store the victim's name and coordinates within Persistent Data Containers (PDC), ensuring they retain their unique data even after being broken and replaced.
• Universal Skin Support – Integrated profile-fetching system ensures trophies display high-fidelity player skins, compatible with both Premium and Cracked server environments.
• Integrated Death Locator – Lightweight JSON-based logging allows administrators to instantly trace any player's last known death location via the /vh locate command.
• Dynamic Placeholders – Fully customizable item names and lore with support for %player%, %world%, %x%, %y%, and %z% placeholders.

---

💻 Installation & Setup

1. Download the .jar file.
2. Drop the file into your server's /plugins folder.
3. Restart your server to generate the configuration files.
4. Customize your head appearance and system messages in config.yml.

---

📜〢 Configuration Example

############################################################
#                                                          #
#             VOIDHEADS - CREATED BY KUBA_121              #
#        Professional Death Head & Trophy System           #
#                                                          #
############################################################

############################################################
#                                                          #
#  PERMISSIONS:                                            #
#  - voidheads.locate: Access to /vh locate                #
#  - voidheads.admin: Access to /vh give and /vh reload    #
#                                                          #
############################################################

# Action to take on death: ITEM or BLOCK
drop-mode: "BLOCK"

# Drop chance (0.0 - 100.0)
drop-chance: 100.0

# Should the head overwrite existing blocks (e.g., grass, flowers)?
overwrite-blocks: false

# Toggle all death broadcasts
broadcast-enabled: true

# --- ITEM APPEARANCE ---
# Placeholders: %player%, %world%, %x%, %y%, %z%
head-name: "&b&lVoid &8» &f%player%'s Head"
head-lore:
  - "&8------------------------"
  - "&7Fallen in the void of battle."
  - "&7Location: &b%world% &8| &f%x%, %y%, %z%"
  - "&8------------------------"

messages:
  prefix: "&b&lVoidHeads &r&8»&7 "
  
  # Command Responses
  no-permission: "&cNo permission."
  reload-success: "&aConfiguration and Data reloaded!"
  give-success: "&7Head granted for &f%player%"
  locate-success: "&f%player% &7last died at: &b%world% %x%, %y%, %z%"
  error-numbers: "&cCoordinates must be numbers!"
  
  # Usage Messages
  usage-give: "&cUsage: &7/vh give <player> [x] [y] [z]"
  usage-locate: "&cUsage: &7/vh locate <player>"
  no-data: "&cNo death data found for player &f%player%"
  
  # Action Messages
  head-placed: "&f%player%'s &7head has been placed at &b%x%, %y%, %z%&7!"
  head-dropped: "&f%player%'s &7head dropped at &b%x%, %y%, %z%&7!"

  # Help menu structure
  help-menu:
    - "&8&m--------&r &b&lVoidHeads Help &8&m--------"
    - "&7/vh help &8- &fDisplays this menu"
    - "&7/vh reload &8- &fReloads the configuration"
    - "&7/vh give <player> [x y z] &8- &fGive a player head"
    - "&7/vh locate <player> &8- &fLocate the last death"
    - "&bTip: &7Heads remember their data even after placing!"
    - "&8&m--------------------------------"

---

🛡️ Support & Community

Join our Code Hub for technical support, bug reports, and updates.

• Discord: [Join Support Server]
• Source: [GitHub]