Item Delete HotKeys

ItemDelete

ItemDelete is a server-side Spigot/Paper plugin that allows players to permanently delete items from their inventory using a configurable click action or key combination (default: Ctrl + Q).

It is designed for inventory cleanup, with several safety features to prevent accidental item deletion.

Features

• Inventory Deletion: Delete hovered items directly from the inventory using the configured hotkey.
• Safety Toggle: Players must run /itemdelete toggle to enable/disable deletion. While disabled, the hotkey retains its default Minecraft behavior (e.g., dropping item stacks).
• Double-Press Confirmation: Requires the player to trigger the deletion action twice within a configurable timeframe (default: 1.5s) to confirm.
• Item Blacklist: Block specific item types (e.g., bedrock, barrier) from being deleted.
• World Filters: Restrict deletion functionality to specific worlds using a whitelist or blacklist.
• Audio Feedback: Optional sound effects for confirmation prompts and successful deletion.
• Customizable Messages: All messages and colors can be customized in the configuration file.

Commands & Permissions

• Aliases: /id, /idelete

Configuration (config.yml)

# The action required to delete the item when hovered in the inventory.
# By default, this is CONTROL_DROP (Ctrl + Q).
delete-action: "CONTROL_DROP"

# Double click/tap check to prevent accidental deletion.
double-press:
  enabled: true
  time-window-ms: 1500

# Require players to run /itemdelete toggle to enable deleting.
require-toggle: true

# Permission settings
require-permission: false
permission: "itemdelete.use"

# Sound settings. Set to "NONE" to disable.
delete-sound: "ENTITY_ITEM_BREAK"
confirm-prompt-sound: "BLOCK_NOTE_BLOCK_PLING"

# World restriction settings
worlds:
  mode: "BLACKLIST" # BLACKLIST or WHITELIST
  list:
    - "example_disabled_world"

# Block specific items from being deleted
blacklisted-items:
  - "BEDROCK"
  - "BARRIER"
  - "COMMAND_BLOCK"

# Message customization (supports color codes)
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. Place ItemDelete.jar in your server's plugins/ folder.
2. Restart the server.
3. Configure settings in plugins/ItemDelete/config.yml and run /itemdelete reload to apply.