# Player Heads With Effects Plugin<\/p>\n
## Overview
\nPlayer Heads With Effects is a Minecraft plugin that drops player heads with unique potion effects when players are killed. The plugin provides an engaging gameplay experience where players can collect heads with special abilities.<\/p>\n
## Features
\n– Drops player heads with unique potion effects on death
\n– Effects are randomly assigned and don’t repeat until all are used
\n– PVP and PVE death support
\n– Customizable drop chances and messages
\n– Colorful broadcast messages
\n– Head wearing grants temporary potion effects
\n– **IMPROVED TIMER SYSTEM**:
\n – Each individual head has its own cooldown timer
\n – Once a head’s effect is used, that specific head goes on cooldown
\n – Trying to rewear the same head during cooldown:
\n – Shows “Wait for Xs” message in chat
\n – Head stays in inventory (doesn’t disappear)
\n – Head is not equipped (prevented from being worn)
\n – Different heads can be used immediately (no cross-head cooldown)
\n – If cooldown is set to 0, no timer restrictions apply (unlimited use)
\n– **PER-PLAYER HEAD LIMITS**:
\n – Configurable maximum heads per player for PVP and PVE
\n – Automatic reset periods for head counts
\n – Detailed player statistics tracking
\n– **ADVANCED EFFECT MANAGEMENT**:
\n – Enhanced error handling and logging
\n – Persistent effect tracking and statistics
\n – Better user experience with informative messages<\/p>\n
## Commands
\n– `\/headleft` – Shows which potion effects are still available (for all players)
\n– `\/headreset` – Resets the system so drops start again (OP only)
\n– `\/headreload` – Reloads all configuration files (OP only)
\n– `\/headget` – Get a head with a specific effect for testing (OP only)<\/p>\n
## Configuration
\nThe plugin generates configuration files on first run:<\/p>\n
### `heads.yml` – Controls head drop settings:
\n– **PVP Settings**:
\n – `enabled`: Enable\/disable PVP head drops
\n – `drop-chance`: Percentage chance for heads to drop (0-100)
\n – `per-player-head-limit`: Maximum heads per player (-1 for unlimited)
\n – `limit-reset-period`: Hours before limit resets (0 for no reset)
\n – Customizable drop messages and head lore<\/p>\n
– **PVE Settings**:
\n – `enabled`: Enable\/disable PVE head drops
\n – `drop-chance`: Percentage chance for heads to drop (0-100)
\n – `per-player-head-limit`: Maximum heads per player (-1 for unlimited)
\n – `limit-reset-period`: Hours before limit resets (0 for no reset)
\n – `allowed-causes`: List of death causes that drop heads
\n – Customizable drop messages<\/p>\n
### `effects.yml` – Defines potion effects and timer settings:
\n– `effect-duration`: How long effects last (default 15 seconds)
\n– `head-cooldown`: Delay before same head can be used again (default 25 seconds, set to 0 for no cooldown)
\n– List of available potion effects with levels<\/p>\n
## Author Information
\n– **Creator**: KakashiPlayz!
\n– **Portfolio Website**: https:\/\/kakashiplayz.vercel.app
\n– **Discord Server**: https:\/\/discord.gg\/QdTN4BFkTv<\/p>\n
## Plugin Version
\n1.0.0<\/p>\n
## Compatibility
\nWorks with Minecraft versions 1.13 and above.
\nCompatible with Spigot, Paper, and Bukkit servers.
\nWorks alongside other popular plugins.<\/p>\n
## Installation
\n1. Place the JAR file in your server’s `plugins` folder
\n2. Restart the server
\n3. The plugin will generate configuration files on first run
\n4. Customize settings in the generated config files as needed<\/p>\n
## Support
\nFor issues or questions, join our Discord server: https:\/\/discord.gg\/QdTN4BFkTv<\/p>\n
—<\/p>\n","protected":false},"excerpt":{"rendered":"
Player Heads With Effects is a Minecraft Plugin That Drops Player Heads With Unique Potion Effects When Players Are Killed!<\/p>\n","protected":false},"featured_media":122458,"template":"","meta":{"_minecraft_slug":"player-heads-with-effects","_minecraft_project_id":"ta817xgL","_minecraft_author":"KakashiPlayz","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":319,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"player-heads-with-effects.zip","_minecraft_size_bytes":32943,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T11:36:31.360591Z","_minecraft_date_created":"2025-09-20T11:09:02.614981Z","_minecraft_date_modified":"2025-09-20T06:00:41.179000Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/player-heads-with-effects","_minecraft_icon_attachment_id":122458,"_minecraft_imported_at":"2026-06-07T04:48:57+00:00","_minecraft_import_hash":"6aa91ccb6c9489bfdd994deefc8c3ca0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,156,89,127,129],"mod_loader":[130,132,134],"minecraft_version":[438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-122457","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-decoration","mod_category-game-mechanics","mod_category-paper","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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":"\n