Compatibility
Minecraft: Java Edition
1.21.x
Platforms
Tags
Creators
Details
Licensed MIT
Published 3 days ago
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 toggleto 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
| Command | Description | Permission |
|---|---|---|
/itemdelete toggle |
Enable or disable item deletion mode | itemdelete.use |
/itemdelete reload |
Reload the configuration | itemdelete.admin |
- 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
- Place
ItemDelete.jarin your server'splugins/folder. - Restart the server.
- Configure settings in
plugins/ItemDelete/config.ymland run/itemdelete reloadto apply.


