# ItemCooldown<\/p>\n
**ItemCooldown** is a lightweight and highly configurable Minecraft plugin that allows server owners to apply cooldown restrictions to specific items during PvP combat.
\nIt prevents players from abusing powerful items such as **Totems, Elytra, Ender Pearls, Golden Apples, etc.** by temporarily blocking their usage when combat starts.<\/p>\n
The plugin is designed to be **fully configurable**, **lightweight**, and **safe**, with support for multiple item actions and automatic inventory handling.<\/p>\n
—<\/p>\n
# Key Features<\/p>\n
### \u2694\ufe0f Combat-Based Cooldowns<\/p>\n
Cooldowns begin **immediately when a player enters PvP combat**.
\nBoth the attacker and the victim receive cooldowns for all configured items.<\/p>\n
Combat detection includes:<\/p>\n
* Direct player hits
\n* Projectiles shot by players
\n* Creative attackers
\n* Area-effect damage from players<\/p>\n
Ignored damage sources:<\/p>\n
* Self damage
\n* Ender pearl damage
\n* Non-player attackers<\/p>\n
—<\/p>\n
### \ud83e\udde9 Configurable Item Actions<\/p>\n
Each item can restrict different types of interactions:<\/p>\n
| Action | Description |
\n|—————|—————————————————————|
\n| `pickup` | Prevents players from picking up the item |
\n| `equip` | Prevents players from equipping the item |
\n| `use` | Prevents players from using the item |
\n| `containers` | Prevents players from moving the item into or out of containers and bundles |<\/p>\n
Example config:<\/p>\n
“`json
\n{
\n “TOTEM_OF_UNDYING”: {
\n “cooldown”: 60,
\n “action”: [“pickup”, “use”]
\n },
\n “ELYTRA”: {
\n “cooldown”: 120,
\n “action”: [“equip”]
\n }
\n}
\n“`<\/p>\n
Cooldown values are in **seconds**.<\/p>\n
—<\/p>\n
### \ud83e\ude82 Smart Equipment Handling<\/p>\n
If a player **already has a restricted item equipped when combat begins**, the plugin will automatically:<\/p>\n
1. **Unequip the item**
\n2. **Move it to the player’s inventory**<\/p>\n
If the inventory is full:<\/p>\n
* the item is temporarily stored in a **virtual buffer**
\n* it will automatically return to the inventory when space becomes available<\/p>\n
This prevents bypassing cooldowns with already-equipped items such as **Elytra or armor pieces**.<\/p>\n
—<\/p>\n
### \u2699\ufe0f Fully Configurable<\/p>\n
The plugin uses **Bukkit material names** and JSON configuration.<\/p>\n
Structure:<\/p>\n
“`
\nplugins\/ItemCooldown\/<\/p>\n
config.json
\nconfig-examples.txt<\/p>\n
translations\/
\n messages.json
\n“`<\/p>\n
Features include:<\/p>\n
* Editable messages
\n* Configurable cooldowns
\n* Configurable actions per item
\n* Built-in documentation examples<\/p>\n
—<\/p>\n
### \ud83d\udd04 Hot Reload Support<\/p>\n
You can reload the configuration and translation files without restarting the server.<\/p>\n
“`
\n\/itemcooldown reload
\n“`<\/p>\n
If configuration files are missing, the plugin will **automatically recreate them**.<\/p>\n
—<\/p>\n
# Commands<\/p>\n
| Command | Description | —<\/p>\n # Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n # Why Use ItemCooldown?<\/p>\n Many PvP servers suffer from **item abuse during combat**, such as:<\/p>\n * Elytra escaping ItemCooldown provides a **clean and configurable solution** to balance PvP while keeping gameplay fair.<\/p>\n —<\/p>\n # Compatibility<\/p>\n * Minecraft **1.20+** —<\/p>\n # Example Use Cases<\/p>\n Common items servers restrict:<\/p>\n “` —<\/p>\n # Configuration Philosophy<\/p>\n ItemCooldown is designed to be:<\/p>\n * **Simple** You decide **which items**, **which actions**, and **how long** the cooldown lasts.<\/p>\n —<\/p>\n # Support<\/p>\n If you encounter issues or have feature requests, feel free to open an ticket in the Discord server!<\/p>\n Enjoy fair and balanced PvP!<\/p>\n","protected":false},"excerpt":{"rendered":" A simple and lightweight ItemCooldown plugin!<\/p>\n","protected":false},"featured_media":86942,"template":"","meta":{"_minecraft_slug":"itemcooldown","_minecraft_project_id":"qymMMgVV","_minecraft_author":"nieuwjaar","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":106,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"itemcooldown.zip","_minecraft_size_bytes":978110,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T19:40:43.735489Z","_minecraft_date_created":"2026-03-12T23:09:04.527720Z","_minecraft_date_modified":"2026-03-14T16:15:15.473252Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/itemcooldown","_minecraft_icon_attachment_id":86942,"_minecraft_imported_at":"2026-06-04T23:12:00+00:00","_minecraft_import_hash":"e8a45fa83973d293528d2fc6db31668a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,88,89,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-86941","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n| —————————————————- | —————————————– |
\n| `\/itemcooldown help` | Displays all plugin commands |
\n| `\/itemcooldown list [page]` | Lists configured cooldown items |
\n| `\/itemcooldown info
\n| `\/itemcooldown add
\n| `\/itemcooldown edit
\n| `\/itemcooldown remove
\n| `\/itemcooldown reload` | Reloads the plugin configuration |<\/p>\n
\n|——————————–|———————————————–|——–|
\n| `itemcooldown.help` | Allows `\/itemcooldown help` | true |
\n| `itemcooldown.info` | Allows `\/itemcooldown info` | op |
\n| `itemcooldown.list` | Allows `\/itemcooldown list` | op |
\n| `itemcooldown.reload` | Allows `\/itemcooldown reload` | op |
\n| `itemcooldown.add` | Allows adding new cooldown items | op |
\n| `itemcooldown.edit` | Allows editing cooldown items | op |
\n| `itemcooldown.remove` | Allows removing cooldown items | op |
\n| `itemcooldown.update.notify` | Allows receiving in-game update notifications | op |<\/p>\n
\n* Totem stacking
\n* Infinite ender pearl usage
\n* Golden apple spam<\/p>\n
\n* Spigot \/ Paper
\n* Lightweight with minimal performance impact<\/p>\n
\nTOTEM_OF_UNDYING
\nENDER_PEARL
\nELYTRA
\nGOLDEN_APPLE
\nENCHANTED_GOLDEN_APPLE
\nSHIELD
\nTRIDENT
\n“`<\/p>\n
\n* **Flexible**
\n* **Server-friendly**<\/p>\n