🗑️ ItemDelete

ItemDelete is a lightweight, highly customizable server-side Spigot/Paper Minecraft plugin designed to help players clean up their inventories quickly. By hovering over an item and pressing a configured key combination (default: Ctrl + Q / CONTROL_DROP), players can permanently delete unwanted items, bypassing the tedious process of dropping items on the floor or manually dragging them out of the inventory screen.

Designed with safety in mind, it includes safety confirmation toggles, double-press windows, blocklists for valuable items, and world controls to ensure players never lose their gear accidentally.

---

✨ Features

• Instant Inventory Trash Bin: Delete items directly from your inventory screen without opening chest GUIs or dropping items on the ground.
• Accidental Deletion Prevention:
  • Toggle Mode: Players must run /itemdelete toggle to enable item deletion. When disabled, the key binds perform their 100% normal Minecraft functions (e.g. dropping stacks).
  • Double-Press Confirmation: Requires the player to press the delete key twice within a configurable time window (e.g., 1.5 seconds) to confirm deletion.
• Blacklisted Items: Prevent players from deleting important blocks/items like Bedrock, Barrier, Command Blocks, or custom administrative tools.
• World Management: Enable or disable the plugin in specific worlds using Whitelist or Blacklist modes.
• Audio Feedback: Play custom sounds when prompting for confirmation and upon successful deletion (e.g., item break or pling sound).
• Fully Customizable Messages: Supports Minecraft color codes (&) for all in-game notifications.

---

🛠️ Commands & Aliases

Command	Description	Permission
/itemdelete toggle	Toggles delete mode on or off.	itemdelete.use
/itemdelete reload	Reloads the configuration file.	itemdelete.admin

• Aliases: /id, /idelete

---

⚙️ Configuration (config.yml)

The default configuration file is clean, well-commented, and ready to be customized:

# ItemDelete Configuration

# The action required to delete the item when hovered in the inventory.
# By default, this is set to CONTROL_DROP (Ctrl + Q key on keyboard).
# This allows players to delete items with Ctrl+Q, while normal Q will still drop items.
#
# Note: If players change their "Drop Item" keybind to "X" in their Minecraft Client Settings,
# pressing Ctrl+X will delete the item!
delete-action: "CONTROL_DROP"

# Double click/tap check to prevent accidental deletion.
# Set 'enabled' to true to require pressing the key twice.
# Set 'enabled' to false to delete items immediately on the first press.
double-press:
  enabled: true
  time-window-ms: 1500 # Time window in milliseconds to confirm the deletion.

# Require the player to run /itemdelete toggle to enable deleting.
# When disabled (toggled off), Ctrl+Q/Ctrl+X functions 100% normally to drop full stacks.
# This prevents players from losing default keybind functions when not actively clearing items.
require-toggle: true

# Require a specific permission to delete items?
require-permission: false
permission: "itemdelete.use"

# Sound played when an item is deleted. Set to "NONE" to disable.
# Standard Minecraft sounds: ENTITY_ITEM_BREAK, BLOCK_LAVA_EXTINGUISH, ENTITY_ITEM_PICKUP, etc.
delete-sound: "ENTITY_ITEM_BREAK"
confirm-prompt-sound: "BLOCK_NOTE_BLOCK_PLING"

# Enable/disable plugin in specific worlds.
worlds:
  mode: "BLACKLIST" # BLACKLIST or WHITELIST
  list:
    - "example_disabled_world"

# Blacklist specific items from being deleted.
# Use standard Bukkit Material names.
blacklisted-items:
  - "BEDROCK"
  - "BARRIER"
  - "COMMAND_BLOCK"

# Messages configuration
messages:
  prefix: "&8[&cItemDelete&8] &7"
  deleted: "&aItem &e%item% &ahas been deleted."
  confirm-prompt: "&6Press again within %time%s to confirm deletion of &e%item%&6."
  blacklisted: "&cYou cannot delete this item!"
  no-permission: "&cYou do not have permission to delete items."
  reload: "&aConfiguration reloaded successfully."
  toggle-on: "&aDelete Mode ENABLED! Hovering and pressing Ctrl+Q will delete items."
  toggle-off: "&cDelete Mode DISABLED! Normal Minecraft key functions restored."

---

🚀 Installation

1. Download the ItemDelete.jar file.
2. Drop it into your server's plugins/ directory.
3. Restart or start your Minecraft server.
4. Customize plugins/ItemDelete/config.yml to your liking, then run /itemdelete reload to apply the changes!